搜索

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

雷达评级

A

用户规模

-

产品上线

-

关键字搜索

接口地址
http://character.market.alicloudapi.com/v3/place/text
响应格式
application/json
请求方法
GET
请求参数 (Query)
参数类型必须描述
keystring
string
请求 AccessKey, 请在控制台中查看
buildingstring
string
建筑物的POI编号 传入建筑物POI编号之后,则只在该建筑物之内进行搜索
callbackstring
string
回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效
childrenstring
string
是否按照层级展示子POI数据 可选值:children=1
citystring
string
查询城市 可选值:城市中文、中文全拼、citycode、adcode 如:北京/beijing/010/110000 填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。 如:在深圳市搜天安门,返回北京天安门结果。
citylimitstring
string
仅返回指定城市数据 可选值:true/false
extensionsstring
string
返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。
floorstring
string
搜索楼层 若传入 建筑物的POI编号 + 楼层 ,则返回该建筑物内当前楼层的关键字搜索结果 若只传入楼层,则返回参数不完全的提示 若传入建筑物的POI编号 + 楼层,该楼层没有对应的搜索结果,则会返回建筑物之内的内容。
keywordsstring
string
查询关键字 规则: 多个关键字用“|”分割 若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。
offsetstring
string
每页记录数据 强烈建议不超过25,若超过25可能造成访问报错
outputstring
string
返回数据格式类型 可选值:JSON,XML
pagestring
string
当前页数 最大翻页数100
typesstring
string
查询POI类型 多个类型用“|”分割; 可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。 若指定了某个大类,则所属的中类、小类都会被显示。 例如:010000为汽车服务(大类) 010100为加油站(中类) 010101为中国石化(小类) 010900为汽车租赁(中类) 010901为汽车租赁还车(小类) 当指定010000,则010100等中类、010101等小类都会被包含。 当指定010900,则010901等小类都会被包含 下载POI分类编码和城市编码表(http://lbs.amap.com/api/webservice/guide/api/search#text) 若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)

产品亮点

包括关键字搜索、周边搜索、多边形搜索、ID查询四种筛选机制。

产品说明

  • 关键字搜索:通过用POI的关键字进行条件搜索,例如:肯德基、朝阳公园等;同时支持设置POI类型搜索,例如:银行
  • 周边搜索:在用户传入经纬度坐标点附近,在设定的范围内,按照关键字或POI类型搜索;
  • 多边形搜索:在多边形区域内进行搜索

  • ID查询:通过POI ID,查询某个POI详情,建议可同输入提示API配合使用

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

例如:北京,citycode:010,adcode:110000

           北京-海淀区,citycode:010,adcode:110108

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

产品参数

交付方式API

售后支持范围

如果使用过程中遇到问题,您可以到高德开放平台提交工单(lbs.amap.com)