Swift中使用GeoFirestore查询Firestore后如何获取目标文档

看起来你已经走在正确的路上了，只是对GeoFirestore的查询机制还有点模糊。咱们一步步理清楚：

核心原理：GeoFirestore的定位 #

GeoFirestore本身只负责地理位置的索引与匹配查询，它不会直接返回完整的Firestore文档——它只会给你匹配到的文档ID（也就是代码里的key）和对应的地理位置。所以你需要通过这个文档ID，再去Firestore集合里获取完整的文档数据，这也是你代码里已经在做的geoFirestoreRef.document(key!).getDocument这一步。

优化你的现有代码 #

你当前用了.documentEntered事件，这个事件是实时监听的：只有当新的文档进入你设定的100km范围时才会触发。如果想一次性获取所有当前符合条件的文档，还需要加上.initialData事件，它会在监听启动时返回所有初始匹配的文档。

这里给你调整后的完整代码：

FirebaseApp.configure()
let db = Firestore.firestore()
let geoFirestoreRef = db.collection("spot")
let geoFirestore = GeoFirestore(collectionRef: geoFirestoreRef)

// 设定查询中心与半径
let center = CLLocation(latitude: 35.681236, longitude: 139.767125)
var circleQuery = geoFirestore.query(withCenter: center, radius: 100.0)

// 监听初始匹配的所有文档
let initialListener = circleQuery.observe(.initialData, with: { (key, location) in
    guard let key = key else { return }
    geoFirestoreRef.document(key).getDocument { (document, error) in
        if let error = error {
            print("获取文档失败：\(error.localizedDescription)")
            return
        }
        guard let document = document, document.exists else {
            print("文档不存在：\(key)")
            return
        }
        // 这里拿到了完整的文档数据，可以处理它
        print("初始匹配文档：\(document.data() ?? [:])")
    }
})

// 监听后续进入查询范围的文档
let enteredListener = circleQuery.observe(.documentEntered, with: { (key, location) in
    guard let key = key, let location = location else { return }
    print("新文档进入范围：ID=\(key)，位置=\(location.coordinate)")
    geoFirestoreRef.document(key).getDocument { (document, error) in
        // 同样处理文档数据
        if let document = document, document.exists {
            print("新文档内容：\(document.data() ?? [:])")
        }
    }
})

// 记得在不需要监听时移除监听（比如页面销毁时）
// initialListener.remove()
// enteredListener.remove()

额外说明 #

• 如果你不需要实时更新，只是想一次性查询所有符合条件的文档，可以只使用.initialData事件，拿到结果后立即移除监听。
• GeoFirestore要求你的集合文档里必须有一个用于存储地理位置的字段（默认是g字段，你也可以在初始化GeoFirestore时自定义），这个字段是GeoFirestore用来做索引和查询的关键。
• 如果你觉得这种“先拿ID再查文档”的方式繁琐，也可以考虑使用Firestore原生的地理查询（通过whereField(_:geoHashLessThan:)等方法），但GeoFirestore在处理大范围、大数据量的地理查询时性能更优。

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