如何计算经纬度范围以用于Firestore数据库查询（用户X英里内）

1. 经纬度范围查询的正确性 #

这种通过经纬度上下限过滤的方式是预过滤手段，能快速排除大部分不在大致范围内的地点，但不能直接作为精确的半径筛选——因为地球是椭球体，相同的经度差对应的实际距离在不同纬度上差异很大（比如赤道上1经度≈69英里，极地附近趋近于0）。所以这个步骤之后，必须对查询结果做二次精确距离计算才能得到真正在X英里内的地点。

2. C#计算经纬度范围的方法 #

基于地球的近似参数，我们可以算出X英里对应的经纬度上下限，代码如下：

using System;

public static class GeoHelper
{
    private const double EarthRadiusMiles = 3956.0;
    private const double MilesPerLatDegree = 69.0;

    public static (double MinLat, double MaxLat, double MinLng, double MaxLng) GetGeoBounds(double userLat, double userLng, double radiusMiles)
    {
        // 计算纬度范围（纬度每度距离基本固定）
        double latRange = radiusMiles / MilesPerLatDegree;
        double minLat = userLat - latRange;
        double maxLat = userLat + latRange;

        // 计算经度范围（随纬度变化，需转弧度计算）
        double latRadians = userLat * Math.PI / 180;
        double milesPerLngDegree = MilesPerLatDegree * Math.Cos(latRadians);
        double lngRange = radiusMiles / milesPerLngDegree;
        double minLng = userLng - lngRange;
        double maxLng = userLng + lngRange;

        // 处理跨180°经度线的边界情况
        if (minLng < -180) minLng += 360;
        if (maxLng > 180) maxLng -= 360;

        return (minLat, maxLat, minLng, maxLng);
    }
}

3. 对应的Firestore查询代码 #

先调用上述方法获取范围，执行预查询后再做精确距离过滤：

// 用户当前坐标示例
double userLat = 37.7749;
double userLng = -122.4194;
double radiusMiles = 5;

// 获取经纬度范围
var bounds = GeoHelper.GetGeoBounds(userLat, userLng, radiusMiles);

// Firestore预查询
var querySnapshot = await Database.Collection("Map")
    .WhereGreaterThanOrEqualTo("Latitude", bounds.MinLat)
    .WhereLessThanOrEqualTo("Latitude", bounds.MaxLat)
    .WhereGreaterThanOrEqualTo("Longitude", bounds.MinLng)
    .WhereLessThanOrEqualTo("Longitude", bounds.MaxLng)
    .GetAsync();

// 二次过滤：用Haversine公式计算精确距离
var nearbyPlaces = new List<YourPlaceModel>();
foreach (var doc in querySnapshot.Documents)
{
    var place = doc.ToObject<YourPlaceModel>();
    double distance = CalculateExactDistance(userLat, userLng, place.Latitude, place.Longitude);
    if (distance <= radiusMiles)
    {
        nearbyPlaces.Add(place);
    }
}

// 精确距离计算实现
private double CalculateExactDistance(double lat1, double lng1, double lat2, double lng2)
{
    double dLat = (lat2 - lat1) * Math.PI / 180;
    double dLng = (lng2 - lng1) * Math.PI / 180;
    double a = Math.Sin(dLat / 2) * Math.Sin(dLat / 2) +
               Math.Cos(lat1 * Math.PI / 180) * Math.Cos(lat2 * Math.PI / 180) *
               Math.Sin(dLng / 2) * Math.Sin(dLng / 2);
    double c = 2 * Math.Atan2(Math.Sqrt(a), Math.Sqrt(1 - a));
    return EarthRadiusMiles * c;
}

4. 更优的Firestore原生方案 #

如果你的Firestore版本支持，推荐直接使用地理点查询，这比自己算范围更可靠且无需二次过滤：

// 注意：需将数据库中坐标存储为Firestore的GeoPoint类型，而非分开的Lat/Lng字段
var userLocation = new GeoPoint(userLat, userLng);
// Firestore默认用米做单位，需将英里转换为米（1英里≈1609.34米）
var querySnapshot = await Database.Collection("Map")
    .WhereDistanceLessThanOrEqualTo("Location", userLocation, radiusMiles * 1609.34)
    .GetAsync();

// 此时返回的结果就是精确在X英里内的地点

提示：使用该方法需要为Location字段创建地理索引，否则查询会报错。

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