Amap Maps Get V5 Direction Bicycling
Plan bicycle routes with Amap (高德) using required origin and destination coordinates. Enter each as a GCJ-02 longitude,latitude string with at most six decimal places per coordinate. Results include route distances and step-by-step cycling directions when successful. Use show_fields to request optional data such as duration and route polylines; omit it for basic results. alternative_route can request 1, 2 or 3 routes, with the provider default used when omitted. Supply sig only if the account requires digital-signature verification. The response includes business status and error information; check status="1" and infocode="10000" rather than relying on HTTP success alone.
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 | 仅账号启用了数字签名校验时提供,按高德签名规则计算。 | — |
origin | string | Yes | GCJ-02 经度,纬度;各最多六位小数。 | — |
output | enum (json) | No | 返回 JSON。 | json |
callback | string | No | 可选 JSONP 回调名称;服务端工具调用通常不需要设置。 | — |
destination | string | Yes | GCJ-02 经度,纬度;各最多六位小数。 | — |
show_fields | string | No | 按官方返回字段组控制可选数据,多组以英文逗号分隔;省略时只返回基本结果。 | — |
alternative_route | enum (1 | 2 | 3) | No | 返回前一、二或三条备选路线;省略时由上游返回默认方案。 | — |
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_v5_direction_bicycling' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"destination": "116.464240,40.020642",
"origin": "116.466485,39.995197"
}
}'{
"count": "1",
"info": "OK",
"infocode": "10000",
"route": {
"destination": "116.464240,40.020642",
"origin": "116.466485,39.995197",
"paths": [
{
"distance": "3912",
"duration": "1354",
"steps": [
{
"instruction": "向南骑行41米左转",
"orientation": "南",
"road_name": "",
"step_distance": 41
}
]
}
]
},
"status": "1"
}This example shows part of the response. Copied content is valid JSON.

