高德地图 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/polygon
parameters代表的参数包括必填参数和可选参数。所有参数均使用和号字符(&)进行分隔。下面的列表枚举了这些参数及其使用规则。
说明: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)为返回的数据内容,output(XML)用于指定返回数据的格式,key是用户请求数据的身份标识。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '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&Key='
响应示例响应示例
{
  "suggestion": {
    "keywords": [],
    "cities": []
  },
  "count": "3",
  "infocode": "10000",
  "pois": [
    {
      "parent": "B0FFF5UV26",
      "distance": [],
      "pcode": "110000",
      "importance": [],
      "biz_ext": {
        "cost": "30.00",
        "rating": "4.8",
        "meal_ordering": "0"
      },
      "recommend": "0",
      "type": "餐饮服务;快餐厅;肯德基",
      "photos": [
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/7d0d887efcfa6fe071f806eac8e1473f"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/cf64ea8e22533b4bba864a3b10c322fb"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/0fa22626ef3c5ebb530d153cc0967b64"
        }
      ],
      "discount_num": "0",
      "gridcode": "5916738701",
      "typecode": "050301",
      "shopinfo": "0",
      "poiweight": [],
      "citycode": "010",
      "adname": "朝阳区",
      "children": [],
      "alias": [],
      "tel": "4009200715",
      "id": "B000A7BM4H",
      "tag": "吮指原味鸡,蔬菜沙拉,全家桶,黄金鸡块,醇香土豆泥,伴柠伴桔鲜果茶,KFC香辣(劲脆)鸡腿堡,KFC芋缘花淇淋,玉米沙拉,小食拼盘,KFC老北京鸡肉卷,可乐,薯条,葡式蛋挞,海苔岩烧大鸡腿饭,现磨咖啡,芋缘花淇淋,鸡米花,香辣鸡翅,红豆派,肯大大鸡排,新奥尔良烤鸡腿堡",
      "event": [],
      "entr_location": "116.469414,39.985729",
      "indoor_map": "0",
      "email": [],
      "timestamp": "2022-03-22 13:18:13",
      "website": [],
      "address": "花家地小区1号商业楼",
      "adcode": "110105",
      "pname": "北京市",
      "biz_type": "diner",
      "cityname": "北京市",
      "postcode": [],
      "match": "0",
      "business_area": "望京",
      "indoor_data": {
        "cmsid": [],
        "truefloor": [],
        "cpid": [],
        "floor": []
      },
      "childtype": "202",
      "exit_location": [],
      "name": "肯德基(花家地店)",
      "location": "116.469260,39.985581",
      "shopid": [],
      "navi_poiid": "J50F001020_425283",
      "groupbuy_num": "0"
    },
    {
      "parent": "B0FFG4VQTD",
      "distance": [],
      "pcode": "110000",
      "importance": [],
      "biz_ext": {
        "cost": "48.00",
        "rating": "4.7",
        "meal_ordering": "0"
      },
      "recommend": "0",
      "type": "餐饮服务;快餐厅;肯德基",
      "photos": [
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/7d0d887efcfa6fe071f806eac8e1473f"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/53a383b0a310b133764f7171"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/6e2d247199cccf317d80088098ecd462"
        }
      ],
      "discount_num": "0",
      "gridcode": "6016030700",
      "typecode": "050301",
      "shopinfo": "0",
      "poiweight": [],
      "citycode": "010",
      "adname": "朝阳区",
      "children": [],
      "alias": [],
      "tel": "4009208801",
      "id": "B000A7FVJQ",
      "tag": "可乐,葡式蛋挞,KFC老北京鸡肉卷,红豆派,肯大大鸡排,黄金鸡块,吮指原味鸡,蔬菜沙拉,醇香土豆泥,伴柠伴桔鲜果茶,KFC芋缘花淇淋,玉米沙拉,小食拼盘,全家桶,海苔岩烧大鸡腿饭,现磨咖啡,新奥尔良烤鸡腿堡,香辣鸡翅,薯条,芋缘花淇淋,鸡米花,KFC香辣(劲脆)鸡腿堡",
      "event": [],
      "entr_location": [],
      "indoor_map": "0",
      "email": [],
      "timestamp": "2022-03-22 12:27:32",
      "website": [],
      "address": "望京南湖东园201号楼1层",
      "adcode": "110105",
      "pname": "北京市",
      "biz_type": "diner",
      "cityname": "北京市",
      "postcode": [],
      "match": "0",
      "business_area": "望京",
      "indoor_data": {
        "cmsid": [],
        "truefloor": [],
        "cpid": [],
        "floor": []
      },
      "childtype": "202",
      "exit_location": [],
      "name": "肯德基(中福百货店)",
      "location": "116.463368,40.000511",
      "shopid": [],
      "navi_poiid": "J50F001020_223840",
      "groupbuy_num": "0"
    },
    {
      "parent": [],
      "distance": [],
      "pcode": "110000",
      "importance": [],
      "biz_ext": {
        "cost": "35.00",
        "rating": "4.5",
        "meal_ordering": "0"
      },
      "recommend": "0",
      "type": "餐饮服务;快餐厅;肯德基",
      "photos": [
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/7d0d887efcfa6fe071f806eac8e1473f"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/16cfe87ab6592e008358292b6736c89f"
        },
        {
          "title": [],
          "url": "http://store.is.autonavi.com/showpic/2614d1c30078ddaefd25dee77ae85130"
        }
      ],
      "discount_num": "0",
      "gridcode": "5916739722",
      "typecode": "050301",
      "shopinfo": "0",
      "poiweight": [],
      "citycode": "010",
      "adname": "朝阳区",
      "children": [],
      "alias": [],
      "tel": "4009208801",
      "id": "B0FFKEPXS2",
      "tag": [],
      "event": [],
      "entr_location": [],
      "indoor_map": "0",
      "email": [],
      "timestamp": "2022-03-22 13:16:11",
      "website": [],
      "address": "望京西园4区410号综合楼1层",
      "adcode": "110105",
      "pname": "北京市",
      "biz_type": "diner",
      "cityname": "北京市",
      "postcode": [],
      "match": "0",
      "business_area": "望京",
      "indoor_data": {
        "cmsid": [],
        "truefloor": [],
        "cpid": [],
        "floor": []
      },
      "childtype": [],
      "exit_location": [],
      "name": "肯德基(望京西店)",
      "location": "116.473942,39.997773",
      "shopid": [],
      "navi_poiid": [],
      "groupbuy_num": "0"
    }
  ],
  "status": "1",
  "info": "OK"
}

请求参数

Query 参数
polygon
string 
必需
经纬度坐标对 规则:经度和纬度用","分割,经度在前,纬度在后,坐标对用"|"分割。经纬度小数点后不得超过6位。 多边形为矩形时,可传入左上右下两顶点坐标对;其他情况下首尾坐标对需相同。
示例值:
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
string 
可选
查询关键字 规则: 多个关键字用“|”分割
示例值:
肯德基
types
string 
可选
| 查询POI类型 | 多个类型用“|”分割;可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。若指定了某个大类,则所属的中类、小类都会被显示。例如:010000为汽车服务(大类) 010100为加油站(中类) 010101为中国石化(小类) 010900为汽车租赁(中类) 010901为汽车租赁还车(小类)当指定010000,则010100等中类、010101等小类都会被包含。当指定010900,则010901等小类都会被包含下载POI分类编码和城市编码表 当keywords和types为空的时候, 我们会默认指定types为120000(商务住宅)&150000(交通设施服务) | | ----------- | ------------------------------------------------------------ | | | |
示例值:
050301
offset
string 
可选
每页记录数据 强烈建议不超过25,若超过25可能造成访问报错
示例值:
20
page
string 
可选
当前页数 最大翻页数100
示例值:
1
extensions
string 
可选
返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。
示例值:
all
sig
string 
可选
数字签名获取和使用方法
output
string 
可选
返回数据格式类型 可选值:JSON,XML
callback
string 
可选
回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效
parameters 
string 
可选
Key
string 
必需
用户在高德地图官网申请Web服务API类型Key
默认值:
{{Key}}

返回响应

🟢200成功
application/json
Body
type
string 
可选
兴趣点类型 顺序为大类、中类、小类 例如:餐饮服务;中餐厅;特色/地方风味餐厅
properties
object 
可选
suggestion
object 
可选
城市建议列表 当搜索的文本关键字在限定城市中没有返回时会返回建议城市列表;
count
object 
可选
搜索方案数目(最大值为1000)
infocode
object 
可选
pois
object 
搜索POI信息列表
可选
status
object 
可选
结果状态值,值为0或1 0:请求失败;1:请求成功
info
object 
可选
| 返回状态说明 | status为0时,info返回错误原因,否则返回“OK”。详情参阅info状态表 | | ------------ | ------------------------------------------------------------ | | | |
required
array[string]
可选

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

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

扫码加入交流群
上一页
周边搜索
下一页
ID查询
Built with