Amap Maps Get V3 Place Around
1 credits/call
ae_amap_maps_get_v3_place_around
Search for nearby places in mainland China using Amap (Gaode) Maps. Find restaurants, hotels, shops, and other points of interest around a specific location.
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 |
|---|---|---|---|---|
city | string | No | 查询城市 可选值:城市中文、中文全拼、citycode、adcode 如:北京/beijing/010/110000 当用户指定的经纬度和city出现冲突,若范围内有用户指定city的数据,则返回相关数据,否则返回为空。 如:经纬度指定石家庄,而city却指定天津,若搜索范围内有天津的数据则返回相关数据,否则返回为空。 | — |
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为050000(餐饮服务)、070000(生活服务)、120000(商务住宅)** 注意:该参数在 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 |
radius | string | No | 查询半径 取值范围:0-50000。规则:大于50000按默认值,单位:米 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 5000 |
callback | string | No | 回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效 | — |
keywords | string | No | 查询关键字 规则: 多个关键字用“|”分割 | — |
location | string | Yes | 中心点坐标 规则: 经度和纬度用","分割,经度在前,纬度在后,经纬度小数点后不得超过6位 | — |
sortrule | enum (distance | weight) | No | 排序规则 规定返回结果的排序规则。 按距离排序:distance;综合排序:weight | distance |
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_around' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keywords": "产业园|科技园|工业园|写字楼|大厦|商务楼",
"location": "116.623574,34.694303",
"offset": "25",
"output": "JSON",
"radius": "9000",
"sortrule": "distance"
}
}'Response exampleresponse.json
{
"count": "5",
"info": "OK",
"infocode": "10000",
"pois": [
{
"address": "侯园巷与人民路交叉口南80米",
"adname": "丰县",
"atag": [],
"id": "B0L1VOBCWJ",
"name": "丰县云商汇数字商务产业园",
"type": "商务住宅;产业园区;产业园区"
}
],
"status": "1",
"suggestion": {
"cities": [],
"keywords": []
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

