{"uid":"cap_8qMtT9LnhGMAipWeSfWXe","slug":"agents-openwebninja-com-get-driving-directions-b8c397a6","name":"Get Driving Directions","description":"Get driving directions from an origin to a destination.","url":"https://agents.openwebninja.com/driving-directions/get-directions?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["origin","destination"],"properties":{"origin":{"type":"string","description":"Directions origin / starting point - specified as free-text location query or latitude, longitude pair.  \n\n  **Examples:**  \n  `Church St & 29th St, San-Francisco, CA, USA`  \n  `37.743292, -122.420437`"},"country":{"type":"string","default":"US","description":"The country/region to use for the query, specified as a 2-letter country code - see `ISO 3166-1 alpha-2`."},"language":{"type":"string","default":"EN","description":"The language to use for the query, specified as a 2-letter language code - see `ISO 639-1 alpha-2`."},"destination":{"type":"string","description":"Directions destination - specified as free-text location query or latitude, longitude pair.  \n\n  **Examples:**  \n  `145 5th Ave, New York, NY, USA`  \n  `40.649238, -73.974229`"},"arrival_time":{"type":"number","default":0,"description":"Arrival time - specified as a Unix-Timestamp in destination local time.  \n\n  **Example:** `1665752460`"},"avoid_routes":{"type":"string","description":"Route types to avoid - specified as a comma delimited list of the following values: `tolls`, `highways`, `ferries`.  \n\n  **Examples:**  \n  `ferries,tolls`  \n  `highways`"},"departure_time":{"type":"number","default":0,"description":"Departure time - specified as a Unix-Timestamp in origin local time.  \n\n  **Example:** `1665785617`"},"distance_units":{"enum":["auto","km","mi"],"type":"string","default":"auto","description":"Set the distance units in the response to Kilometers or Miles.  \n  The default auto value will use the common distance units used in origin/destination (e.g. Miles in the US, Kilometers in Germany)."}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"origin":{"type":"object","properties":{"name":{"type":"string","description":"Name of the origin location"},"address":{"type":"string","description":"Short address of the origin"},"latitude":{"type":"number","description":"Latitude coordinate of the origin"},"google_id":{"type":"string","description":"Google Places ID for the origin"},"longitude":{"type":"number","description":"Longitude coordinate of the origin"},"full_address":{"type":"string","description":"Complete address of the origin"}}},"best_routes":{"type":"array","items":{"type":"object","properties":{"route_name":{"type":"string","description":"Name or identifier of the route"},"route_parts":{"type":"array","items":{"type":"object","properties":{"summary":{"type":"string","description":"Brief description of the route part"},"instructions":{"type":"array","items":{"type":"object","properties":{"photo_url":{"type":"string","description":"URL of an instructional photo"}}}},"distance_label":{"type":"string","description":"Human-readable distance for this part"},"duration_label":{"type":"string","description":"Human-readable duration for this part"},"distance_meters":{"type":"integer","description":"Distance of this route part in meters"},"duration_seconds":{"type":"integer","description":"Duration of this route part in seconds"}}}},"distance_label":{"type":"string","description":"Human-readable distance description"},"duration_label":{"type":"string","description":"Human-readable duration description"},"distance_meters":{"type":"integer","description":"Total route distance in meters"},"duration_seconds":{"type":"integer","description":"Estimated travel time in seconds"},"arrival_timestamp":{"type":"integer","description":"Arrival time as Unix timestamp"},"departure_timestamp":{"type":"integer","description":"Departure time as Unix timestamp"},"arrival_datetime_utc":{"type":"string","description":"Arrival time in UTC ISO format"},"max_duration_seconds":{"type":"integer","description":"Maximum expected travel time in seconds"},"min_duration_seconds":{"type":"integer","description":"Minimum expected travel time in seconds"},"departure_datetime_utc":{"type":"string","description":"Departure time in UTC ISO format"}}}},"destination":{"type":"object","properties":{"name":{"type":"string","description":"Name of the destination location"},"address":{"type":"string","description":"Short address of the destination"},"latitude":{"type":"number","description":"Latitude coordinate of the destination"},"google_id":{"type":"string","description":"Google Places ID for the destination"},"longitude":{"type":"number","description":"Longitude coordinate of the destination"},"full_address":{"type":"string","description":"Complete address of the destination"}}},"directions_link":{"type":"string","description":"URL to view directions on maps"}}},"status":{"type":"string","description":"The status of the API response"},"request_id":{"type":"string","description":"Unique identifier for the API request"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_FYJrcKzWy5zpxmyVFxH97","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Returns turn-by-turn driving directions with multiple route options, distances, and durations between an origin and destination.","exampleAgentPrompt":"Can you get me driving directions from Church St & 29th St in San Francisco to 145 5th Ave in New York, avoiding tolls and ferries, with distances shown in miles?","exampleUseCases":[{"title":"Road trip route planning","prompt":"I'm driving from Chicago, IL to Nashville, TN this Friday — can you get me driving directions avoiding highways, and show the distance in miles?"},{"title":"Commute time estimation","prompt":"How long will it take me to drive from 37.743292, -122.420437 to San Francisco International Airport if I leave tomorrow at 8am? Show distances in miles."},{"title":"Avoiding tolls on a delivery route","prompt":"Get me driving directions from Brooklyn Bridge, New York to JFK Airport avoiding tolls and ferries — I need the best route with turn-by-turn steps."}],"resultDescription":"Returns an object containing resolved origin and destination details (name, address, coordinates, Google Places ID), and an array of best routes each with a route name, total distance (in meters and human-readable label), total duration (in seconds and human-readable label), departure and arrival timestamps, and route parts broken down into individual segments with summaries, distance, duration, and turn-by-turn instructions.","failureModes":["Unresolvable origin or destination address returns an error or empty result","Invalid Unix timestamps for departure/arrival time may cause unexpected behavior","Unsupported country or language codes may fall back to defaults or return errors","Network or upstream API failures may produce 5xx responses","Overly vague location queries may resolve to incorrect or ambiguous locations"],"whenToPreferThis":"Choose this endpoint when you need structured driving directions with turn-by-turn instructions, multi-route options, and time/distance calculations between two arbitrary locations. It supports both free-text addresses and lat/lng coordinates, route avoidance preferences, and localized distance units, making it ideal for navigation, logistics, and trip-planning agents. Prefer it over generic mapping lookups when you need full route details including step-by-step instructions and timestamps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:36:58.476Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-get-driving-directions-b8c397a6"}