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查询

GET

curl -X GET "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY&poi_id=moyjVxi_aHzLDwxv4K3CVUOF2ddYVSb3FahA-Xh-ptQ"

POST

curl -X POST "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "poi_id": "moyjVxi_aHzLDwxv4K3CVUOF2ddYVSb3FahA-Xh-ptQ"
}'

使用经纬度查询

GET

curl -X GET "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY&location=116.314230,39.979392"

POST

curl -X POST "https://lbs.xiaojukeji.com/api/v2/aoi?key=YOUR_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "location": "116.314230,39.979392"
}'

响应

成功响应为 AoiResponse 模型的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"
            }
        ]
    }
}