Get started

Amap routes in China in Duaer

In Duaer: Amap: driving or walking routes in China with distance, time, tolls, and steps. One successful search uses 1 credit.

What you get

Duaer Amap routes in China plans driving or walking routes in mainland China between two coordinates or addresses. Duaer holds the upstream API key; you only send your Duaer key.

Pick Duaer Data → Amap routes in China in the node creator, or open the data market. Related: Amap geocoding in China, Amap places in China.

When to use it

Estimate the drive from a station to an airport.
Get walking steps between two points.

When not to use it

Driving routes outside China. Use Driving route.
Coordinates only. Use Amap geocoding in China.

Search on the canvas

Open the node creator and pick Duaer Data → Amap routes in China.
Fill Origin (such as 116.378888,39.865243), Destination (such as 116.397477,39.908692). Optional: Mode (walking), City.
Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

GET https://api.duaer.com/v1/data/amap-route?origin=116.378888,39.865243&destination=116.397477,39.908692
Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-amap-route
description: >-
  Duaer Amap routes in China. Amap: driving or walking routes in China with distance, time, tolls, and steps.
  One successful search uses 1 Duaer credit.
---

# Duaer Amap routes in China

Duaer Amap routes in China plans driving or walking routes in mainland China between two coordinates or addresses. Duaer holds the upstream API key; you only send your Duaer key.

## When to use

- Estimate the drive from a station to an airport.
- Get walking steps between two points.

## When not to use

- Driving routes outside China. Use https://skills.duaer.com/driving-route.md.
- Coordinates only. Use https://skills.duaer.com/amap-geocode.md.

## Call

`GET https://api.duaer.com/v1/data/amap-route?origin=116.378888,39.865243&destination=116.397477,39.908692`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `origin` and `destination`.

- `origin` — Longitude,latitude such as 116.481028,39.989643, or a URL-encoded address.
- `destination` — Longitude,latitude or a URL-encoded address.
- `mode` — Optional. `driving` or `walking`. Default `driving`.
- `city` — Optional. City name or adcode used to find addresses.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/amap-route?origin=116.378888,39.865243&destination=116.397477,39.908692` — drive from Beijing South Station to Tiananmen.
- `GET https://api.duaer.com/v1/data/amap-route?origin=120.155,30.274&destination=120.148,30.259&mode=walking` — a walk in Hangzhou.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `mode`, `rank`, `distanceMeters`, `durationMinutes`, `strategy` — route and Amap strategy.
- `tollsYuan`, `tollDistanceMeters`, `trafficLights`, `taxiCostYuan` — tolls, traffic lights, and estimated taxi fare.
- `origin`, `destination`, `steps` — coordinates used and turn-by-turn steps.

Driving returns up to three routes; an address is geocoded first in the same search.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/amap-geocode.md — Duaer Amap geocoding in China
- https://skills.duaer.com/amap-poi.md — Duaer Amap places in China

Questions

How many credits does a Amap routes in China search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Can I enter an address as the origin in Duaer Amap routes in China?

Yes. Duaer geocodes the address first in the same search and still uses 1 credit. City helps find the right place.

In this section

Get started

Amap geocoding in China in Duaer

In Duaer: Amap: longitude, latitude, and adcode for a Chinese address. One successful search uses 1 credit.

Get started

Amap places in China in Duaer

In Duaer: Amap: shops, restaurants, and other places in China by keyword and city, with address and phone. One successful search uses 1 credit.