高德地图 API
  1. 搜索POI
高德地图 API
  • 概述
  • 入门指南
  • 开发指南
    • 获取Key
    • 错误码说明
    • 流量限制说明
    • 天气对照表
    • 更新日志
    • 相关下载
    • 路径规划
      • 概述
      • 步行路径规划
      • 公交路径规划
      • 骑行路径规划
      • 驾车路径规划
      • 未来路径规划
      • 距离测量
    • 路径规划2.0
      • 概述
      • 驾车路线规划
      • 步行路线规划
      • 骑行路线规划
      • 电动车路线规划
      • 公交路线规划
    • 行政区域查询
      • 概述
      • 行政区域查询
    • 地理/逆地理编码
      • 地理编码
      • 逆地理编码
    • 搜索POI
      • 概述
      • 关键字搜索
        GET
      • 周边搜索
        GET
      • 多边形搜索
        GET
      • ID查询
        GET
      • AOI边界查询
        GET
    • 搜索POI 2.0
      • 概述
      • 关键字搜索
      • 周边搜索
      • 多边形区域搜索
      • ID搜索
    • 交通事件
      • 概述
      • 交通事件查询
    • IP定位
      • 概述
      • IP定位
    • 静态地图
      • 概述
      • 请求参数及用法
    • 坐标转换
      • 概述
      • 坐标转换
    • 天气查询
      • 概述
      • 天气查询
    • 输入提示
      • 概述
      • 输入提示
    • 交通态势
      • 概述
      • 矩形区域交通态势
      • 圆形区域交通态势
      • 指定线路交通态势
    • 轨迹纠偏
      • 概述
      • 轨迹纠偏
    • 三方数据空间检索接口
      • 概述
      • 关键字搜索
      • 多边形搜索
      • 周边搜索
      • 属性筛选
  1. 搜索POI

关键字搜索

GET
/v3/place/text
返回结果参数说明
关键字搜索的响应结果的格式由请求参数output指定。
说明:keywords(北京大学)是需要查询的关键词,city()是查询的城市范围,offset(20)为每页返回的POI数量,page(1)为当前页数,extensions(all)为返回信息控制参数,key是用户请求数据的身份标识。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/place/text?keywords=&types=&Key=' \
--header 'Content-Type: application/json' \
--data-raw '{}'
响应示例响应示例
{
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "count": "899",
    "suggestion": {
        "keywords": [],
        "cities": []
    },
    "pois": [
        {
            "id": "B000A816R6",
            "parent": [],
            "childtype": [],
            "name": "北京大学",
            "tag": [],
            "type": "科教文化服务;学校;高等院校",
            "typecode": "141201",
            "biz_type": [],
            "address": "颐和园路5号",
            "location": "116.310905,39.992806",
            "tel": [],
            "postcode": [],
            "website": [],
            "email": [],
            "pcode": "110000",
            "pname": "北京市",
            "citycode": "010",
            "cityname": "北京市",
            "adcode": "110108",
            "adname": "海淀区",
            "importance": [],
            "shopid": [],
            "shopinfo": "0",
            "poiweight": [],
            "gridcode": "5916729402",
            "distance": [],
            "navi_poiid": "J50F001019_500002",
            "entr_location": "116.315761,39.990097",
            "business_area": "西苑",
            "exit_location": [],
            "match": "0",
            "recommend": "0",
            "timestamp": "2022-11-30 22:47:28",
            "alias": "PKU|北京大学燕园校区|北大",
            "indoor_map": "0",
            "indoor_data": {
                "cpid": [],
                "floor": [],
                "truefloor": [],
                "cmsid": []
            },
            "groupbuy_num": "0",
            "discount_num": "0",
            "biz_ext": {
                "rating": [],
                "cost": []
            },
            "event": [],
            "children": [
                {
                    "id": " B000AA1D81 ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.310089,39.996380",
                    "address": " 颐和园路5号北京大学镜春园78号院附近 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B000A8ZJ7U ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.305864,39.989238",
                    "address": " 颐和园路5号北京大学 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B000A8ZJ77 ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.310102,39.989826",
                    "address": " 中关村北大街151号燕园大厦901室附近 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B000A87EOB ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.313309,39.993128",
                    "address": " 颐和园路5号北京大学 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B000A8ZJ2V ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.314190,39.993105",
                    "address": " 北京大学东门地铁站A西北口步行130米 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B0FFFAIHQH ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.314905,39.997462",
                    "address": " 颐和园路5号北京大学政府管理学院附近 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B0FFFAGZOC ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.314974,39.992157",
                    "address": " 颐和园路5北京大学(北京大学东门地铁站B东北口步行140米) ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B0FFFDCQRU ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.309928,39.989834",
                    "address": " 颐和园路5号北京大学 ",
                    "distance": " 0 ",
                    "subtype": "停车场",
                    "typecode": " 150904 "
                },
                {
                    "id": " B0FFFDCFG9 ",
                    "name": " 北京大学停车场 ",
                    "sname": " 停车场 ",
                    "location": "116.312901,39.997782",
                  

请求参数

Query 参数
keywords
string 
必需
查询关键字 规则: 多个关键字用“|”分割 若不指定city,并且搜索的为泛词(例如“美食”)的情况下,返回的内容为城市列表以及此城市内有多少结果符合要求。
types
string 
必需
查询POI类型 可选值:分类代码 或 汉字(若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。 若指定了某个大类,则所属的中类、小类都会被显示。 例如:010000为汽车服务(大类) ​ 010100为加油站(中类) ​ 010101为中国石化(小类) ​ 010900为汽车租赁(中类) ​ 010901为汽车租赁还车(小类) 当指定010000,则010100等中类、010101等小类都会被包含,当指定010900,则010901等小类都会被包含。 下载POI分类编码和城市编码表 若不指定city,返回的内容为城市列表以及此城市内有多少结果符合要求。 当您的keywords和types都是空时,默认指定types为120000(商务住宅)&150000(交通设施服务)
city
string 
可选
查询城市 可选值:城市中文、中文全拼、citycode、adcode 如:北京/beijing/010/110000 填入此参数后,会尽量优先返回此城市数据,但是不一定仅局限此城市结果,若仅需要某个城市数据请调用citylimit参数。 如:在深圳市搜天安门,返回北京天安门结果。
示例值:
北京
citylimit
string 
可选
仅返回指定城市数据 可选值:true/false
children
string 
可选
是否按照层级展示子POI数据 可选值:children=1 当为0的时候,子POI都会显示。 当为1的时候,子POI会归类到父POI之中。 仅在extensions=all的时候生效
示例值:
1
offset
string 
可选
每页记录数据 强烈建议不超过25,若超过25可能造成访问报错
示例值:
20
page
string 
可选
当前页数 最大翻页数100
示例值:
1
extensions
string 
可选
返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。
示例值:
all
sig
string 
可选
数字签名获取和使用方法
output
string 
可选
返回数据格式类型 可选值:JSON,XML
示例值:
JSON
callback
string 
可选
回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效
parameters
string 
可选
Key
string 
必需
用户在高德地图官网申请Web服务API类型Key
默认值:
{{Key}}
Body 参数application/json
object {0}
示例

返回响应

🟢200成功
application/json
Body
status
string 
结果状态值,值为0或1
必需
0:请求失败;1:请求成功
info
string 
返回状态说明
必需
status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表
infocode
string 
必需
count
string 
搜索方案数目
必需
suggestion
object 
城市建议列表
必需
当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表;
keywords
array[string]
关键字
必需
cities
array [object {4}] 
城市列表
必需
pois
array [object {43}] 
搜索POI信息列表
必需
id
string 
唯一ID
必需
parent
array | string 
父POI的ID
必需
当前POI如果有父POI,则返回父POI的ID。可能为空
childtype
array | string 
必需
name
string 
名称
必需
tag
array[string]
该POI的特色内容
必需
主要出现在美食类POI中,代表特色菜 例如“烤鱼,麻辣香锅,老干妈回锅肉” extensions=all时返回
type
string 
兴趣点类型
必需
顺序为大类、中类、小类 例如:餐饮服务;中餐厅;特色/地方风味餐厅
typecode
string 
兴趣点类型编码
必需
例如:050118
biz_type
array[string]
行业类型
必需
address
string 
地址
必需
东四环中路189号百盛北门
location
string 
经纬度
必需
格式:X,Y
tel
array | string 
POI的电话
必需
postcode
array[string]
邮编
必需
extensions=all时返回
website
array[string]
POI的网址
必需
extensions=all时返回
email
array[string]
POI的电子邮箱
必需
extensions=all时返回
pcode
string 
POI所在省份编码
必需
extensions=all时返回
pname
string 
POI所在省份名称
必需
若是直辖市的时候,此处直接显示市名,例如北京市
citycode
string 
城市编码
必需
extensions=all时返回
cityname
string 
城市名
必需
若是直辖市的时候,此处直接显示市名,例如北京市
adcode
string 
区域编码
必需
extensions=all时返回
adname
string 
区域名称
必需
区县级别的返回,例如朝阳区
parking_type
string 
停车场类型
必需
仅在停车场类型POI的时候显示该字段 展示停车场类型,包括:地下、地面、路边 extensions=all的时候显示
importance
array[string]
必需
shopid
array[string]
必需
shopinfo
string 
必需
poiweight
array[string]
必需
gridcode
string 
地理格ID
必需
extensions=all时返回
distance
array[string]
离中心点距离
必需
navi_poiid
array | string 
POI导航id
必需
extensions=all时返回
entr_location
array | string 
POI的入口经纬度
必需
extensions=all时返回,也可用作于POI的到达点;
business_area
array[string]
所属商圈
必需
extensions=all时返回
exit_location
array[string]
POI的出口经纬度
必需
目前不会返回内容;
match
string 
必需
recommend
string 
必需
timestamp
string 
必需
alias
array[string]
别名
必需
extensions=all时返回
indoor_map
string 
是否有室内地图标志
必需
1,表示有室内相关数据 0,代表没有室内相关数据 extensions=all时返回
indoor_data
object 
室内地图相关数据
必需
当indoor_map=0时,字段为空 extensions=all时返回
groupbuy_num
string 
团购数据
必需
此字段逐渐废弃
discount_num
string 
优惠信息数目
必需
此字段逐渐废弃
biz_ext
object 
深度信息
必需
extensions=all时返回
event
array[string]
必需
children
array [object {8}] 
必需
photos
array [object {2}] 
照片相关信息
必需
extensions=all时返回

【高德地图】API开发者 微信交流群

用微信扫右侧二维码,加入【高德地图】API开发者 交流群,互助沟通

扫码加入交流群
修改于 2022-12-13 08:09:15
上一页
概述
下一页
周边搜索
Built with