Amap Maps Get V3 Traffic Status Road

1.00 credits/call
ae_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.

Maps
1.00 credits/call

Pricing

1.00 credits/call
ConditionCharge
Each call1.00 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
sigstringNo仅账号启用了数字签名校验时提供,按高德签名规则计算。—
citystringNo城市名称;与 adcode 至少提供一项。—
namestringYes道路名称。—
levelintegerYes道路等级,1 至 6;较大等级同时包含较小等级。—
adcodestringNo城市级行政区编码;与 city 至少提供一项。—
outputenum (JSON | XML)No响应编码;建议使用 JSON。JSON
extensionsenum (base | all)Nobase 返回基本信息;all 同时返回详细信息。base

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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": "东长安街"
  }
}'
Response exampleresponse.json
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%"
    }
  }
}