Firestore中如何将JSON字符串中的经纬度转换为GeoPoint

嘿，我来帮你搞定这个GeoPoint转换的坑！大部分时候出错的根源是你没搞清楚GeoPoint的构造要求——很多主流地图库（比如旧版Google Maps Android API）的GeoPoint并不是直接接受double类型的经纬度，而是要求传入乘以10^6后的整数（微度值），这是为了避免double的精度误差，同时优化存储。

第一步：正确从JSON提取经纬度到Double #

先确保你从JSON里解析出来的经纬度是准确的double值，这里推荐两种方式避免精度损失：

方式1：直接用JSONObject的getDouble（适合JSON值是数字类型） #

String locationJson = "{\"latitude\": 39.9042, \"longitude\": 116.4074}";
JSONObject jsonObj = new JSONObject(locationJson);
double lat = jsonObj.getDouble("latitude");
double lng = jsonObj.getDouble("longitude");

方式2：先取字符串再用BigDecimal转换（适合JSON值是字符串类型，避免解析误差） #

如果JSON里的经纬度是字符串格式（比如"latitude": "39.9042"），直接用getDouble可能会引入精度问题，用BigDecimal处理更稳妥：

String latStr = jsonObj.getString("latitude");
String lngStr = jsonObj.getString("longitude");
double lat = new BigDecimal(latStr).doubleValue();
double lng = new BigDecimal(lngStr).doubleValue();

第二步：正确转换为GeoPoint #

情况1：GeoPoint要求传入微度整数（比如旧版Google Maps） #

这类GeoPoint的构造函数是GeoPoint(int latitudeE6, int longitudeE6)，你需要把double经纬度乘以1000000后取整：

// 用Math.round保证四舍五入，避免截断误差
int latE6 = (int) Math.round(lat * 1000000);
int lngE6 = (int) Math.round(lng * 1000000);
GeoPoint geoPoint = new GeoPoint(latE6, lngE6);

⚠️ 注意：不要直接强转(int)(lat * 1e6)，比如39.9042123 * 1e6 = 39904212.3，直接强转会变成39904212，而Math.round会得到更准确的四舍五入结果。

情况2：GeoPoint直接接受Double参数（比如部分自定义库或ArcGIS） #

如果你的GeoPoint构造函数支持直接传double，那问题大概率出在double的精度上——比如JSON解析出来的double出现了39.90420000000001这种异常值。这时候用上面的BigDecimal方式解析就能解决。

常见错误排查 #

• ❌ 直接把double传入要求int的构造函数：比如new GeoPoint(lat, lng)，这会导致编译错误，或者数值被截断成整数（比如39.9042变成39，完全失去意义）
• ❌ 用float代替double计算：lat * 1e6如果用float会丢失精度，一定要用double
• ❌ 忽略JSON解析异常：比如字段名拼写错误（比如把latitude写成lat），或者JSON值不是合法数字

完整示例代码 #

import org.json.JSONObject;
import com.google.android.maps.GeoPoint;
import java.math.BigDecimal;

public class GeoPointUtils {
    public static GeoPoint convertJsonToGeoPoint(String json) throws Exception {
        JSONObject jsonObj = new JSONObject(json);
        
        // 从JSON字符串提取经纬度，用BigDecimal保证精度
        String latStr = jsonObj.getString("latitude");
        String lngStr = jsonObj.getString("longitude");
        double latitude = new BigDecimal(latStr).doubleValue();
        double longitude = new BigDecimal(lngStr).doubleValue();
        
        // 转换为微度整数
        int latE6 = (int) Math.round(latitude * 1000000);
        int lngE6 = (int) Math.round(longitude * 1000000);
        
        return new GeoPoint(latE6, lngE6);
    }

    public static void main(String[] args) {
        try {
            String testJson = "{\"latitude\": \"39.9042\", \"longitude\": \"116.4074\"}";
            GeoPoint point = convertJsonToGeoPoint(testJson);
            System.out.println("转换后的纬度：" + point.getLatitudeE6() / 1000000.0);
            System.out.println("转换后的经度：" + point.getLongitudeE6() / 1000000.0);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

额外提示：新版地图库推荐用LatLng #

如果是用新版Google Maps SDK，现在官方推荐使用LatLng类，它直接支持double参数，使用更简单：

LatLng latLng = new LatLng(latitude, longitude);
// 如果需要兼容旧代码转GeoPoint
int latE6 = (int) Math.round(latLng.latitude * 1000000);
int lngE6 = (int) Math.round(latLng.longitude * 1000000);
GeoPoint geoPoint = new GeoPoint(latE6, lngE6);

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