Flutter+Firebase基于Geohash范围查询文档异常排查

核心问题 #

你通过Geohash范围查询Firebase附近位置时，明明位置A（52.462570419161594, -2.0120335164758725）和位置B（52.46648448588268, -1.9841125656313279）距离极近且Geohash前缀均为gcqd6，但查询却返回空，根源在于三个关键错误：

1. 经纬度距离转换系数错误 #

你代码中使用固定的lon = 0.0181818181818182（每英里对应的经度度数）是严重问题——经度每英里的度数随纬度变化，在北纬52度左右，这个值远小于0.01818。错误的系数导致计算出的上下界经纬度偏差极大，编码出的Geohash（mpt5mf52n18z和mptmvc2wncyc）完全不在目标区域（gcqd6开头）。

正确的做法是根据当前纬度计算经度每英里的度数：

double lat = 0.0144927536231884; // 纬度每英里的度数（固定值，纬度线间距一致）
// 根据当前纬度计算经度每英里的度数
double lon = 0.0144927536231884 / cos(latitude * pi / 180);

2. Firebase查询条件写反 #

你的查询代码中把isGreaterThan和isLessThan的参数搞反了：

// 错误写法：
.where("geohash", isGreaterThan: range.upper)
.where("geohash", isLessThan: range.lower);

// 正确写法：
.where("geohash", isGreaterThanOrEqualTo: range.lower)
.where("geohash", isLessThanOrEqualTo: range.upper);

Geohash的字典序对应地理空间顺序，范围查询应该是大于等于下界，小于等于上界，否则查询的是一个不存在的反向范围。

3. Geohash精度不匹配 #

你存储的Geohash是gcqd6（5位），但getGeohashRange返回的是12位精度的Geohash。查询时如果用12位的范围去匹配5位的存储值，会导致范围不匹配。

解决方法：统一Geohash精度，比如都用5位：

// 在encode后截取前5位
var lower = geo.encode(lowerLat, lowerLon).substring(0,5);
var upper = geo.encode(upperLat, upperLon).substring(0,5);

这样范围查询的前缀和存储的Geohash精度一致，才能正确命中目标文档。

修复后的完整代码示例 #

import 'dart:math';

// 获取Geohash范围
GeoHashRange getGeohashRange({
  required double latitude,
  required double longitude,
  double distance = 12, // 英里
}) {
  double latPerMile = 0.0144927536231884; // 纬度每英里度数
  // 根据当前纬度计算经度每英里度数
  double lonPerMile = latPerMile / cos(latitude * pi / 180);

  double lowerLat = latitude - latPerMile * distance;
  double lowerLon = longitude - lonPerMile * distance;

  double upperLat = latitude + latPerMile * distance;
  double upperLon = longitude + lonPerMile * distance;

  GeoHasher geo = GeoHasher();

  // 统一使用5位精度的Geohash
  var lower = geo.encode(lowerLat, lowerLon).substring(0,5);
  var upper = geo.encode(upperLat, upperLon).substring(0,5);

  return GeoHashRange(lower: lower, upper: upper);
}

class GeoHashRange {
  late String upper;
  late String lower;

  GeoHashRange({
    required this.upper,
    required this.lower,
  });
}

// Firebase查询附近车库
Stream<List<Garage>> getLocalGarages(Position position) {
  GeoHashRange range = getGeohashRange(
    latitude: position.latitude,
    longitude: position.longitude,
  );

  var ref = _db
      .collection('garages')
      .where("geohash", isGreaterThanOrEqualTo: range.lower)
      .where("geohash", isLessThanOrEqualTo: range.upper);

  return ref.snapshots().map(
        (list) =>
            list.docs.map((doc) => Garage.fromJson(doc.data())).toList(),
      );
}

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