Get started

Driving route in Duaer

In Duaer: OSRM on OpenStreetMap: driving distance, time, and main roads between two points, with alternatives. One successful search uses 1 credit.

What you get

Duaer Driving route asks the public OSRM router for the fastest car route between two points, plus alternatives. Times assume free-flowing traffic.

Pick Duaer Data → Driving route in the node creator, or open the data market. Related: Places nearby, Place lookup.

When to use it

Estimate the drive time between two sites.
Compare route distances for a delivery plan.

When not to use it

Places around a point. Use Places nearby.
Addresses to coordinates. Use Place lookup.

Search on the canvas

Open the node creator and pick Duaer Data → Driving route.
Fill From and To as latitude,longitude (such as 51.5007,-0.1246).
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/driving-route?from=51.5007,-0.1246&to=51.5081,-0.0759
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-driving-route
description: >-
  Duaer Driving route. OSRM on OpenStreetMap: driving distance, time, and main roads between two points, with alternatives.
  One successful search uses 1 Duaer credit.
---

# Duaer Driving route

Duaer Driving route asks the public OSRM router for the fastest car route between two points, plus alternatives. Times assume free-flowing traffic.

## When to use

- Estimate the drive time between two sites.
- Compare route distances for a delivery plan.

## When not to use

- Places around a point. Use https://skills.duaer.com/places-nearby.md.
- Addresses to coordinates. Use https://skills.duaer.com/geocoding.md.

## Call

`GET https://api.duaer.com/v1/data/driving-route?from=51.5007,-0.1246&to=51.5081,-0.0759`

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 `from` and `to`.

- `from` — Start as latitude,longitude such as 51.5007,-0.1246.
- `to` — End as latitude,longitude such as 51.5081,-0.0759.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/driving-route?from=51.5007,-0.1246&to=51.5081,-0.0759` — Westminster to the Tower of London.
- `GET https://api.duaer.com/v1/data/driving-route?from=40.7580,-73.9855&to=40.6413,-73.7781` — Times Square to JFK airport.

## Result

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

- `route` — fastest or alternative number.
- `distanceKm`, `durationMin` — driving distance and time.
- `via` — main roads on the route.

No drivable route returns no rows.

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/places-nearby.md — Duaer Places nearby
- https://skills.duaer.com/geocoding.md — Duaer Place lookup

Questions

How many credits does a Driving route search use in Duaer?

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

Does Duaer Driving route use live traffic?

No. Times are estimated from road speeds, without congestion or roadworks.

In this section

Get started

Places nearby in Duaer

In Duaer: OpenStreetMap: cafes, pharmacies, hospitals, chargers, and other places near a point, nearest first. One successful search uses 1 credit.

Get started

Place lookup in Duaer

In Duaer: Turn a place name into coordinates, country, region, time zone, population, and elevation from the GeoNames gazetteer via Open-Meteo. One successful search uses 1 credit.