高德地图 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