开发 Web服务 API 开发指南 基础 API 文档

搜索POI 最后更新时间: 2023年07月13日

产品介绍

搜索服务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。

适用场景

 

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

使用限制

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

使用说明

第一步,申请”Web服务API”密钥(Key);

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

第三步,接收HTTP请求返回的数据(JSON格式),解析数据。

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

关键字搜索

关键字搜索API服务地址:

URL

https://restapi.amap.com/v3/place/text?parameters

请求方式

GET

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

keywords

查询关键字

规则: 多个关键字用“|”分割

若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。

必填

(keywords和types两者至少必选其一)

types

查询POI类型

可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写)

规则: 多个关键字用“|”分割


分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。

若指定了某个大类,则所属的中类、小类都会被显示。

例如:010000为汽车服务(大类)

             010100为加油站(中类)

                010101为中国石化(小类)

             010900为汽车租赁(中类)

                010901为汽车租赁还车(小类)

当指定010000,则010100等中类、010101等小类都会被包含,当指定010900,则010901等小类都会被包含。

下载POI分类编码和城市编码表         


若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 

当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)

必填

(keywords和types两者至少必选其一)

city

查询城市

可选值:城市中文、citycode、adcode

如:北京/010/110000

填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。

如:在深圳市搜天安门,返回北京天安门结果。

可选

无(全国范围内搜索)

citylimit

仅返回指定城市数据

可选值:true/false

可选

false

children

是否按照层级展示子POI数据

可选值:children=1

当为0的时候,子POI都会显示。

当为1的时候,子POI会归类到父POI之中。


仅在extensions=all的时候生效

可选

0

offset

每页记录数据

强烈建议不超过25,若超过25可能造成访问报错

可选

20

page

当前页数

当前页数

可选

1

extensions

返回结果控制

此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。

可选

base

sig

数字签名

数字签名获取和使用方法

可选

callback

回调函数

callback值是用户定义的函数名称,此参数只在output=JSON时有效

可选

  • 返回结果参数说明

关键字搜索的响应结果的格式由请求参数output指定。

名称

含义

规则说明

status

结果状态值,值为0或1

0:请求失败;1:请求成功

info

返回状态说明

status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表

count

搜索方案数目


suggestion

城市建议列表

当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表;


keywords

关键字



cities

城市列表



name

名称


num

该城市包含此关键字的个数


citycode

该城市的citycode


adcode

该城市的adcode


pois

搜索POI信息列表



poi

POI信息



id

唯一ID


parent

父POI的ID

当前POI如果有父POI,则返回父POI的ID。可能为空

name

名称


type

兴趣点类型

顺序为大类、中类、小类

例如:餐饮服务;中餐厅;特色/地方风味餐厅

typecode

兴趣点类型编码

例如:050118

biz_type

行业类型


address

地址

东四环中路189号百盛北门

location

经纬度

格式:X,Y

distance

离中心点距离

单位:米;仅在周边搜索的时候有值返回

tel

POI的电话


postcode

邮编

 extensions=all时返回

website

POI的网址

 extensions=all时返回

email

POI的电子邮箱

 extensions=all时返回

pcode

POI所在省份编码

 extensions=all时返回

pname

POI所在省份名称

若是直辖市的时候,此处直接显示市名,例如北京市

citycode

城市编码

 extensions=all时返回

cityname

城市名

 若是直辖市的时候,此处直接显示市名,例如北京市 

adcode

区域编码

 extensions=all时返回

adname

区域名称

区县级别的返回,例如朝阳区

entr_location

POI的入口经纬度

 extensions=all时返回,也可用作于POI的到达点;

exit_location

POI的出口经纬度

目前不会返回内容;

navi_poiid

POI导航id

 extensions=all时返回

gridcode

地理格ID

 extensions=all时返回

alias

别名

 extensions=all时返回

parking_type

停车场类型

仅在停车场类型POI的时候显示该字段

展示停车场类型,包括:地下、地面、路边

 extensions=all的时候显示 

 tag 

 该POI的特色内容

 主要出现在美食类POI中,代表特色菜

例如“烤鱼,麻辣香锅,老干妈回锅肉”

extensions=all时返回

indoor_map

是否有室内地图标志

1,表示有室内相关数据

0,代表没有室内相关数据

 extensions=all时返回

indoor_data

室内地图相关数据

当indoor_map=0时,字段为空

 extensions=all时返回 


cpid

当前POI的父级POI

如果当前POI为建筑物类POI,则cpid为自身POI ID;如果当前POI为商铺类POI,则cpid为其所在建筑物的POI ID

floor

楼层索引

一般会用数字表示,例如8

truefloor

所在楼层

一般会带有字母,例如F8

groupbuy_num

团购数据

此字段逐渐废弃

business_area

所属商圈

 extensions=all时返回

discount_num

优惠信息数目

此字段逐渐废弃 

biz_ext

深度信息

 extensions=all时返回


rating

评分

仅存在于餐饮、酒店、景点、影院类POI之下


cost

人均消费

仅存在于餐饮、酒店、景点、影院类POI之下 


meal_ordering

是否可订餐

仅存在于餐饮相关POI之下(此字段逐渐废弃)


seat_ordering

是否可选座

仅存在于影院相关POI之下(此字段逐渐废弃) 


ticket_ordering    

是否可订票

仅存在于景点相关POI之下(此字段逐渐废弃) 


hotel_ordering

是否可以订房

仅存在于酒店相关POI之下(此字段逐渐废弃) 

photos

照片相关信息

extensions=all时返回


titile

图片介绍



url

具体链接


https://restapi.amap.com/v3/place/text?keywords=北京大学&city=beijing&offset=20&page=1&key=<用户的key>&extensions=all 

参数

备注

必选

keywords

查询关键词

types

查询POI类型

city

城市名,可填:城市中文、中文全拼、citycode或adcode

children

按照层级展示子POI数据

offset

每页记录数据

page

当前页数

extensions

返回结果控制


说明:keywords(北京大学)是需要查询的关键词,city()是查询的城市范围,offset(20)为每页返回的POI数量,page(1)为当前页数,extensions(all)为返回信息控制参数,key是用户请求数据的身份标识。

周边搜索

周边搜索API服务地址:

URL

https://restapi.amap.com/v3/place/around?parameters 

请求方式

GET

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

location

中心点坐标

规则: 经度和纬度用","分割,经度在前,纬度在后,经纬度小数点后不得超过6位

必填

keywords

查询关键字

规则: 多个关键字用“|”分割

可选

types

查询POI类型

多个类型用“|”分割;

可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) 

分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。

若指定了某个大类,则所属的中类、小类都会被显示。

例如:010000为汽车服务(大类)

             010100为加油站(中类)

                010101为中国石化(小类)

             010900为汽车租赁(中类)

                010901为汽车租赁还车(小类)

当指定010000,则010100等中类、010101等小类都会被包含。

当指定010900,则010901等小类都会被包含

下载POI分类编码和城市编码表         


当keywords和types均为空的时候,默认指定types为050000(餐饮服务)、070000(生活服务)、120000(商务住宅)

可选


city

查询城市

可选值:城市中文、中文全拼、citycode、adcode

如:北京/beijing/010/110000

当用户指定的经纬度和city出现冲突,若范围内有用户指定city的数据,则返回相关数据,否则返回为空。

如:经纬度指定石家庄,而city却指定天津,若搜索范围内有天津的数据则返回相关数据,否则返回为空。

可选

无(全国范围内搜索)

radius

查询半径

取值范围:0-50000。规则:大于50000按默认值,单位:米

可选

5000

sortrule

排序规则

规定返回结果的排序规则。

按距离排序:distance;综合排序:weight

可选

distance

offset

每页记录数据

强烈建议不超过25,若超过25可能造成访问报错

可选

20

page

当前页数

当前页数

可选

1

extensions

返回结果控制

此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。

可选

base

sig

数字签名

数字签名获取和使用方法

可选

callback

回调函数

callback值是用户定义的函数名称,此参数只在output=JSON时有效

可选

  • 返回结果参数说明

周边搜索搜索的响应结果的格式由请求参数output指定,返回结果见关键字搜索

 

  • 服务示例
https://restapi.amap.com/v3/place/around?key=<用户的key>&location=116.473168,39.993015&radius=10000&types=011100  

参数

备注

必选

location

中心点坐标

keywords

查询关键词

types

查询POI类型

radius

查询半径

offset

每页记录数据

page

当前页数

extensions

返回结果控制

说明:location(116.481488,39.990464)是需要查询的中心点,types(050301)为搜索的返回POI数据类型,extensions(all)为返回的数据内容,key是用户请求数据的身份标识。

多边形搜索

多边形搜索API服务地址:

URL

https://restapi.amap.com/v3/place/polygon?parameters 

请求方式

GET

parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

polygon

经纬度坐标对

规则:经度和纬度用","分割,经度在前,纬度在后,坐标对用"|"分割。经纬度小数点后不得超过6位。         多边形为矩形时,可传入左上右下两顶点坐标对;其他情况下首尾坐标对需相同。

必填

keywords

查询关键字

规则: 多个关键字用“|”分割

可选

types

查询POI类型

多个类型用“|”分割;

可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) 

分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。

若指定了某个大类,则所属的中类、小类都会被显示。

例如:010000为汽车服务(大类)

             010100为加油站(中类)

                010101为中国石化(小类)

             010900为汽车租赁(中类)

                010901为汽车租赁还车(小类)

当指定010000,则010100等中类、010101等小类都会被包含。

当指定010900,则010901等小类都会被包含

下载POI分类编码和城市编码表   


当keywords和types为空的时候, 我们会默认指定types为120000(商务住宅)&150000(交通设施服务) 

可选


offset

每页记录数据

强烈建议不超过25,若超过25可能造成访问报错

可选

20

page

当前页数

当前页数

可选

1

extensions

返回结果控制

此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。

可选

base

sig

数字签名

数字签名获取和使用方法

可选

callback

回调函数

callback值是用户定义的函数名称,此参数只在output=JSON时有效

可选

  • 返回结果参数说明

多边形搜索搜索的响应结果的格式由请求参数output指定,返回结果见关键字搜索

 

  • 服务示例
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>

参数

备注

必选

polygon

经纬度坐标对,矩形时可传入左上右下两顶点坐标对;其他情况首尾坐标对需相同。

keywords

查询关键词

types

查询POI类型

offset

每页记录数据

page

当前页数

extensions

返回结果控制


说明: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是用户请求数据的身份标识。

ID查询

ID查询搜索API服务地址:

URL

https://restapi.amap.com/v3/place/detail?parameters

请求方式

GET

parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

id

AOI唯一标识

最多可以传入1个id,传入目标区域的poiid即可

必填

sig

数字签名

数字签名获取和使用方法

可选

callback

回调函数

callback值是用户定义的函数名称,此参数只在output=JSON时有效

可选

  • 返回结果参数说明

ID查询搜索的响应结果的格式由请求参数output指定,返回结果见关键字搜索

 

  • 服务示例
https://restapi.amap.com/v3/place/detail?id=B0FFFAB6J2&key=<用户的key>

参数

备注

必选

id

兴趣点ID

说明:ID(B0FFFAB6J2)是查询POI ID,extensions(all)为返回的数据内容,key是用户请求数据的身份标识。

AOI边界查询

该服务属于高德开放平台高阶服务,您在正式使用前需要通过工单等形式联系我们开通权限。

AOI边界查询API服务地址:

URL

https://restapi.amap.com/v5/aoi/polyline?parameters

请求方式

GET


parameters 代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

id

AOI唯一标识

最多可以传入1个id,传入目标区域的poiid即可

必填

sig

数字签名

数字签名获取和使用方法

可选

callback

回调函数

callback值是用户定义的函数名称,此参数只在output=JSON时有效

可选

  • 返回结果参数说明

注意:返回结果参数仅支持json。

参数名

含义

status

本次API访问状态,如果成功返回0,如果失败返回其他数字。

info

访问状态值的说明,如果成功返回"ok",失败返回错误原因,具体见错误码说明

aois

aoi返回的详细数据字段


name

aoi名称,同poi

id

aoi唯一标识

location

aoi中心点经纬度

polyline

边界经纬度坐标串,以“_”分隔。

type

aoi所属分类

typecode

aoi分类编码

pname

aoi所属省份

cityname

aoi所属城市

adname

aoi所属区域

address

aoi详细地址

pcode

aoi所属省份编码

citycode

aoi所属城市编码

adcode

aoi所属区域编码

说明:

AOI是指具有面状、区域状特点的POI,包括但不限于工业园区、学校校区、商圈、住宅小区、景区、火车站、机场等类型的POI。开发者可以通过结合此数据以及猎鹰轨迹服务中的多边形围栏等能力,基于真实地理区域数据对业务进行管理。北京

返回顶部 示例中心 常见问题 智能客服 公众号
二维码