概述

产品介绍

搜索服务API是一类简单的HTTP接口，提供多种查询POI信息的能力，其中包括关键字搜索、周边搜索、多边形搜索、ID查询四种筛选机制。

使用API前您需先申请Key，若无高德地图API账号需要先申请账号。

注意：在此接口之中，您可以通过city&citylimit参数指定希望搜索的城市或区县。而city参数能够接收citycode和adcode，citycode仅能精确到城市，而adcode却能够精确到区县。

例如：北京，citycode：010，adcode：110000

​ 北京-海淀区，citycode：010，adcode：110108

故使用citycode仅能在北京范围内搜索，而adcode能够指定在海淀区搜索。

综上所述，为了您查询的精确，我们强烈建议您使用adcode。

另外，无论您指定多少个type，每次请求最多返回1000个POI信息，若场景需要获取更可能多的POI；建议您不要在type之中指定过多的类别，而是分多次请求从而得到更加准确的结果。

适用场景

• 关键字搜索：通过用POI的关键字进行条件搜索，例如：肯德基、朝阳公园等；同时支持设置POI类型搜索，例如：银行
• 周边搜索：在用户传入经纬度坐标点附近，在设定的范围内，按照关键字或POI类型搜索；
• 多边形搜索：在多边形区域内进行搜索
• ID查询：通过POI ID，查询某个POI详情，建议可同输入提示API配合使用

使用限制

服务调用量的限制请点击这里查阅。

使用说明

第一步，申请”Web服务API”密钥（Key）；

第二步，拼接HTTP请求URL，第一步申请的Key需作为必填参数一同发送；

第三步，接收HTTP请求返回的数据（JSON或XML格式），解析数据。

如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。