Java 集成高德开放平台 POI 搜索 API 实战

这里定义了关键字搜索接口。注意参数命名需与官方文档一致，Uniapi 会自动处理拼接逻辑。如果需要多边形搜索，可类似添加 @GetHttpInterface("/place/polygon") 方法。

业务层调用示例

在实际业务中，我们需要注入服务并处理分页。以下是一个测试用例，演示如何查询长沙岳麓区的餐饮数据。

package com.yelang.project.unihttp;

import org.junit.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@SpringBootTest
@RunWith(SpringRunner.class)
public class AmaPOISearchCase {
    private static final String AMAP_CLIENT_AK = "你的访问 Key";
    
    @Autowired
    private AmapSearchService amapSearchService;

    @Test
    public void searchByKeyWordOrTypies() throws InterruptedException {
        String keywords = "餐厅";
        String types = "050000"; // 餐饮服务
        String region = "430104";
        String showFields = "children,business,indoor,navi,photos";
        
        // 循环演示分页获取
        for (int i = 1; i <= 1; i++) {
            HttpResponse<String> result = amapSearchService.getSearch(
                keywords, types, region, "20", String.valueOf(i), showFields, AMAP_CLIENT_AK
            );
            System.out.println(result.getBodyResult());
            Thread.sleep(3000L); // 避免触发频率限制
        }
    }
}

运行后控制台会输出 JSON 格式的响应。建议将返回结果转为实体类进行后续处理，避免手动解析字符串。

常见问题与优化

1. 频率限制：高德对 Key 有调用次数限制，生产环境务必增加休眠或令牌桶限流，代码中的 Thread.sleep 仅为演示，实际应使用更优雅的控制策略。
2. 数据安全：Key 不要硬编码在代码库中，建议放入配置文件或环境变量。敏感操作建议配合签名机制（sig 参数）。
3. 数据解析：返回的 JSON 结构较深，建议使用 Gson 或 Jackson 映射为 VO 对象，提高开发效率。

通过以上步骤，即可在 Java 应用中快速落地 POI 搜索功能。实际开发中还需根据业务需求调整参数组合，确保用户体验与系统稳定性。