Java 高德地图面检索中 WGS84 坐标转换与 POI 查询实战

4、返回结果

poi 对象内包含 name, id, location, type, address 等详细信息。部分扩展字段如 children（子 POI）、business（商圈信息）、indoor（室内信息）、navi（导航信息）、photos（图片）等，需在 show_fields 参数中显式指定才能返回。

面数据检索实践

以步步高梅溪新天地为例，演示基于 Java 的面数据检索实现。重点对比 GCJ-02 与 WGS84 坐标的差异，并介绍全量数据的穷举抓取策略。

1、GCJ-02 面检索

直接使用高德提供的 GCJ-02 坐标数据进行查询是最稳妥的方式。以下是一个基于 JUnit 的测试方法示例：

@Test
public void searchByPolygon() throws InterruptedException {
    String polygon = "112.859225,28.20061;112.859172,28.20059;112.859117,28.200556;...";
    // 将分号替换为管道符，符合 API 规范
    polygon = polygon.replaceAll(";", "|"); 
    String types = "080000|060000";
    String pageSize = "25";
    String showFields = "children,business,indoor,navi,photos";
    
    HttpResponse<String> result = null;
    for (int i = 1; i <= 1; i++) {
        result = amapSearchService.searchByPolygon(polygon, keywords, types, pageSize, String.valueOf(i), showFields, AMAP_CLIENT_AK);
        System.out.println(result.getBodyResult());
        Thread.sleep(3000L); // 注意控制请求频率
    }
}

运行后控制台会返回准确的商场周边 POI 数据，验证了 GCJ-02 坐标在面检索中的有效性。

2、WGS84 面检索与坐标转换

实际业务中常遇到 WGS84 坐标源，直接传入会导致检索偏移。我们需要先将 WGS84 转换为 GCJ-02。

坐标转换逻辑

private String gcj2wgs84(String source) {
    StringBuffer wgs84 = new StringBuffer(source.length());
    String[] aoiStrArray = source.split(";");
    
    for (int i = 0; i < aoiStrArray.length; i++) {
        String loc = aoiStrArray[i];
        String[] latLon = loc.split(",");
        double lng = Double.parseDouble(latLon[0]);
        double lat = Double.parseDouble(latLon[1]);
        
        // 调用工具类进行转换
        double[] gcj284 = CoordinateTransformUtil.gcj02towgs84(lng, lat);
        wgs84.append(gcj284[0]).append(",").append(gcj284[1]).append("|");
    }
    return wgs84.substring(0, wgs84.length() - 1);
}

/**
 * GCJ02(火星坐标系) 转 GPS84
 */
public static double[] gcj02towgs84(double lng, double lat) {
    if (outOfChina(lng, lat)) {
        return new double[] { lng, lat };
    }
    double dlat = transformLat(lng - 105.0, lat - 35.0);
    double dlng = transformLng(lng - 105.0, lat - 35.0);
    double radLat = lat / 180.0 * Math.PI;
    double magic = Math.sin(radLat);
    magic = 1 - ee * magic * magic;
    double sqrtMagic = Math.sqrt(magic);
    
    dlat = (dlat * 180.0) / ((a * (1 - ee)) / (magic * sqrtMagic) * Math.PI);
    dlng = (dlng * 180.0) / (a / sqrtMagic * Math.cos(radLat) * Math.PI);
    
    double mglat = lat + dlat;
    double mglng = lng + dlng;
    return new double[] { lng * 2 - mglng, lat * 2 - mglat };
}

转换后的检索效果

将坐标转换后再进行检索实验，会发现返回的 POI 兴趣点位置发生了偏移，不再准确落在指定的商场区域内。这再次印证了一个关键点：高德面检索接口要求传入的坐标必须是 GCJ-02 坐标系。如果持有 WGS84 数据，务必在前端或后端先完成坐标纠偏。

3、全量数据穷举策略

高德地图的 Polygon 接口不像某些平台那样直接返回总数（total_count）。为了抓取所有数据，通常采用分页穷举的方式：只要当前页有数据，就继续请求下一页。

HttpResponse<String> result = null;
int scrapingIndex = 1;
int dataCount = 0;

do {
    result = amapSearchService.searchByPolygon(gcjPolygon, keywords, types, pageSize, String.valueOf(scrapingIndex), showFields, AMAP_CLIENT_AK);
    System.out.println("使用高德面搜索结果");
    System.out.println(result.getBodyResult());
    
    if (StringUtils.isNotEmpty(result.getBodyResult())) {
        AmapSearchVO searchVO = gson.fromJson(result.getBodyResult(), AmapSearchVO.class);
        System.out.println(searchVO.getCount());
        dataCount = searchVO.getCount();
        scrapingIndex++;
    }
    Thread.sleep(3000L);
} while (dataCount > 0);

System.out.println("一共抓取数据页数：" + scrapingIndex);

通过 do...while 循环确保至少执行一次，并根据返回的 count 判断是否停止。实际运行中，该商场数据大约分布在 10 页左右，超过此范围即无新数据返回。

总结

在高德地图 POI 检索开发中，坐标系的一致性至关重要。本文通过 Java 实例演示了如何正确处理 WGS84 到 GCJ-02 的坐标转换，解决了因坐标系不匹配导致的检索偏移问题。同时，针对接口缺乏总数统计的特性，提供了基于分页循环的全量数据抓取方案。这些经验对于处理 LBS 相关业务具有较高的参考价值。