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

ID查询

GET
/v3/place/detail
说明:ID(B0FFFAB6J2)是查询POI ID,extensions(all)为返回的数据内容,output(XML)用于指定返回数据的格式,key是用户请求数据的身份标识。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://restapi.amap.com/v3/place/detail?id=B0FFFAB6J2&Key='
响应示例响应示例
{
  "status": "1",
  "info": "OK",
  "infocode": "10000",
  "count": "1",
  "pois": [
    {
      "id": "B0FFFAB6J2",
      "parent": [],
      "childtype": [],
      "name": "首开广场",
      "tag": [],
      "type": "商务住宅;楼宇;商务写字楼",
      "typecode": "120201",
      "biz_type": [],
      "address": "阜荣街10号",
      "location": "116.473004,39.993306",
      "tel": [],
      "postcode": [],
      "website": [],
      "email": [],
      "pcode": "110000",
      "pname": "北京市",
      "citycode": "010",
      "cityname": "北京市",
      "adcode": "110105",
      "adname": "朝阳区",
      "importance": [],
      "shopid": [],
      "shopinfo": "0",
      "poiweight": [],
      "gridcode": "5916739702",
      "distance": [],
      "navi_poiid": "J50F001020_342662",
      "entr_location": "116.474025,39.992806",
      "business_area": "望京",
      "exit_location": [],
      "match": "0",
      "recommend": "0",
      "timestamp": "2022-12-09 08:13:14",
      "alias": "首开|环球创意广场",
      "indoor_map": "1",
      "indoor_data": {
        "cpid": "B0FFFAB6J2",
        "floor": [],
        "truefloor": [],
        "cmsid": "TY000191_B0FFFAB6J2"
      },
      "groupbuy_num": "0",
      "discount_num": "0",
      "biz_ext": {
        "rating": [],
        "cost": []
      },
      "event": [],
      "children": [],
      "photos": [
        {
          "title": "效果图",
          "url": "http://store.is.autonavi.com/showpic/a9836f620749c34742cf1ab67dc98f08"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/55bc817dc0027981d599ef935145e5c4"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/fc59663860f3ec7af97a1cfe02e6b690"
        }
      ]
    }
  ]
}

请求参数

Query 参数
id
string 
必需
AOI唯一标识 最多可以传入1个id,传入目标区域的poiid即可
示例值:
B0FFFAB6J2
sig
string 
可选
数字签名获取和使用方法
callback
string 
可选
回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效
parameters
string 
可选
Key
string 
必需
用户在高德地图官网申请Web服务API类型Key
默认值:
{{Key}}

返回响应

🟢200成功
application/json
Body
status
string 
结果状态值,值为0或1
必需
0:请求失败;1:请求成功
info
string 
返回状态说明
必需
status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表
infocode
string 
必需
count
string 
搜索方案数目
必需
pois
array [object {42}] 
搜索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 
区域名称
可选
区县级别的返回,例如朝阳区
importance
array[string]
可选
shopid
array[string]
可选
shopinfo
string 
可选
poiweight
array[string]
可选
gridcode
string 
可选
distance
array[string]
可选
navi_poiid
string 
可选
entr_location
string 
POI的入口经纬度
可选
extensions=all时返回,也可用作于POI的到达点;
business_area
string 
所属商圈
可选
extensions=all时返回
exit_location
array[string]
POI的出口经纬度
可选
目前不会返回内容;
match
string 
可选
recommend
string 
可选
timestamp
string 
可选
alias
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[string]
可选
photos
array [object {2}] 
照片相关信息
可选
extensions=all时返回

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

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

扫码加入交流群
上一页
多边形搜索
下一页
AOI边界查询
Built with