Swift结合RealityKit/ARKit在真实经纬度放置AR对象问题排查

你直接将地理经纬度和海拔值当作RealityKit的3D世界坐标（SIMD3<Float>）使用，但ARKit的world坐标系是基于设备初始位置的本地三维坐标系（单位为米），和地理坐标系完全不兼容，所以不管你身处何地，文本都会直接显示在设备本地坐标系的对应位置，而非真实地理坐标点。

要实现真实地理坐标的AR实体放置，必须使用ARKit的**地理追踪（GeoTracking）**功能，步骤如下：

1. 启用AR地理追踪配置 #

首先在初始化AR会话时，使用ARGeoTrackingConfiguration替代普通配置：

override func viewDidLoad() {
    super.viewDidLoad()
    let geoConfig = ARGeoTrackingConfiguration()
    // 可选：设置初始区域，帮助快速定位
    let targetRegion = CLCircularRegion(center: CLLocationCoordinate2D(latitude: 43.037682, longitude: -76.135040), radius: 100, identifier: "TargetArea")
    geoConfig.initialGeoTrackingRegion = targetRegion
    arView.session.run(geoConfig)
}

2. 使用地理锚点绑定真实坐标 #

RealityKit提供了ARGeoAnchor和GeoAnchorEntity，专门用于将实体绑定到真实地理坐标。你需要在AR会话追踪到地理信息后，创建目标锚点：

func session(_ session: ARSession, didAdd anchors: [ARAnchor]) {
    // 仅处理首次地理锚点添加（避免重复创建实体）
    guard anchors.contains(where: { $0 is ARGeoAnchor }),
          arView.scene.anchors.first(where: { $0.name == "TargetTextAnchor" }) == nil else {
        return
    }
    
    // 目标地理坐标与海拔
    let targetCoordinate = CLLocationCoordinate2D(latitude: 43.037682, longitude: -76.135040)
    let targetAltitude: CLLocationDistance = 7 // 单位：米
    
    // 创建并添加地理锚点到会话
    let targetGeoAnchor = ARGeoAnchor(coordinate: targetCoordinate, altitude: targetAltitude)
    arView.session.add(anchor: targetGeoAnchor)
    
    // 创建文本实体
    let textMesh = MeshResource.generateText("Hendricks Chapel", extrusionDepth: 0.1)
    let textMaterial = SimpleMaterial(color: .orange, isMetallic: false)
    let textModel = ModelEntity(mesh: textMesh, materials: [textMaterial])
    
    // 将文本绑定到地理锚点
    let modelAnchor = AnchorEntity(anchor: targetGeoAnchor)
    modelAnchor.name = "TargetTextAnchor" // 标记锚点，避免重复创建
    modelAnchor.addChild(textModel)
    arView.scene.addAnchor(modelAnchor)
}

3. 必要权限与设备要求 #

• 设备：仅支持iPhone 12及以上机型（搭载A14芯片及更高）
• 系统：iOS 14及以上
• 权限：需要开启始终允许的位置权限，以及AR权限
• 环境：必须在户外GPS信号良好的区域使用（室内GPS信号弱，无法完成地理追踪初始化）

• 不要在locationManager回调中重复创建实体，否则会生成大量重复文本
• 地理追踪初始化需要一定时间，需等待ARKit完成地理定位后，实体才会正确显示在目标位置

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