Swift 中的地理定位与地图（iOS/macOS）：完整指南

Swift 中的地理定位与地图（iOS/macOS）：Core Location 和 MapKit

为 Apple 生态系统开发移动和桌面应用程序通常需要集成地理定位和地图显示功能。在 Swift 中，有两个强大的框架用于此目的：Core Location（用于确定位置）和 MapKit（用于处理地图）。在本文中，我们将详细探讨它们的功能，提供实用的代码示例，并介绍如何在您的项目中有效使用这些工具。

1. Core Location：获取坐标和处理地理数据

Core Location 是一个框架，提供对设备硬件和软件定位功能的访问。它支持 GPS、Wi-Fi、蜂窝基站和 iBeacon。主要功能包括：

• 确定当前坐标（纬度、经度）
• 监控显著的位置变化
• 地理围栏（区域）——进入/离开指定区域
• 确定移动方向和速度
• 反向地理编码（根据坐标获取地址）

1.1. 权限设置

要使用地理定位功能，需要请求用户权限。在 Info.plist 中添加以下键：

• NSLocationWhenInUseUsageDescription — 仅在应用活跃时使用
• NSLocationAlwaysAndWhenInUseUsageDescription — 用于后台监控

1.2. 示例：获取当前位置

创建一个简单的位置管理器：

import CoreLocation

class LocationManager: NSObject, CLLocationManagerDelegate {    let manager = CLLocationManager()    var currentLocation: CLLocation?        override init() {        super.init()        manager.delegate = self        manager.desiredAccuracy = kCLLocationAccuracyBest        manager.requestWhenInUseAuthorization()        manager.startUpdatingLocation()    }        func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {        guard let location = locations.last else { return }        currentLocation = location        print("纬度: \\(location.coordinate.latitude)")        print("经度: \\(location.coordinate.longitude)")        manager.stopUpdatingLocation()    }        func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {        print("错误: \\(error.localizedDescription)")    }}

2. MapKit：显示地图和处理标注

MapKit 允许在应用程序中嵌入 Apple 地图。支持：

• 显示标准、卫星和混合地图
• 添加标注（大头针、自定义标记）
• 路线规划（驾车、步行、公共交通）
• 在地图上跟踪用户位置

2.1. MKMapView 的基本设置

在 storyboard 中添加 MKMapView 或通过代码创建：

import MapKit

class MapViewController: UIViewController {    @IBOutlet weak var mapView: MKMapView!        override func viewDidLoad() {        super.viewDidLoad()        mapView.mapType = .standard        mapView.showsUserLocation = true        mapView.delegate = self    }}

2.2. 添加标注

创建一个自定义标注：

class CustomAnnotation: NSObject, MKAnnotation {    var coordinate: CLLocationCoordinate2D    var title: String?    var subtitle: String?        init(coordinate: CLLocationCoordinate2D, title: String, subtitle: String) {        self.coordinate = coordinate        self.title = title        self.subtitle = subtitle    }}

// 添加到地图let annotation = CustomAnnotation