控制台
登录
注册
退出
我的消息
云图市场
应用管理
GeoHUB
产品介绍
产品介绍
高德开放平台产品介绍
查看全部文档
搜索定位
鸿蒙星河版定位SDK
HOT
鸿蒙星河版定位SDK
搜索
HOT
位置、周边、行政区、ID等查询接口
API
JS
Android
iOS
定位
HOT
基于LBS的定位服务
API
Android
iOS
地理/逆地理编码
位置名称与经纬度之间转换服务
API
JS
Android
iOS
地理围栏
虚拟空间围栏服务
API
Android
iOS
天气查询
查询目标区域当前/未来天气
智能硬件定位
通过基站、Wifi获取位置信息
路线导航
导航
HOT
轻松地在APP中加入导航能力
Android
iOS
路线规划
HOT
提供步行、驾车等规划能力
API
JS
Android
iOS
猎鹰服务
提供专业轨迹管理服务
API
Android
iOS
货车路径规划
专业的货车路径规划服务
API
Android
iOS
智能调度引擎
智能外勤调度,提升效益
物流服务
提供智慧物流API服务接口
公交信息查询
查询公交信息
交通路况查询
查询交通态势情况
高级路径规划
高级路径规划等能力
地图产品
鸿蒙星河版地图SDK
HOT
鸿蒙星河版-轻量地图SDK
动态地图
HOT
动态地图展示、配置
API
JS
Android
iOS
HarmonyOS
3D地图
HOT
3D动态地图展示、配置
地铁图
简单易用的移动端地铁线路图开发接口
JS
Android
iOS
静态地图
灵活地将高德地图迁入应用网页
3D地形图
卫星地形图还原真实地形地貌
高级地图工具
自定义地图
地图数据可视化 (LOCA)
地图数据中心 (GeoHUB)
坐标拾取器
高德地图URI Web
高德地图URI APP
三维模型转换
微信小程序插件
地图Flutter插件
地图名片
高德地图小程序
客户管理
员工管理
送货提效
地图小程序API
解决方案
解决方案
提供各行业LBS解决方案
智能两轮车
NEW
合规精确的两轮车场景导航
手机银行
NEW
提供手机银行APP地图应用
智能派单
一站式精准智能派单解决方案
上门服务调度
提供上门业务调度解决方案
零售铺货
零售快消行业,渠道铺货解决方案
网格化营销
NEW
提供银行网格化营销场景应用
智慧交通
优化交通资源配置,赋能智慧交通系统
出行
提供网约车等出行场景解决方案
O2O
到店、到家等多种O2O业务解决方案
三农场景可视化
NEW
提供乡村振兴三农场景应用
社交
社交应用位置服务解决方案
运动
运动类应用解决方案
智能硬件
智能硬件LBS解决方案
智慧物流
针对物流行业提供解决方案
电商
电商物流行业解决方案
地址服务
综合地址服务,满足客户全景化需求
企业智图
一张图轻松管理企业数据
文档与支持
文档与支持
高德开放平台开发文档与服务支持
查看全部文档
API
Web基础服务API
Web高级服务API
物流服务API
猎鹰服务 API
JS API
JS API
数据可视化JS API
地图组件
URI API
地铁图 JS API
Android 平台
Android 地图SDK
Android 轻量版地图SDK
Android 定位SDK
Android 导航SDK
Android 猎鹰SDK
iOS 平台
iOS 地图SDK
iOS 轻量版地图SDK
iOS 定位SDK
iOS 导航SDK
iOS 猎鹰SDK
鸿蒙星河版平台
鸿蒙星河版地图SDK
HOT
鸿蒙星河版定位SDK
HOT
服务与支持
常见问题
创建工单
示例中心
合规中心
服务升级
服务升级
高德开放平台服务升级计划
服务升级计划
服务提升
提升配额
商用服务
GeoHUB自定义地图
GeoHUB数据中心
产品升级
高级能力
企业智图SaaS
云图市场
为什么选择高德
历史记录
热门推荐
Android定位
Android定位问题相关
浏览器定位
JS API提供Geolocation定位插件
逆地理编码
经纬度转换为详细结构化的地址
自定义地图
7大类44种地图元素可定制
认证开发商
商业授权相关问题
基础 API 文档
地理/逆地理编码
路径规划
路径规划 2.0
行政区域查询
交通事件
IP定位
静态地图
坐标转换
天气查询
轨迹纠偏
高级 API 文档
搜索POI
搜索POI 2.0
输入提示
智能硬件定位
交通路况查询
公交信息查询
高级路径规划
GeoHUB API文档
三方数据空间检索
实用工具
错误码说明
流量限制说明
天气对照表
游客仅显示地点经纬度小数点后两位。
>>前往登录
示例代码报错,请检查
message:
stack:
‹
›
搜索POI
##产品介绍##{#title:introduce}搜索服务API是一类简单的HTTP接口,提供多种查询POI信息的能力
源代码编辑器
<div class="md-container"><h2 data-anchor="introduce" id="introduce">产品介绍</h2><p>搜索服务API是一类简单的HTTP接口,提供多种查询POI信息的能力,其中包括关键字搜索、周边搜索、多边形搜索、ID查询四种筛选机制。</p><p>使用API前您需先<a href="https://lbs.amap.com/dev/key" class="" target="_blank">申请Key</a>,若无高德地图API账号需要先申请账号。</p><p><span class="red"><strong>注意:</strong></span>在此接口之中,您可以通过city&citylimit参数指定希望搜索的城市或区县。而city参数能够接收citycode和adcode,citycode仅能精确到城市,而adcode却能够精确到区县。</p><p>例如:北京,citycode:010,adcode:110000</p><p> 北京-海淀区,citycode:010,adcode:110108</p><p>故使用citycode仅能在北京范围内搜索,而adcode能够指定在海淀区搜索。</p><p><span class="red">综上所述,为了您查询的精确,我们强烈建议您使用adcode。</span></p><h2 data-anchor="scene" id="scene">适用场景</h2><p> </p><ul> <li>关键字搜索:通过用POI的关键字进行条件搜索,例如:肯德基、朝阳公园等;同时支持设置POI类型搜索,例如:银行</li> <li>周边搜索:在用户传入经纬度坐标点附近,在设定的范围内,按照关键字或POI类型搜索;</li> <li>多边形搜索:在多边形区域内进行搜索</li> <li>ID查询:通过POI ID,查询某个POI详情,建议可同输入提示API配合使用</li></ul><h2 data-anchor="limit" id="limit">使用限制</h2><p> 服务调用量的限制请点击<a href="https://lbs.amap.com/api/webservice/guide/tools/flowlevel" class="" target="_blank">这里</a>查阅。 </p><h2 data-anchor="instructions" id="instructions">使用说明</h2><p>第一步,申请”Web服务API”密钥(Key);</p><p>第二步,拼接HTTP请求URL,第一步申请的Key需作为必填参数一同发送;</p><p>第三步,接收HTTP请求返回的数据(JSON格式),解析数据。</p><p>如无特殊声明,接口的输入参数和输出数据编码全部统一为UTF-8。</p><h2 data-anchor="text" id="text">关键字搜索</h2><p>关键字搜索API服务地址:</p><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/place/text?parameters</p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em>代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul> <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2" style="white-space:nowrap;"><p>参数名</p></th><th><p>含义</p></th><th><p>规则说明</p></th><th><p>是否必须</p></th><th><p>缺省值</p></th></tr><tr><td colspan="2" style="white-space:nowrap;"><p>key</p></td><td><p>请求服务权限标识</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型KEY</a></p></td><td><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>keywords</p></td><td><p>查询关键字</p></td><td><p>规则: 只支持一个关键字 </p><p>若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。</p></td><td><p>必填</p><p>(keywords和types两者至少必选其一)</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>types</p></td><td><p>查询POI类型</p></td><td><p>可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写)</p><p>规则: 多个关键字用“|”分割</p><p><br></p><p>分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。</p><p>若指定了某个大类,则所属的中类、小类都会被显示。</p><p>例如:010000为汽车服务(大类)</p><p> 010100为加油站(中类)</p><p> 010101为中国石化(小类)</p><p> 010900为汽车租赁(中类)</p><p> 010901为汽车租赁还车(小类)</p><p>当指定010000,则010100等中类、010101等小类都会被包含,当指定010900,则010901等小类都会被包含。</p><p>下载<a href="https://lbs.amap.com/api/webservice/download" class="" target="_blank">POI分类编码和城市编码表 </a></p><p><br></p><p>若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 </p><p><strong>当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)</strong></p></td><td><p>必填</p><p>(keywords和types两者至少必选其一)</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>city</p></td><td><p>查询城市</p></td><td><p>可选值:城市中文、citycode、adcode</p><p>如:北京/010/110000</p><p>填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。</p><p>如:在深圳市搜天安门,返回北京天安门结果。</p></td><td><p>可选</p></td><td><p>无(全国范围内搜索)</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>citylimit</p></td><td><p>仅返回指定城市数据</p></td><td><p>可选值:true/false</p></td><td><p>可选</p></td><td><p>false</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>children</p></td><td><p>是否按照层级展示子POI数据</p></td><td><p>可选值:children=1</p><p>当为0的时候,子POI都会显示。</p><p>当为1的时候,子POI会归类到父POI之中。</p><p><br></p><p>在extensions=all 或者为空时生效</p></td><td><p>可选</p></td><td><p>0</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>offset</p></td><td><p>每页记录数据</p></td><td><p>强烈建议不超过25,若超过25可能造成访问报错</p></td><td><p>可选</p></td><td><p>20</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>page</p></td><td><p>当前页数</p></td><td><p>当前页数</p></td><td><p>可选</p></td><td><p>1</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>extensions</p></td><td><p>返回结果控制</p></td><td><p>此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。</p></td><td><p>可选</p></td><td><p>base</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>sig</p></td><td><p>数字签名</p></td><td><p><a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td><p>可选</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>callback</p></td><td><p>回调函数</p></td><td><p>callback值是用户定义的函数名称,此参数只在output=JSON时有效</p></td><td><p>可选</p></td><td><p>无</p></td></tr></tbody></table></div></div><ul> <li><strong>返回结果参数说明</strong></li></ul><p>关键字搜索的响应结果的格式由请求参数output指定。</p><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="4"><p>名称</p></th><th><p>含义</p></th><th><p>规则说明</p></th></tr><tr><td colspan="4" style="white-space:nowrap;"><p>status</p></td><td><p>结果状态值,值为0或1</p></td><td><p>0:请求失败;1:请求成功</p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>info</p></td><td><p>返回状态说明</p></td><td><p>status为0时,info返回错误原因,否则返回“OK”。详情参阅<a href="https://lbs.amap.com/api/webservice/info/" class="" target="_blank">info状态表</a></p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>count</p></td><td><p>搜索方案数目</p></td><td><p><br></p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>suggestion</p></td><td><p>城市建议列表</p></td><td><p>当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表;</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td colspan="3"><p>keywords</p></td><td><p>关键字</p></td><td><p><br></p></td></tr><tr><td rowspan="5" style="white-space:nowrap;"><p><br></p></td><td colspan="3"><p>cities</p></td><td><p>城市列表</p></td><td><p><br></p></td></tr><tr><td rowspan="4" style="white-space:nowrap;"><p><br></p></td><td colspan="2"><p>name</p></td><td><p>名称</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>num</p></td><td><p>该城市包含此关键字的个数</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>citycode</p></td><td><p>该城市的citycode</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>adcode</p></td><td><p>该城市的adcode</p></td><td><p><br></p></td></tr><tr><td colspan="4" style="white-space:nowrap;"><p>pois</p></td><td><p>搜索POI信息列表</p></td><td><p><br></p></td></tr><tr><td rowspan="45" style="white-space:nowrap;"><p><br></p></td><td colspan="3"><p>poi</p></td><td><p>POI信息</p></td><td><p><br></p></td></tr><tr><td rowspan="44" style="white-space:nowrap;"><p><br></p></td><td colspan="2"><p>id</p></td><td><p>唯一ID</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>parent</p></td><td><p>父POI的ID</p></td><td><p>当前POI如果有父POI,则返回父POI的ID。可能为空</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>name</p></td><td><p>名称</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>type</p></td><td><p>兴趣点类型</p></td><td><p>顺序为大类、中类、小类</p><p>例如:餐饮服务;中餐厅;特色/地方风味餐厅</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>typecode</p></td><td><p>兴趣点类型编码</p></td><td><p>例如:050118</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>biz_type</p></td><td><p>行业类型</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>address</p></td><td><p>地址</p></td><td><p>东四环中路189号百盛北门</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>location</p></td><td><p>经纬度</p></td><td><p>格式:X,Y</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>distance</p></td><td><p>离中心点距离</p></td><td><p>单位:米;仅在周边搜索的时候有值返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>tel</p></td><td><p>POI的电话</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>postcode</p></td><td><p>邮编</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>website</p></td><td><p>POI的网址</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>email</p></td><td><p>POI的电子邮箱</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>pcode</p></td><td><p>POI所在省份编码</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>pname</p></td><td><p>POI所在省份名称</p></td><td><p>若是直辖市的时候,此处直接显示市名,例如北京市</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>citycode</p></td><td><p>城市编码</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>cityname</p></td><td><p>城市名</p></td><td><p> 若是直辖市的时候,此处直接显示市名,例如北京市 </p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>adcode</p></td><td><p>区域编码</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>adname</p></td><td><p>区域名称</p></td><td><p>区县级别的返回,例如朝阳区</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>entr_location</p></td><td><p>POI的入口经纬度</p></td><td><p> extensions=all时返回,也可用作于POI的到达点;</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>exit_location</p></td><td><p>POI的出口经纬度</p></td><td><p>目前不会返回内容;</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>navi_poiid</p></td><td><p>POI导航id</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>gridcode</p></td><td><p>地理格ID</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>alias</p></td><td><p>别名</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>parking_type</p></td><td><p>停车场类型</p></td><td><p>仅在停车场类型POI的时候显示该字段</p><p>展示停车场类型,包括:地下、地面、路边</p><p> extensions=all的时候显示 </p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p> tag </p></td><td><p> 该POI的特色内容</p></td><td><p> 主要出现在美食类POI中,代表特色菜</p><p>例如“烤鱼,麻辣香锅,老干妈回锅肉”</p><p>extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>indoor_map</p></td><td><p>是否有室内地图标志</p></td><td><p>1,表示有室内相关数据</p><p>0,代表没有室内相关数据</p><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>indoor_data</p></td><td><p>室内地图相关数据</p></td><td><p>当indoor_map=0时,字段为空</p><p> extensions=all时返回 </p></td></tr><tr><td rowspan="3" style="white-space:nowrap;"><p><br></p></td><td><p>cpid</p></td><td><p>当前POI的父级POI</p></td><td><p>如果当前POI为建筑物类POI,则cpid为自身POI ID;如果当前POI为商铺类POI,则cpid为其所在建筑物的POI ID</p></td></tr><tr><td style="white-space:nowrap;"><p>floor</p></td><td><p>楼层索引</p></td><td><p>一般会用数字表示,例如8</p></td></tr><tr><td style="white-space:nowrap;"><p>truefloor</p></td><td><p>所在楼层</p></td><td><p>一般会带有字母,例如F8</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>groupbuy_num</p></td><td><p>团购数据</p></td><td><p>此字段逐渐废弃</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>business_area</p></td><td><p>所属商圈</p></td><td><p> extensions=all时返回</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>discount_num</p></td><td><p>优惠信息数目</p></td><td><p>此字段逐渐废弃 </p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>biz_ext</p></td><td><p>深度信息</p></td><td><p> extensions=all时返回</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>rating</p></td><td><p>评分</p></td><td><p>仅存在于餐饮、酒店、景点、影院类POI之下</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>cost</p></td><td><p>人均消费</p></td><td><p>仅存在于餐饮、酒店、景点、影院类POI之下 </p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>meal_ordering</p></td><td><p>是否可订餐</p></td><td><p>仅存在于餐饮相关POI之下(此字段逐渐废弃)</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>seat_ordering</p></td><td><p>是否可选座</p></td><td><p>仅存在于影院相关POI之下(此字段逐渐废弃) </p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>ticket_ordering </p></td><td><p>是否可订票</p></td><td><p>仅存在于景点相关POI之下(此字段逐渐废弃) </p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>hotel_ordering</p></td><td><p>是否可以订房</p></td><td><p>仅存在于酒店相关POI之下(此字段逐渐废弃) </p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>photos</p></td><td><p>照片相关信息</p></td><td><p>extensions=all时返回</p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p> title </p></td><td><p>图片介绍</p></td><td><p><br></p></td></tr><tr><td style="white-space:nowrap;"><p><br></p></td><td style="white-space:nowrap;"><p>url</p></td><td><p>具体链接</p></td><td><p><br></p></td></tr></tbody></table></div></div><pre><code>https://restapi.amap.com/v3/place/text?keywords=北京大学&city=beijing&offset=20&page=1&key=<用户的key>&extensions=all </code></pre> <div class="md-atomic"><div><!--component:9--></div></div><p><br></p><p>说明:keywords(北京大学)是需要查询的关键词,city()是查询的城市范围,offset(20)为每页返回的POI数量,page(1)为当前页数,extensions(all)为返回信息控制参数,key是用户请求数据的身份标识。</p><h2 data-anchor="around" id="around">周边搜索</h2><p>周边搜索API服务地址:</p><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/place/around?parameters </p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em>代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul> <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2" style="white-space:nowrap;"><p>参数名</p></th><th><p>含义</p></th><th><p>规则说明</p></th><th style="white-space:nowrap;"><p>是否必须</p></th><th><p>缺省值</p></th></tr><tr><td colspan="2" style="white-space:nowrap;"><p>key</p></td><td><p>请求服务权限标识</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型KEY</a></p></td><td style="white-space:nowrap;"><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>location</p></td><td><p>中心点坐标</p></td><td><p>规则: 经度和纬度用","分割,经度在前,纬度在后,经纬度小数点后不得超过6位</p></td><td style="white-space:nowrap;"><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>keywords</p></td><td><p>查询关键字</p></td><td><p>规则: 只支持一个关键字 </p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>types</p></td><td><p>查询POI类型</p></td><td><p>多个类型用“|”分割;</p><p>可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) </p><p>分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。</p><p>若指定了某个大类,则所属的中类、小类都会被显示。</p><p>例如:010000为汽车服务(大类)</p><p> 010100为加油站(中类)</p><p> 010101为中国石化(小类)</p><p> 010900为汽车租赁(中类)</p><p> 010901为汽车租赁还车(小类)</p><p>当指定010000,则010100等中类、010101等小类都会被包含。</p><p>当指定010900,则010901等小类都会被包含</p><p><a href="https://lbs.amap.com/api/webservice/download" class="" target="_blank">下载POI分类编码和城市编码表</a> </p><p><br></p><p><strong>当keywords和types均为空的时候,默认指定types为050000(餐饮服务)、070000(生活服务)、120000(商务住宅)</strong></p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>city</p></td><td><p>查询城市</p></td><td><p>可选值:城市中文、中文全拼、citycode、adcode</p><p>如:北京/beijing/010/110000</p><p>当用户指定的经纬度和city出现冲突,若范围内有用户指定city的数据,则返回相关数据,否则返回为空。</p><p>如:经纬度指定石家庄,而city却指定天津,若搜索范围内有天津的数据则返回相关数据,否则返回为空。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>无(全国范围内搜索)</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>radius</p></td><td><p>查询半径</p></td><td><p>取值范围:0-50000。规则:大于50000按默认值,单位:米</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>5000</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>sortrule</p></td><td><p>排序规则</p></td><td><p>规定返回结果的排序规则。</p><p>按距离排序:distance;综合排序:weight</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>distance</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>offset</p></td><td><p>每页记录数据</p></td><td><p>强烈建议不超过25,若超过25可能造成访问报错</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>20</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>page</p></td><td><p>当前页数</p></td><td><p>当前页数</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>1</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>extensions</p></td><td><p>返回结果控制</p></td><td><p>此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>base</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>sig</p></td><td><p>数字签名</p></td><td><p><a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>callback</p></td><td><p>回调函数</p></td><td><p>callback值是用户定义的函数名称,此参数只在output=JSON时有效</p></td><td style="white-space:nowrap;"><p>可选</p></td><td><p>无</p></td></tr></tbody></table></div></div><ul> <li><strong>返回结果参数说明</strong></li></ul><p>周边搜索搜索的响应结果的格式由请求参数output指定,返回结果见<a href="#text" class="" target="">关键字搜索</a></p><p> </p><ul> <li><strong>服务示例</strong></li></ul><pre><code>https://restapi.amap.com/v3/place/around?key=<用户的key>&location=116.473168,39.993015&radius=10000&types=011100 </code></pre><div class="md-atomic"><div><!--component:10--></div></div><p>说明:location(116.481488,39.990464)是需要查询的中心点,types(050301)为搜索的返回POI数据类型,extensions(all)为返回的数据内容,key是用户请求数据的身份标识。</p><h2 data-anchor="polygon" id="polygon">多边形搜索</h2><p>多边形搜索API服务地址:</p><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/place/polygon?parameters </p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em>代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul> <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2" style="white-space:nowrap;"><p>参数名</p></th><th><p>含义</p></th><th><p>规则说明</p></th><th style="white-space:nowrap;"><p>是否必须</p></th><th style="white-space:nowrap;"><p>缺省值</p></th></tr><tr><td colspan="2" style="white-space:nowrap;"><p>key</p></td><td><p>请求服务权限标识</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型KEY</a></p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>polygon</p></td><td><p>经纬度坐标对</p></td><td><p>规则:经度和纬度用","分割,经度在前,纬度在后,坐标对用"|"分割。经纬度小数点后不得超过6位。 多边形为矩形时,可传入左上右下两顶点坐标对;其他情况下首尾坐标对需相同。</p></td><td style="white-space:nowrap;"><p>必填</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>keywords</p></td><td><p>查询关键字</p></td><td><p>规则: 只支持一个关键字 </p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>types</p></td><td><p>查询POI类型</p></td><td><p>多个类型用“|”分割;</p><p>可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) </p><p>分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。</p><p>若指定了某个大类,则所属的中类、小类都会被显示。</p><p>例如:010000为汽车服务(大类)</p><p> 010100为加油站(中类)</p><p> 010101为中国石化(小类)</p><p> 010900为汽车租赁(中类)</p><p> 010901为汽车租赁还车(小类)</p><p>当指定010000,则010100等中类、010101等小类都会被包含。</p><p>当指定010900,则010901等小类都会被包含</p><p><a href="https://lbs.amap.com/api/webservice/download" class="" target="_blank">下载POI分类编码和城市编码表 </a> </p><p><br></p><p><strong>当keywords和types为空的时候,</strong> <strong>我们会默认指定types为120000(商务住宅)&150000(交通设施服务)</strong> </p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p><br></p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>offset</p></td><td><p>每页记录数据</p></td><td><p>强烈建议不超过25,若超过25可能造成访问报错</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>20</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>page</p></td><td><p>当前页数</p></td><td><p>当前页数</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>1</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>extensions</p></td><td><p>返回结果控制</p></td><td><p>此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>base</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>sig</p></td><td><p>数字签名</p></td><td><p><a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>callback</p></td><td><p>回调函数</p></td><td><p>callback值是用户定义的函数名称,此参数只在output=JSON时有效</p></td><td style="white-space:nowrap;"><p>可选</p></td><td style="white-space:nowrap;"><p>无</p></td></tr></tbody></table></div></div><ul> <li><strong>返回结果参数说明</strong></li></ul><p>多边形搜索搜索的响应结果的格式由请求参数output指定,返回结果见<a href="#text" class="" target="">关键字搜索</a></p><p> </p><ul> <li><strong>服务示例</strong></li></ul><pre><code>https://restapi.amap.com/v3/place/polygon?polygon=116.460988,40.006919|116.48231,40.007381|116.47516,39.99713|116.472596,39.985227|116.45669,39.984989|116.460988,40.006919&keywords=kfc&key=<用户的key></code></pre> <div class="md-atomic"><div><!--component:11--></div></div><p><br></p><p>说明:polygon(116.460988,40.006919;116.48231,40.007381;116.47516,39.99713;116.472596,39.985227;116.45669,39.984989;116.460988,40.006919)是查询的区域范围,keywords(kfc)为查询的关键字,extensions(all)为返回的数据内容,key是用户请求数据的身份标识。</p><h2 data-anchor="id" id="id">ID查询</h2><p>ID查询搜索API服务地址:</p><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v3/place/detail?parameters</p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><em>parameters</em> 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul> <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2"><p>参数名</p></th><th><p>含义</p></th><th><p>规则说明</p></th><th><p>是否必须</p></th><th><p>缺省值</p></th></tr><tr><td colspan="2"><p>key</p></td><td><p>请求服务权限标识</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型KEY</a></p></td><td><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>id</p></td><td><p>AOI唯一标识</p></td><td><p>最多可以传入1个id,传入目标区域的poiid即可</p></td><td><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>sig</p></td><td><p>数字签名</p></td><td><p><a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td><p>可选</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>callback</p></td><td><p>回调函数</p></td><td><p>callback值是用户定义的函数名称,此参数只在output=JSON时有效</p></td><td><p>可选</p></td><td><p>无</p></td></tr></tbody></table></div></div><ul> <li><strong>返回结果参数说明</strong></li></ul><p>ID查询搜索的响应结果的格式由请求参数output指定,返回结果见<a href="#text" class="" target="">关键字搜索</a></p><p> </p><ul> <li><strong>服务示例</strong></li></ul><pre><code>https://restapi.amap.com/v3/place/detail?id=B0FFFAB6J2&key=<用户的key></code></pre><div class="md-atomic"><div><!--component:12--></div></div><p>说明:ID(B0FFFAB6J2)是查询POI ID,extensions(all)为返回的数据内容,key是用户请求数据的身份标识。</p><h2 data-anchor="aoi" id="aoi">AOI边界查询</h2><p><span class="red">该服务属于高德开放平台高阶服务,您在正式使用前需要通过工单等形式联系我们开通权限。</span></p><p>AOI边界查询API服务地址:</p><div class="md-atomic"><div class="table-container" style="width:70%;"><table class="md-table common " data-meta="%7B%22width%22%3A%2270%25%22%2C%22type%22%3A%22common%22%7D"><tbody><tr><td style="white-space:nowrap;"><p>URL</p></td><td><p>https://restapi.amap.com/v5/aoi/polyline?parameters</p></td></tr><tr><td style="white-space:nowrap;"><p>请求方式</p></td><td><p>GET</p></td></tr></tbody></table></div></div><p><br></p><p><em>parameters</em> 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。</p><ul> <li><strong>请求参数</strong></li></ul><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2"><p>参数名</p></th><th><p>含义</p></th><th><p>规则说明</p></th><th><p>是否必须</p></th><th><p>缺省值</p></th></tr><tr><td colspan="2"><p>key</p></td><td><p>请求服务权限标识</p></td><td><p>用户在高德地图官网<a href="https://lbs.amap.com/dev/" class="" target="_blank">申请Web服务API类型KEY</a></p></td><td><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>id</p></td><td><p>AOI唯一标识</p></td><td><p>最多可以传入1个id,传入目标区域的poiid即可</p></td><td><p>必填</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>sig</p></td><td><p>数字签名</p></td><td><p><a href="https://lbs.amap.com/faq/account/key/72" class="" target="_blank">数字签名获取和使用方法</a></p></td><td><p>可选</p></td><td><p>无</p></td></tr><tr><td colspan="2"><p>callback</p></td><td><p>回调函数</p></td><td><p>callback值是用户定义的函数名称,此参数只在output=JSON时有效</p></td><td><p>可选</p></td><td><p>无</p></td></tr></tbody></table></div></div><ul> <li><strong>返回结果参数说明</strong></li></ul><p>注意:返回结果参数仅支持json。</p><div class="md-atomic"><div class="table-container" style="width:100%;"><table class="md-table " data-meta="%7B%22width%22%3A%22100%25%22%7D"><tbody><tr><th colspan="2" style="white-space:nowrap;"><p>参数名</p></th><th><p>含义</p></th></tr><tr><td colspan="2" style="white-space:nowrap;"><p>status</p></td><td><p>本次API访问状态,如果成功返回0,如果失败返回其他数字。</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>info</p></td><td><p>访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见<a href="https://lbs.amap.com/api/webservice/guide/tools/info" class="" target="_blank">错误码说明</a>。</p></td></tr><tr><td colspan="2" style="white-space:nowrap;"><p>aois</p></td><td><p>aoi返回的详细数据字段</p></td></tr><tr><td rowspan="13" style="white-space:nowrap;"><p><br></p></td><td><p>name</p></td><td><p>aoi名称,同poi</p></td></tr><tr><td><p>id</p></td><td><p>aoi唯一标识</p></td></tr><tr><td><p>location</p></td><td><p>aoi中心点经纬度</p></td></tr><tr><td><p>polyline</p></td><td><p>边界经纬度坐标串,以“_”分隔。</p></td></tr><tr><td><p>type</p></td><td><p>aoi所属分类</p></td></tr><tr><td><p>typecode</p></td><td><p>aoi分类编码</p></td></tr><tr><td><p>pname</p></td><td><p>aoi所属省份</p></td></tr><tr><td><p>cityname</p></td><td><p>aoi所属城市</p></td></tr><tr><td><p>adname</p></td><td><p>aoi所属区域</p></td></tr><tr><td><p>address</p></td><td><p>aoi详细地址</p></td></tr><tr><td><p>pcode</p></td><td><p>aoi所属省份编码</p></td></tr><tr><td><p>citycode</p></td><td><p>aoi所属城市编码</p></td></tr><tr><td><p>adcode</p></td><td><p>aoi所属区域编码</p></td></tr></tbody></table></div></div><p>说明:</p><p>AOI是指具有面状、区域状特点的POI,包括但不限于工业园区、学校校区、商圈、住宅小区、景区、火车站、机场等类型的POI。开发者可以通过结合此数据以及猎鹰轨迹服务中的<a href="https://lbs.amap.com/api/track/lieying-kaifa/api/track_fence#t3" class="" target="">多边形围栏</a>等能力,基于真实地理区域数据对业务进行管理。北京</p></div>
控制台
清空
返回顶部
示例中心
常见问题
智能客服
公众号
二维码