iOS

Подключение

Подключение библиотеки осуществляется через Swift Package Manager. В Xcode выберите в меню File -> Swift Packages -> Add Package Dependency и введите в поле адреса репозитория https://github.com/maps-mailru/maps-sdk-ios.

Выберите Maps SDK и добавьте его к цели вашего приложения.

Использование

Импортируйте MapsSDK в файл, где вы будете использовать карту.

Для начала работы с картой необходимо указать:

API key для работы с SDK;
координаты центра карты;
начальный уровень zoom;
стиль тайлов.

import MapsSDK
 
...
 
override func viewDidLoad() {
    let mapConfig = MapViewConfig(
        apiKey: "##YOUR_API_KEY##",
        center: Coordinates(lng: 33, lat: 55),
        zoomLevel: 11,
        style: .automatic
    )
    let mapView = MapView()
    mapView.delegate = self
    mapView.setup(mapConfig)
    view.addSubview(mapView)
     
    mapView.setCurrentLocation(Coordinates(lng: 33, lat: 55), bearing: 0, accuracy: 0)
}

Управление картой

Установка текущей координаты и направления пользователя

mapView.setCurrentLocation(Coordinates(lng: 33, lat: 55), bearing: 0, accuracy: 0)

Установка направления карты

mapView.setBearing(90, animated: true)

Установка координат центра карты

mapView.setCenter(Coordinates(lng: 33, lat: 55), animated: true)

Установка уровня зума

mapView.setZoom(11, animated: true)

Включение/выключение элементов управления

mapView.isZoomButtonsHidden = true
mapView.isCompassHidden = true
mapView.isMyLocationButtonHidden = true

Включение/выключение жестов

mapView.isDragPanEnabled = true
mapView.isZoomRotateEnabled = true

Маркеры

При создании маркера нужно указать его идентификатор, координату и картинку.

Для картинки рекомендуется использовать изображение размером 48х48 пикселей. Картинка отображается на карте так, чтобы середина нижней грани картинки оказалось в заданной координате. Можно использовать набор из предоставляемых картинок или использовать свою собственную.

Добавление отдельных маркеров

let pinImage = UIImage(...)
let marker1 = Marker(id: "marker_id_1", coords: Coordinates(lng: 33, lat: 55), pin: .electricPin)
mapView.addMarker(marker1)
let marker2 = Marker(id: "marker_id_2", coords: Coordinates(lng: 33, lat: 55), pin: .custom(pinImage))
mapView.addMarker(marker2)

Добавление маркеров массивом

mapView.addMarkers([marker1, marker2])

Удаление отдельного маркера с указанием его идентификатора

mapView.removeMarker(id: "marker_id_1")

Удаление всех маркеров

mapView.removeAllMarkers()

Попапы

Для показа попапа на карте, нужно указать идентификатор маркера, для которого он будет отображен, и текст внутри попапа.

mapView.displayPopup(markerId: "marker_id_1", content: "Hello world")

Для скрытия попапа, нужно указать идентификатор маркера.

mapView.hidePopup(markerId: "marker_id_1")

Показ попапа после выбора маркера на карте

Для этого необходимо реализовать метод mapView(_:, onMarkerSelectID:) делегата MapViewDelegate.

extension MyController: MapViewDelegate {
    func mapView(_ mapView: MapView, onMarkerSelectID: String) {
        mapView.displayPopup(markerId: id, content: "Hello world")
    }
}

Стили

Карта поддерживает смену стилей. Стиль .automatic означает, что карта будет автоматически менять светлый и темный стили в зависимости от настройки системной темы интерфейса.

mapView.changeStyle(.automatic)
mapView.changeStyle(.dark)

GeoJSON

Карта поддерживает отрисовку полигонов и линий из GeoJSON источника.

Добавляйте источники и слои только после загрузки карты, которую можно отследить в методе делегата mapViewDidLoad(_:)

func mapViewDidLoad(_ mapView: MapView) {
    let sourceData = Data(...)
     
    let source = MapDataSource(id: "sourceID", type: .geoJSON(sourceData))
    mapView.addSource(source)
     
    let fillLayer = MapLayer(
        id: "fillLayer",
        sourceID: "sourceID",
        paint: FillPaintProperties(fillColor: .iuColor(.green), fillOpacity: 0.3)
    )
 
    let strokeLayer = MapLayer(
        id: "strokeLayer",
        sourceID: "sourceID",
        paint: LinePaintProperties()
    )
     
    mapView.addLayer(fillLayer)
    mapView.addLayer(strokeLayer)
}

Удалить источники и слои можно с указанием их идентификаторов.

mapView.removeLayer("fillLayer")
mapView.removeLayer("strokeLayer")
mapView.removeSource("sourceID")

Поддерживается отрисовка маршрутов в формате кодированной строки из сервиса Построение маршрута v.2.

func mapViewDidLoad(_ mapView: MapView) {
    let routeSource = MapDataSource(id: "routeSourceID", type: .encodedString(encodedRoute))
    mapView.addSource(routeSource)
     
    let routeLayer = MapLayer(
        id: "routeLineLayer",
        sourceID: "routeSourceID",
        paint: LinePaintProperties(lineColor: .iuColor(.red), lineWidth: 2)
    )
     
    mapView.addLayer(routeLayer)
}

Кластеризация

Маркеры можно объединять в кластеры. Кластеризация создает новый источник данных на карте, поэтому использовать ее нужно только после загрузки карты. Вы можете указать радиус кластеров в метрах, цвет текста и фона.

func mapViewDidLoad(_ mapView: MapView) {
    let markers: [Marker] = ...
    mapView.addCluster(markers, id: "clusterId", radius: 50, textColor: .white, backgroundColor: .blue)
}

Удаление кластеров происходит с указанием идентификатора кластера.

mapView.removeCluster(id: "clusterId")

Обработка ошибок

Для обработки ошибок используется метод mapView(_:, didFailWithError:) делегата MapViewDelegate.

extension MyController: MapViewDelegate {
    func mapView(_ mapView: MapView, didFailWithError error: Error) {
        print("Did fail with error: \(error.localizedDescription)")
    }
}

Геокодирование

Geocoder - компонент Maps SDK для прямого и обратного геокодирования. Для инициализации необходим API key.

let geocoder = Geocoder(apiKey: "your apiKey")
 
geocoder.geocode(
    query: "Ленинградский проспект 39с79",
    lang: "ru",
    location: Coordinates(lng: 37.537892, lat: 55.796926)
) { result in
    switch result {
    case let .success(response):
        print(response)
    case let .failure(error):
        print(error.localizedDescription)
    }
}

SwiftUI

Для использования карты в SwiftUI есть компонент Map.

import SwiftUI
import MapsSDK
 
class StateObject: ObservableObject {
    let mapConfig  = MapViewConfig(
        apiKey: apiKey,
        center: Coordinates(lng: 37.537892, lat: 55.796926)
        zoomLevel: 15,
        style: .automatic
    )
     
    let mapView = MapView()
}
 
extension StateObject: MapViewDelegate {
    // методы делегата
}
 
struct ContentView: View {
    @StateObject private var state = StateObject()
     
    var body: some View {
        Map(
            config: state.mapConfig,
            view: state.mapView,
            delegate: state
        )
    }
}