Amap Maps Get V3 Place Polygon
1 credits/call
ae_amap_maps_get_v3_place_polygon
Search for places and points of interest within a specific custom-drawn area or polygon on the map.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | string | No | 当前页数 最大翻页数100 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 1 |
types | string | No | | 查询POI类型 | 多个类型用“\|”分割;可选值:分类代码 或 汉字 (若用汉字,请严格按照附件之中的汉字填写) 分类代码由六位数字组成,一共分为三个部分,前两个数字代表大类;中间两个数字代表中类;最后两个数字代表小类。若指定了某个大类,则所属的中类、小类都会被显示。例如:010000为汽车服务(大类) 010100为加油站(中类) 010101为中国石化(小类) 010900为汽车租赁(中类) 010901为汽车租赁还车(小类)当指定010000,则010100等中类、010101等小类都会被包含。当指定010900,则010901等小类都会被包含[下载POI分类编码和城市编码表 ](https://lbs.amap.com/api/webservice/download) **当keywords和types为空的时候,** **我们会默认指定types为120000(商务住宅)&150000(交通设施服务)** | | ----------- | ------------------------------------------------------------ | | | | 注意:该参数在 schema 中定义为 string;如果传 POI 分类代码、城市编码或行政区划编码,请按字符串传入并保留前导 0,例如 "050301",不要传数字 50301。 | — |
offset | string | No | 每页记录数据 强烈建议不超过25,若超过25可能造成访问报错 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 20 |
output | enum (JSON | XML) | No | 返回数据格式类型 可选值:JSON,XML | JSON |
polygon | string | Yes | 经纬度坐标对 规则:经度和纬度用","分割,经度在前,纬度在后,坐标对用"|"分割。经纬度小数点后不得超过6位。 多边形为矩形时,可传入左上右下两顶点坐标对;其他情况下首尾坐标对需相同。 | — |
callback | string | No | 回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效 | — |
keywords | string | No | 查询关键字 规则: 多个关键字用“|”分割 | — |
extensions | enum (base | all) | No | 返回结果控制 此项默认返回基本地址信息;取值为all返回地址信息、附近POI、道路以及道路交叉口信息。 | base |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v3_place_polygon' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"offset": "25",
"output": "JSON",
"page": "15",
"polygon": "113.490,23.390|114.030,23.020",
"types": "060100"
}
}'Response exampleresponse.json
{
"count": "0",
"info": "OK",
"infocode": "10000",
"pois": [],
"status": "1",
"suggestion": {
"cities": [],
"keywords": []
}
}
