Amap Maps Get V3 Traffic Status Road
Look up real-time traffic conditions for a named road with Amap (高德). Provide the road name, a road level from 1 to 6, and at least one of city or adcode; a city-level adcode is recommended. Higher level values include lower road levels. Results include request status, a traffic summary and an evaluation of congestion and traffic-condition percentages. extensions=base is the default; choose all for road-segment details such as speed (km/h), direction, traffic status and coordinate polylines. output defaults to JSON and also supports XML. Provide sig only if digital-signature verification is enabled for the account. Business success requires top-level status='1' and infocode='10000', even when the HTTP request succeeds.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.00 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
sig | string | No | 仅账号启用了数字签名校验时提供,按高德签名规则计算。 | — |
city | string | No | 城市名称;与 adcode 至少提供一项。 | — |
name | string | Yes | 道路名称。 | — |
level | integer | Yes | 道路等级,1 至 6;较大等级同时包含较小等级。 | — |
adcode | string | No | 城市级行政区编码;与 city 至少提供一项。 | — |
output | enum (JSON | XML) | No | 响应编码;建议使用 JSON。 | JSON |
extensions | enum (base | all) | No | base 返回基本信息;all 同时返回详细信息。 | base |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amap_maps_get_v3_traffic_status_road' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"adcode": "110000",
"level": 5,
"name": "东长安街"
}
}'{
"info": "OK",
"infocode": "10000",
"status": "1",
"trafficinfo": {
"description": "东长安街:双向畅通。",
"evaluation": {
"blocked": "0.00%",
"congested": "0.00%",
"description": "畅通",
"expedite": "100.00%",
"status": "1",
"unknown": "0.00%"
}
}
}
