CoreLocation for Swift：完整指南与示例

什么是 CoreLocation 以及为什么需要它？

CoreLocation 是 Apple 为 iOS、macOS、watchOS 和 tvOS 平台提供的内置框架。它为开发者提供了访问设备定位硬件和软件功能的能力。与第三方库不同，CoreLocation 无需通过包管理器（CocoaPods、SPM）安装——它是标准 SDK 的一部分。

该框架的主要功能：

\n
• 确定当前地理坐标（纬度和经度）。
\n
• 实时跟踪位置变化。
\n
• 地理围栏（Geofencing）——在进入/离开指定区域时接收通知。
\n
• 确定方向（指南针）和移动速度。
\n
• 反向地理编码（将坐标转换为地址）和正向地理编码（将地址转换为坐标）。
\n

该库对于导航应用、配送服务、健身追踪器、带有地理标签的社交网络以及任何需要了解用户位置的应用来说都是不可或缺的。

安装 CoreLocation

由于 CoreLocation 是操作系统的一部分，因此无需通过 pip 或 npm 安装。使用时只需在代码中导入该模块即可。

重要提示： 要使用地理位置功能，必须在项目的 Info.plist 文件中添加使用说明。否则，在尝试请求权限时应用将崩溃。

根据您需要位置的时间，添加以下其中一个键：

\n
• NSLocationWhenInUseUsageDescription —— 仅在应用活跃使用时访问。
\n
• NSLocationAlwaysAndWhenInUseUsageDescription —— 持续访问（即使在后台）。
\n

值应为向用户显示的字符串（例如，“应用需要访问地理位置以显示附近的咖啡馆”）。

快速入门与代码示例

让我们看一个获取用户当前坐标的最小示例。

import CoreLocation\n\nclass ViewController: UIViewController, CLLocationManagerDelegate {\n\n    let locationManager = CLLocationManager()\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        locationManager.delegate = self\n        locationManager.requestWhenInUseAuthorization()\n        locationManager.startUpdatingLocation()\n    }\n\n    // MARK: - CLLocationManagerDelegate\n    func locationManager(_ manager: CLLocationManager, didUpdateLocations locations: [CLLocation]) {\n        guard let location = locations.last else { return }\n        print("纬度: \\(location.coordinate.latitude)")\n        print("经度: \\(location.coordinate.longitude)")\n        // 停止更新以节省电量\n        locationManager.stopUpdatingLocation()\n    }\n\n    func locationManager(_ manager: CLLocationManager, didFailWithError error: Error) {\n        print("获取位置失败: \\(error.localizedDescription)")\n    }\n}\n

这段代码创建了一个管理器，向用户请求权限并开始跟踪。一旦获取到坐标，它们就会被打印到控制台。

CoreLocation 的主要方法/函数

以下是 CLLocationManager 类及其辅助类的关键方法和属性。

1. requestWhenInUseAuthorization()

描述： 请求用户授权仅在应用使用期间访问地理位置（应用在前台活跃时）。

参数： 无。

示例：

let manager = CLLocationManager()\nmanager.requestWhenInUseAuthorization()\n

2.