Directions and travel time
~1 credits / route (up to 3)Calculates the route, total distance, and estimated travel time between two or more locations for a chosen travel mode: driving, walking, cycling, or truck. You can also request turn-by-turn steps when you need the full route breakdown. Note that travel times are based on free-flow conditions, not live traffic.
Use when
You want how far or how long between two or more places, or a route, by a travel mode.
Not for
Live-traffic ETAs, public-transit schedules, or ride-share pricing.
Cost
~1 credits / route (up to 3)
Resolving named endpoints to coordinates first can add a lookup per endpoint.
Estimated; the actual charge depends on your input and is shown in the response.
What it accepts
Set these inside the intent when you run it.
Starting point as a place name, address, or coordinates.
End point as a place name, address, or coordinates.
How to travel. One of drive, walk, bicycle, or truck. Defaults to drive.
Additional stops along the route, in travel order.
Distance units. Use metric for km or imperial for miles. Inferred from location if not set.
What you get back
Total distance and estimated travel time for the route, plus optional turn-by-turn steps for each leg.
Run it
Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Maps skill will route from your intent instead.)
curl -X POST "https://skill.askfaro.com/skills/maps/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"operation":"directions","origin":"Eiffel Tower, Paris","destination":"Louvre Museum, Paris","travel_mode":"walk","waypoints":"Notre-Dame Cathedral","units":"metric"}}'Example requests
- ›How long does it take to drive from Paris to Lyon?
- ›Walking directions from the Colosseum to the Vatican
- ›How far is it to cycle from Copenhagen city centre to the airport?