SwiftUI MapKit 如何基于用户当前位置设置地图显示区域（Xcode 12）

现有代码存在的问题 #

• 强制解包空值导致崩溃：定位授权完成、首次定位回调返回前，locationManager.location值为nil，直接强制解包会触发运行时错误
• 位置数据与地图状态无联动：@State修饰的地图区域一直保留硬编码的初始坐标，即便后续拿到了用户位置，也没有同步更新region的中心值
• 注解数据源不稳定：每次视图重绘时临时生成注解数组，不符合Map视图annotationItems对稳定可标识数据源的要求

实现步骤 #

1. 现有LocationManager类不需要做修改，保留定位权限申请、位置更新回调、数据发布的原有逻辑即可
2. 调整ShowMapView的内部状态定义：
   • 将地图注解列表改为@State修饰的持久化数据源，避免每次重绘时重复创建
   • 地图初始区域可设置一个通用占位坐标，等待定位回调获取到有效位置后再覆盖
3. 借助SwiftUI的.onReceive修饰符，直接监听locationManager.$location的发布值，当拿到有效位置时自动同步更新地图显示区域、刷新对应位置的注解

适配后的完整代码 #

import MapKit
import SwiftUI

struct AnnotationItem: Identifiable {
    let id = UUID()
    let name: String
    let coordinate: CLLocationCoordinate2D
}

struct ShowMapView: View {
  @ObservedObject private var locationManager = LocationManager()
  // 持久化的注解数据源
  @State private var annotations: [AnnotationItem] = []
  // 初始占位地图区域，等待定位完成后自动覆盖
  @State private var region = MKCoordinateRegion(
    center: CLLocationCoordinate2D(latitude: 39.9042, longitude: 116.4074),
    span: MKCoordinateSpan(latitudeDelta: 0.5, longitudeDelta: 0.5)
  )

  var body: some View {
    Map(coordinateRegion: $region, annotationItems: annotations) { item in
      MapPin(coordinate: item.coordinate)
    }
    .frame(height: 300)
    // 监听用户位置更新事件
    .onReceive(locationManager.$location) { updatedLocation in
      guard let location = updatedLocation else { return }
      // 用当前用户位置更新地图显示中心
      region.center = location.coordinate
      // 更新用户位置对应的标注
      annotations = [
        AnnotationItem(
          name: "当前位置",
          coordinate: location.coordinate
        )
      ]
    }
  }
}

开发注意事项 #

• 地图的span缩放比例不需要随位置变动修改，固定设置即可，反复修改span会导致地图缩放视角异常跳变
• 必须在项目Info.plist中配置Privacy - Location When In Use Usage Description字段，否则系统不会弹出定位授权弹窗，永远无法获取到用户位置
• 如果需要跟随用户移动持续更新地图中心位置，不需要额外增加逻辑，LocationManager会持续发布新的位置值，当前监听逻辑会自动同步更新地图中心

内容的提问来源于stack exchange，提问作者Darrell