Firestore多属性不等式过滤受限，如何实现地图范围地点查询？

问题场景 #

我在Firestore中存储了带经度（longitude）和纬度（latitude）的地点数据，前端通过地图边界参数发起请求：

const ne = map.getBounds()?.getNorthEast();
const sw = map.getBounds()?.getSouthWest();

const { data: places } = useApiRequest<Place[]>({
  operation: () =>
    axios.get(
      `/places?${`minLatitude=${sw?.lat()}&maxLatitude=${ne?.lat()}&minLongitude=${sw?.lng()}&maxLongitude=${ne?.lng()}`}`
    ),
});

后端尝试用Firestore多字段范围过滤查询：

const querySnapshot = await collectionRef
  .where('latitude', '>=', minLatitude)
  .where('latitude', '<=', maxLatitude)
  .where('longitude', '>=', minLongitude)
  .where('longitude', '<=', maxLongitude)
  .get();

执行后触发错误：

INVALID_ARGUMENT: Cannot have inequality filters on multiple properties: [latitude, longitude]

可行解决方案 #

1. 单维度过滤+内存二次筛选 #

先通过一个维度（比如纬度）的范围查询获取候选文档，再在服务器内存中过滤经度范围。这种方法实现简单，适合数据量不大的场景：

// 先过滤纬度范围
const querySnapshot = await collectionRef
  .where('latitude', '>=', minLatitude)
  .where('latitude', '<=', maxLatitude)
  .get();

// 内存中过滤经度
const places = querySnapshot.docs
  .map(doc => ({ id: doc.id, ...doc.data() }))
  .filter(place => place.longitude >= minLongitude && place.longitude <= maxLongitude);

注意：如果纬度范围覆盖的文档过多，会增加Firestore读取量和服务器内存消耗，需评估数据规模后使用。

2. 基于GeoHash的分区查询 #

给每个地点文档添加geohash字段（提前计算并存入），利用GeoHash的前缀特性缩小查询范围：

• 第一步：计算当前地图边界覆盖的所有GeoHash前缀（比如选6位精度，平衡查询精度和范围）
• 第二步：用where('geohash', 'in', 前缀列表)查询候选文档
• 第三步：在内存中过滤精确的经纬度范围

示例代码（假设已提前存储geohash字段）：

// 假设已实现计算边界覆盖的GeoHash前缀函数getGeohashPrefixes
const geohashPrefixes = getGeohashPrefixes(minLatitude, maxLatitude, minLongitude, maxLongitude);

// 查询所有匹配前缀的文档
const querySnapshot = await collectionRef
  .where('geohash', 'in', geohashPrefixes)
  .get();

// 内存中精确过滤经纬度
const places = querySnapshot.docs
  .map(doc => ({ id: doc.id, ...doc.data() }))
  .filter(place => 
    place.latitude >= minLatitude && place.latitude <= maxLatitude &&
    place.longitude >= minLongitude && place.longitude <= maxLongitude
  );

这种方法能大幅减少查询的文档数量，适合数据量较大的场景，需要额外维护geohash字段。

3. 使用Firestore官方地理空间查询 #

将经纬度存储为Firestore的GeoPoint类型（而非单独的latitude/longitude字段），使用官方提供的geoWithinBox查询：
首先修改数据结构，把地点的位置存为GeoPoint：

// 示例：存储地点时的写法
await collectionRef.add({
  name: "某地点",
  location: new admin.firestore.GeoPoint(latitude, longitude)
});

后端查询时使用geoWithinBox：

const swPoint = new admin.firestore.GeoPoint(minLatitude, minLongitude);
const nePoint = new admin.firestore.GeoPoint(maxLatitude, maxLongitude);

const querySnapshot = await collectionRef
  .where('location', 'geoWithinBox', swPoint, nePoint)
  .get();

const places = querySnapshot.docs.map(doc => ({ id: doc.id, ...doc.data() }));

这是最推荐的方案，利用Firestore原生支持的地理查询，无需额外处理多字段不等式限制，性能和准确性都有保障。

关于全文档查询的疑问 #

不需要查询所有文档后再过滤，上述三种方案都能有效缩小查询范围，避免不必要的资源消耗。根据数据规模和业务需求选择合适的方案即可。

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