Геолокация и карты в Swift: Core Location и MapKit (iOS/macOS)

Геолокация и карты в Swift (iOS/macOS): Core Location и MapKit

Разработка современных приложений для iOS и macOS часто требует работы с геолокацией и картами. В экосистеме Apple для этих целей существуют два мощных фреймворка: Core Location (получение географических данных) и MapKit (отображение карт, аннотации, маршруты). В этой статье мы подробно разберём их возможности, приведём практические примеры на Swift и покажем, как интегрировать геолокацию в ваше приложение.

1. Core Location: Определение местоположения

Core Location — это фреймворк для получения географической информации: координат, высоты над уровнем моря, направления движения, а также для мониторинга геозон (geofencing). Он работает с GPS, Wi-Fi, сотовыми вышками и iBeacon.

1.1. Настройка разрешений

Для использования геолокации необходимо запросить разрешение у пользователя. В файле Info.plist добавьте один из ключей:

• NSLocationWhenInUseUsageDescription — для получения данных только при активном использовании приложения.
• NSLocationAlwaysAndWhenInUseUsageDescription — для фонового мониторинга (требуется дополнительное объяснение).

1.2. Получение текущих координат

import CoreLocation

class LocationManager: NSObject, CLLocationManagerDelegate {
    private let manager = CLLocationManager()
    var onLocationUpdate: ((CLLocation) -> Void)?

    override init() {
        super.init()
        manager.delegate = self
        manager.desiredAccuracy = kCLLocationAccuracyBest
    }

    func requestLocation() {
        manager.requestWhenInUseAuthorization()
        manager.startUpdatingLocation()
    }

    // MARK: - CLLocationManagerDelegate
    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {
        guard let location = locations.last else { return }
        onLocationUpdate?(location)
        manager.stopUpdatingLocation() // Останавливаем обновления, если нужно одно значение
    }

    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {
        print("Ошибка получения локации: \(error.localizedDescription)")
    }
}

// Использование
let locationManager = LocationManager()
locationManager.onLocationUpdate = { location in
    print("Широта: \(location.coordinate.latitude), Долгота: \(location.coordinate.longitude)")
}
locationManager.requestLocation()

2. MapKit: Отображение карт и аннотации

MapKit позволяет встраивать интерактивные карты Apple Maps в приложения. Основной класс — MKMapView.

2.1. Создание карты в Storyboard/XIB

Добавьте MKMapView на сцену и создайте IBOutlet в контроллере. Убедитесь, что импортирован MapKit.

2.2. Программное создание карты и добавление аннотации

import MapKit

class MapViewController: UIViewController {
    var mapView: MKMapView!

    override func viewDidLoad() {
        super.viewDidLoad()
        setupMap()
        addAnnotation()
    }

    private func setupMap() {
        mapView = MKMapView(frame: view.bounds)
        mapView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.addSubview(mapView)

        // Устанавливаем регион (Москва)
        let center = CLLocationCoordinate2D(latitude: 55.751244, longitude: 37.618423)
        let span = MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
        let region = MKCoordinateRegion(center: center, span: span)
        mapView.setRegion(region, animated: true)
    }

    private func addAnnotation() {
        let annotation = MKPointAnnotation()
        annotation.coordinate = CLLocationCoordinate2D(latitude: 55.751244, longitude: 37.618423)
        annotation.title = "Москва"
        annotation.subtitle = "Красная площадь"
        mapView.addAnnotation(annotation)
    }
}

3. Прокладка маршрутов (Directions API)

MapKit позволяет строить маршруты для автомобиля, пешехода и велосипеда с помощью MKDirections.

func calculateRoute(from sourceCoordinate: CLLocationCoordinate2D, to destinationCoordinate: CLLocationCoordinate2D) {
    let sourcePlacemark = MKPlacemark(coordinate: sourceCoordinate)
    let destinationPlacemark = MKPlacemark(coordinate: destinationCoordinate)

    let sourceItem = MKMapItem(placemark: sourcePlacemark)
    let destinationItem = MKMapItem(placemark: destinationPlacemark)

    let request = MKDirections.Request()
    request.source = sourceItem
    request.destination = destinationItem
    request.transportType = .automobile

    let directions = MKDirections(request: request)
    directions.calculate { response, error in
        guard let route = response?.routes.first else {
            print("Маршрут не найден: \(error?.localizedDescription ?? "Неизвестная ошибка")")
            return
        }
        // Отображаем маршру