Appearance
AOI查询
AOI(Area of Interest)查询接口用于根据传入的POI ID 或 所在地的经纬度,查询兴趣区域轮廓信息。
AOI信息查询 API
接口描述
根据传入的POI ID 或 所在地的经纬度,查询AOI信息,如商场、园区、小区等兴趣区域的详细信息和边界轮廓。
请求方式
| URL | 请求方式 |
|---|---|
| https://lbs.xiaojukeji.com/api/v2/aoi | POST、GET |
请求
查询参数(GET)
| 参数名 | 必选 | 类型 | 描述 | 示例值 |
|---|---|---|---|---|
| key | 是 | string | 鉴权用的 API Key | YOUR_API_KEY |
| poi_id | 否 | string | 要查询轮廓区域的 POI ID,可以通过检索类接口获取POI ID | 115771255188811515789773365485059874514 |
| location | 否 | string | 所在地的经纬度,格式'lng,lat',(经度,纬度) | 116.314230,39.979392 |
注意: poi_id 和 location 至少需要提供一个,两者都提供时优先使用 poi_id。
请求体参数(POST)
当使用POST方法时,请求体应为 AoiRequest 模型的JSON格式。
请求示例
使用POIID查询
shell
curl -X GET "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY&poi_id=115771255188811515789773365485059874514"使用经纬度查询
shell
curl -X GET "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY&location=116.314230,39.979392"响应
成功响应为 AoiResponse 模型的JSON格式。
响应示例
json
{
"status": 10000,
"msg": "OK",
"trace_id": "0ac5186e67e50a9c190b048d5ef3dab0",
"results": {
"count": 1,
"data": [
{
"name": "中关村软件园",
"location": {
"lng": 116.314016,
"lat": 39.979851
},
"address": "北京市海淀区西北旺东路10号",
"province": "北京市",
"city": "北京市",
"district": "海淀区",
"adcode": "110108",
"address_all": "北京市海淀区西北旺东路10号中关村软件园",
"poi_id": "115771255188811515789773365485059874514",
"area": 14617.951,
"coordinates": "116.3140162,39.9798514;116.313515,39.9800486;116.3133198,39.9800192;116.3126259,39.9799681;116.312419,39.9797461;116.3125472,39.9793077;116.3130194,39.9789934;116.3138348,39.9790363;116.3141567,39.9791324;116.3144142,39.9792871;116.3145644,39.9796494;116.3140162,39.9798514"
}
]
}
}