POI 多边形区域检索

接口说明

POI 多边形区域检索

输入示例：多边形范围：湖州一块区域；关键词：美食；每页 50 条

返回示例：返回多边形范围内的 POI 列表，包含名称、地址、坐标、分类和商圈等信息。

请求地址

GEThttps://cloud.dtbgis.com/api/v1/poi/polygon

鉴权方式

在 HTTP Header 中携带你的 API Key：

X-API-Key: 你的API-Key

每个 API Key 绑定已购接口与流量豆，调用成功扣减对应流量豆；调用失败（参数错误等）不扣流量豆。未开通该接口返回 403，流量豆不足返回 429。

请求参数

参数	必填	说明	示例 / 默认值
`polygon`	必填	多边形区域坐标点，格式 "lng1,lat1,lng2,lat2,...,lngn,latn"	`120.283063,30.75784,120.464588,30.918838`
`keywords`	可选	搜索关键词，多个关键词用"\|"分隔	—
`types`	可选	POI分类编码，多个分类用"\|"分隔	—
`page`	可选	页码，从1开始	`1`
`offset`	可选	每页记录数，最大100	`50`
`extensions`	可选	返回结果控制，base（基本信息）或all（全部信息）可选值：`base` base、`all` all	`all`

请求示例

curl -H "X-API-Key: 你的API-Key" \
  "https://cloud.dtbgis.com/api/v1/poi/polygon?polygon=120.283063%2C30.75784%2C120.464588%2C30.918838&page=1"

import requests

resp = requests.get(
    "https://cloud.dtbgis.com/api/v1/poi/polygon?polygon=120.283063%2C30.75784%2C120.464588%2C30.918838&page=1",
    headers={"X-API-Key": "你的API-Key"},
)
print(resp.status_code, resp.json())

fetch("https://cloud.dtbgis.com/api/v1/poi/polygon?polygon=120.283063%2C30.75784%2C120.464588%2C30.918838&page=1", {
  headers: { "X-API-Key": "你的API-Key" }
})
  .then(r => r.json())
  .then(console.log);

返回结果说明

本接口返回统一 JSON 信封结构：

{
  "code": 200,
  "msg": "success",
  "data": { ... },
  "quota_remaining": 9999
}

字段	说明
`code`	业务状态码，`200` 表示成功
`msg`	状态描述，成功为 `success`
`data`	查询结果对象，字段见下方「`data` 字段说明」
`quota_remaining`	本次调用后剩余可用流量豆数量

data 为高德原始 JSON 透传，坐标系 GCJ-02。extensions=all 时 pois[] 含 photos / biz_ext 等富信息。如需与厂商解耦的统一格式，请使用「POI 多边形区域检索 v2」（/api/v2/poi/polygon）。

响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "status": "1",
    "info": "OK",
    "infocode": "10000",
    "count": "600",
    "pois": [
      {
        "id": "B0JR1OXFUM",
        "name": "杏木千鹤日本料理",
        "type": "餐饮服务;外国餐厅;日本料理",
        "typecode": "050202",
        "biz_type": "diner",
        "address": "前门东大街辅路首都宾馆南2门",
        "location": "116.409002,39.901829",
        "tel": "010-58159666",
        "pname": "北京市",
        "pcode": "110000",
        "cityname": "北京市",
        "citycode": "010",
        "adname": "东城区",
        "adcode": "110101",
        "business_area": "王府井",
        "tag": "寿司,牛肉,蔬菜沙拉",
        "photos": [
          { "title": "环境", "url": "https://aos-comment.amap.com/xxxx.jpg" }
        ],
        "biz_ext": {
          "rating": "4.6",
          "cost": "932.00",
          "open_time": "11:30-14:00 17:30-22:00",
          "opentime2": "周一至周日 11:30-14:00",
          "meal_ordering": "0"
        }
      }
    ]
  },
  "quota_remaining": 9995
}

`data` 字段说明

字段	类型	说明	示例
`status`	string	上游状态码，"1" 表示成功	`1`
`info`	string	上游状态说明	`OK`
`infocode`	string	上游状态码明细	`10000`
`count`	string	检索总结果数	`600`
`pois`	array	POI 结果列表	—
`id`	string	POI 唯一 ID	`B0JR1OXFUM`
`name`	string	POI 名称	`杏木千鹤日本料理`
`type`	string	POI 类型，顺序为大类;中类;小类	`餐饮服务;外国餐厅;日本料理`
`typecode`	string	POI 类型编码	`050202`
`biz_type`	string	行业类型	`diner`
`address`	string	地址	`前门东大街辅路首都宾馆南2门`
`location`	string	经纬度，格式 lng,lat（GCJ-02）	`116.409002,39.901829`
`tel`	string	联系电话	`010-58159666`
`pname`	string	省 / 直辖市名称	`北京市`
`pcode`	string	省级编码	`110000`
`cityname`	string	城市名称	`北京市`
`citycode`	string	城市电话区号	`010`
`adname`	string	区县名称	`东城区`
`adcode`	string	行政区划编码	`110101`
`business_area`	string	所在商圈	`王府井`
`tag`	string	标签	`寿司,牛肉,蔬菜沙拉`
`photos`	array	图片列表（extensions=all 时返回）	—
`title`	string	图片标题	`环境`
`url`	string	图片 URL	`https://aos-comment.amap.com/...jpg`
`biz_ext`	object	营业扩展信息（extensions=all 时返回）	—
`rating`	string	评分	`4.6`
`cost`	string	人均消费	`932.00`
`open_time`	string	营业时间	`11:30-14:00 17:30-22:00`
`opentime2`	string	营业时间（详细描述）	`周一至周日 11:30-14:00`
`meal_ordering`	string	是否支持在线点餐	`0`
`entr_location`	string	入口经纬度	`116.408967,39.901664`
`exit_location`	string	出口经纬度，多为空	—
`navi_poiid`	string	导航 POI ID	`J50F002020_522576`
`distance`	string	距中心点距离（米，周边检索时返回）	`51`

错误码

错误以统一结构返回：{"detail": {"code": 429, "msg": "..."}}

HTTP	含义	常见原因 / 处理
`400`	参数错误	缺少必填参数或格式不合法
`401`	鉴权失败	API Key 缺失、不存在、已停用或已过期
`403`	权限不足	该 API Key 未开通此接口，请购买流量豆
`429`	流量豆不足 / 限流	流量豆用完需续费；或超过速率（60 秒 200 次）
`404`	资源不存在	路径错误，或查询对象无数据
`503`	服务暂时不可用	服务暂时异常，请稍后重试

完整错误码见文档首页 · 错误码总览。