Swift Academy · 课时

地理编码与区域

Q: 「地理编码与区域」这节课中我会学到什么？

将坐标转换为地址并监控区域。 你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

将坐标转换为地址并监控区域。

地理编码与区域 是 CoddyKit 上的免费 Swift Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Swift Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Swift Academy 课程共包含 4 节课。

什么是地理编码？

地理编码会将人类可读的地址转换为坐标；反向地理编码则会将坐标转换回可读的地址。Core Location 通过 CLGeocoder 提供这两种功能，并与 Apple 的服务器通信。

import CoreLocation
let geocoder = CLGeocoder()

对地址进行正向地理编码

使用自由格式的地址调用 geocodeAddressString(_:)。完成回调会返回一个由 CLPlacemark 对象组成的数组；请取出第一个对象并读取其 location。

geocoder.geocodeAddressString("Eiffel Tower, Paris") { placemarks, error in
    if let coord = placemarks?.first?.location?.coordinate {
        print(coord.latitude, coord.longitude)
    }
}

对坐标进行反向地理编码

给定一个 CLLocation，reverseGeocodeLocation(_:) 会返回描述该位置的地标信息：街道、城市、国家、邮政编码等。

let loc = CLLocation(latitude: 48.8584, longitude: 2.2945)
geocoder.reverseGeocodeLocation(loc) { placemarks, error in
    if let p = placemarks?.first {
        print(p.name ?? "", p.locality ?? "", p.country ?? "")
    }
}

CLPlacemark 结构

CLPlacemark 提供了丰富的字段：name、thoroughfare（街道）、locality（城市）、administrativeArea（州或省）、postalCode、country 和 isoCountryCode。其中许多字段都是可选的，因此请谨慎解包。

func format(_ p: CLPlacemark) -> String {
    [p.thoroughfare, p.locality, p.country]
        .compactMap { $0 }
        .joined(separator: ", ")
}

地理编码器的限制

CLGeocoder 基于网络，并且受到速率限制。请一次只发出一个请求，避免紧密循环；当结果不再需要时，使用 cancelGeocode() 取消正在进行的工作。

geocoder.cancelGeocode()

异步/等待地理编码

现代 Swift 提供了异步变体，让您可以使用 try await 编写线性代码，而不必使用完成处理程序。

func coordinate(for address: String) async throws -> CLLocationCoordinate2D? {
    let placemarks = try await geocoder.geocodeAddressString(address)
    return placemarks.first?.location?.coordinate
}

介绍区域监测

区域监测（地理围栏）允许系统在设备进入或离开定义的圆形区域时通知您的应用，即使您的应用没有运行也是如此。这需要始终授权。

// Requires NSLocationAlwaysAndWhenInUseUsageDescription
manager.requestAlwaysAuthorization()

定义 CLCircularRegion

地理围栏是一个包含中心点、半径（米）和唯一标识符的 CLCircularRegion。设置 notifyOnEntry 和 notifyOnExit，即可选择您关注的事件。

let region = CLCircularRegion(
    center: CLLocationCoordinate2D(latitude: 41.0, longitude: 29.0),
    radius: 200,
    identifier: "OfficeZone"
)
region.notifyOnEntry = true
region.notifyOnExit = true

开始区域监测

调用 startMonitoring(for:) 即可开始监测。设备会施加数量限制（每个应用大约 20 个区域），因此请一次只监测最相关的区域。

if CLLocationManager.isMonitoringAvailable(for: CLCircularRegion.self) {
    manager.startMonitoring(for: region)
}

接收进入/离开事件

跨越边界时，会触发委托方法 didEnterRegion 和 didExitRegion。使用该区域的 identifier 可以确定触发事件的地理围栏。

func locationManager(_ m: CLLocationManager, didEnterRegion region: CLRegion) {
    print("Entered:", region.identifier)
}
func locationManager(_ m: CLLocationManager, didExitRegion region: CLRegion) {
    print("Exited:", region.identifier)
}

查询当前状态

如果您想了解设备是否已经位于某个区域内，而不想等待边界跨越事件，请调用 requestState(for:)。结果会通过 didDetermineState 返回，可能是 .inside、.outside 或 .unknown。

manager.requestState(for: region)

func locationManager(_ m: CLLocationManager,
                     didDetermineState state: CLRegionState,
                     for region: CLRegion) {
    print(region.identifier, state == .inside ? "inside" : "outside")
}

快速检查：地理编码和区域

请验证您对相关知识的理解。

回顾：地理编码和区域

您已经学会在地址与坐标之间进行转换，并监测地理边界：

CLGeocoder 执行正向和反向地理编码（存在异步变体），并且受到调用频率限制。
CLPlacemark 保存丰富的地址字段，所有字段都是可选的。
CLCircularRegion 定义地理围栏；监测需要始终授权。
处理 didEnterRegion/didExitRegion，并使用 requestState(for:) 查询状态。

常见问题解答

「地理编码与区域」课时是免费的吗？

是的 — 「地理编码与区域」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Swift Academy 课程的其余内容，请升级到 CoddyKit PRO。 Swift Academy 课程共包含 4 节课。

「地理编码与区域」这节课中我会学到什么？

将坐标转换为地址并监控区域。你通过在浏览器中直接运行的动手代码来练习 Swift Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Swift Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Swift Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「地理编码与区域」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Swift Academy 课中编写并运行代码吗？

能。每节 Swift Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Swift Academy