iOS

Подключение

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

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

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

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

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

  • API key для работы с SDK;
  • координаты центра карты;
  • начальный уровень zoom;
  • стиль тайлов.
import MapsSDK
 
...
 
override func viewDidLoad() {
    let mapConfig MapViewConfig(
        apiKey"##YOUR_API_KEY##",
        centerCoordinates(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, animatedtrue)


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

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


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

mapView.setZoom(11, animatedtrue)


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

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"coordsCoordinates(lng: 33, lat: 55), pin: .electricPin)
mapView.addMarker(marker1)
let marker2 Marker(id"marker_id_2"coordsCoordinates(lng: 33, lat: 55), pin: .custom(pinImage))
mapView.addMarker(marker2)

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

mapView.addMarkers([marker1marker2])

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

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 MyControllerMapViewDelegate {
    func mapView(_ mapViewMapViewonMarkerSelectIDString) {
        mapView.displayPopup(markerIdidcontent"Hello world")
    }
}

Стили

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

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

GeoJSON

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

Добавляйте источники и слои только после загрузки карты, которую можно отследить в методе делегата mapViewDidLoad(_:)
func mapViewDidLoad(_ mapViewMapView) {
    let sourceData Data(...)
     
    let source MapDataSource(id"sourceID"type: .geoJSON(sourceData))
    mapView.addSource(source)
     
    let fillLayer MapLayer(
        id"fillLayer",
        sourceID"sourceID",
        paintFillPaintProperties(fillColor: .iuColor(.green), fillOpacity: 0.3)
    )
 
    let strokeLayer MapLayer(
        id"strokeLayer",
        sourceID"sourceID",
        paintLinePaintProperties()
    )
     
    mapView.addLayer(fillLayer)
    mapView.addLayer(strokeLayer)
}

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

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


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

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

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

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


func mapViewDidLoad(_ mapViewMapView) {
    let markers: [Marker] = ...
    mapView.addCluster(markersid"clusterId"radius: 50, textColor: .whitebackgroundColor: .blue)
}

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


mapView.removeCluster(id"clusterId")

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

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

extension MyControllerMapViewDelegate {
    func mapView(_ mapViewMapViewdidFailWithError errorError) {
        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",
    locationCoordinates(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 StateObjectObservableObject {
    let mapConfig  MapViewConfig(
        apiKeyapiKey,
        centerCoordinates(lng: 37.537892, lat: 55.796926)
        zoomLevel: 15,
        style: .automatic
    )
     
    let mapView MapView()
}
 
extension StateObjectMapViewDelegate {
    // методы делегата
}
 
struct ContentViewView {
    @StateObject private var state StateObject()
     
    var bodysome View {
        Map(
            configstate.mapConfig,
            viewstate.mapView,
            delegatestate
        )
    }
}
Was this information helpful?