Amap Maps Get V3 Traffic Status Circle
1 credits/call
ae_amap_maps_get_v3_traffic_status_circle
Check real-time traffic congestion around a specific location within a given radius.
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 |
|---|---|---|---|---|
level | string | Yes | 道路等级 指定道路等级,下面各值代表的含义: 1:高速(京藏高速) 2:城市快速路、国道(西三环、103国道) 3:高速辅路(G6辅路) 4:主要道路(长安街、三环辅路路) 5:一般道路(彩和坊路) 6:无名道路 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | — |
output | enum (JSON | XML) | No | 返回数据格式类型 可选值:JSON,XML | JSON |
radius | string | No | 半径 单位:米,最大取值5000米。 注意:该参数在 schema 中定义为 string,即使含义是数字或数字枚举,也请按字符串传入,例如 "1"、"20",不要传裸数字 1、20。 | 1000 |
callback | string | No | 回调函数 callback值是用户定义的函数名称,此参数只在output=JSON时有效 | — |
location | string | Yes | 中心点坐标 经度在前,纬度在后。经度和纬度用","分割。 经纬度小数点后不得超过6位。 | — |
extensions | enum (base | all) | No | 返回结果控制 可选值:base,all | 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_traffic_status_circle' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"extensions": "all",
"level": "5",
"location": "114.107441,22.650762",
"output": "JSON",
"radius": "1000"
}
}'Response exampleresponse.json
{
"info": "OK",
"infocode": "10000",
"status": "1",
"trafficinfo": {
"description": "布澜路:双向畅通。",
"evaluation": {
"blocked": "0.00%",
"congested": "0.00%",
"description": "整体畅通",
"expedite": "100.00%",
"status": "1",
"unknown": "0.00%"
},
"roads": [
{
"angle": "125",
"direction": "从东西干道到甘李路",
"lcodes": "3137,3138,3139,3149",
"name": "布澜路",
"polyline": "114.141106,22.6220531;114.140747,22.6230316;114.140678,22.6232452;114.140465,22.6237698;114.140198,22.6242447;114.139908,22.6247063;114.139549,22.6251297;114.139458,22.6252308;114.139366,22.6253147;114.13887,22.6257458;114.13839,22.6261463;114.137085,22.62",
"status": "1"
}
]
}
}This example shows part of the response. Copied content is valid JSON.

