OpenWeb Ninja
Driving Directions API
Get driving directions and best routes from an origin to a destination in real-time, from Google Maps.
API Data Samples
Response data samples of the different kinds of objects the API provides
Driving Directions Response
{
"best_routes": [
{
"route_name": "I-280 S",
"distance_meters": 73562,
"distance_label": "45.7 miles",
"duration_seconds": 2871,
"duration_label": "48 min",
"min_duration_seconds": 2537,
"max_duration_seconds": 3656,
"highlights": [
"Fastest route now due to traffic conditions"
],
"distance_timing_meters_seconds": {
"0": 0,
"9": 2,
"187": 40,
"276": 53,
"328": 70,
"...": "..."
},
"notes": [],
"departure_timestamp": 1733345056,
"departure_datetime_utc": "2024-12-04T20:44:16.000Z",
"arrival_timestamp": 1733347927,
"arrival_datetime_utc": "2024-12-04T21:32:07.000Z",
"route_parts": [
{
"summary": "Get on I-280 S from San Jose Avenue",
"distance_meters": 2434,
"distance_label": "1.5 mi",
"duration_seconds": 225,
"duration_label": "4 min",
"instructions": [
{
"summary": "Head east on 29th St toward Dolores St",
"distance_meters": 188,
"distance_label": "0.1 mi",
"duration_seconds": 34,
"duration_label": "34 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=vJ-VkqrqDkt6vroNpN_3oA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=73.96842&pitch=0&thumbfov=100"
},
{
"summary": "Turn right at the 1st cross street onto Dolores St",
"distance_meters": 368,
"distance_label": "0.2 mi",
"duration_seconds": 77,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=wiT_N6AtRwU1YngnpAdmoQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=275.4786&pitch=0&thumbfov=100"
},
{
"summary": "Turn right onto San Jose Avenue",
"distance_meters": 1239,
"distance_label": "0.8 mi",
"duration_seconds": 84,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=t3UKyZ9G4JOh12EH8Eap2w&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=188.09184&pitch=0&thumbfov=100"
},
{
"summary": "Use any lane to merge onto I-280 S via the ramp to Daly City",
"distance_meters": 639,
"distance_label": "0.4 mi",
"duration_seconds": 30,
"duration_label": "30 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=ylG9j4FRNtutcETBcxrViQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=59.24323&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Follow I-280 S to N De Anza Blvd in Cupertino. Take exit 11 from I-280 S",
"distance_meters": 66939,
"distance_label": "41.6 mi",
"duration_seconds": 2234,
"duration_label": "37 min",
"instructions": [
{
"summary": "Merge onto I-280 S",
"distance_meters": 66615,
"distance_label": "41.4 mi",
"duration_seconds": 2201,
"duration_label": "37 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=LpzaL4U1bVETaf0TKM0xgQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=33.9227&pitch=0&thumbfov=100"
},
{
"summary": "Take exit 11 for De Anza Blvd",
"distance_meters": 324,
"distance_label": "0.2 mi",
"duration_seconds": 33,
"duration_label": "33 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=-KPQa2RUKRRDM_qqYTELOw&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=269.7714&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Take Sunnyvale Saratoga Rd to El Camino Real in Sunnyvale",
"distance_meters": 4189,
"distance_label": "2.6 mi",
"duration_seconds": 413,
"duration_label": "7 min",
"instructions": [
{
"summary": "Use the left 2 lanes to turn left onto N De Anza Blvd",
"distance_meters": 448,
"distance_label": "0.3 mi",
"duration_seconds": 71,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=RybpYDTMniBDrpbVVPFCew&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=296.76553&pitch=0&thumbfov=100"
},
{
"summary": "Continue onto Sunnyvale Saratoga Rd",
"distance_meters": 2927,
"distance_label": "1.8 mi",
"duration_seconds": 261,
"duration_label": "4 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=2RXqqr2Uc0nTVIatge0zLg&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=359.65778&pitch=0&thumbfov=100"
},
{
"summary": "Continue straight onto S Mathilda Ave",
"distance_meters": 761,
"distance_label": "0.5 mi",
"duration_seconds": 72,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=cP9rjq_Sfy4tSJIjccVBjQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=328.55533&pitch=0&thumbfov=100"
},
{
"summary": "Turn right onto El Camino Real",
"distance_meters": 53,
"distance_label": "174 ft",
"duration_seconds": 9,
"duration_label": "9 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=CFvtNEDzTRUzh_ooK5AW9g&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=185.75015&pitch=0&thumbfov=100"
}
]
}
]
},
{
"route_name": "US-101 S",
"distance_meters": 63470,
"distance_label": "39.4 miles",
"duration_seconds": 2839,
"duration_label": "47 min",
"min_duration_seconds": 2545,
"max_duration_seconds": 4160,
"highlights": [],
"distance_timing_meters_seconds": {
"0": 0,
"9": 2,
"325": 69,
"354": 77,
"414": 91,
"...": "..."
},
"notes": [],
"departure_timestamp": 1733345056,
"departure_datetime_utc": "2024-12-04T20:44:16.000Z",
"arrival_timestamp": 1733347895,
"arrival_datetime_utc": "2024-12-04T21:31:35.000Z",
"route_parts": [
{
"summary": "Get on US-101 S from Cesar Chavez St",
"distance_meters": 2388,
"distance_label": "1.5 mi",
"duration_seconds": 405,
"duration_label": "7 min",
"instructions": [
{
"summary": "Head east on 29th St toward Dolores St",
"distance_meters": 506,
"distance_label": "0.3 mi",
"duration_seconds": 114,
"duration_label": "2 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=vJ-VkqrqDkt6vroNpN_3oA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=73.96842&pitch=0&thumbfov=100"
},
{
"summary": "Turn left onto Mission St",
"distance_meters": 506,
"distance_label": "0.3 mi",
"duration_seconds": 88,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=cG74tV6Ehmz8TijgE8ezfA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=63.660633&pitch=0&thumbfov=100"
},
{
"summary": "Turn right onto Cesar Chavez St",
"distance_meters": 1056,
"distance_label": "0.7 mi",
"duration_seconds": 177,
"duration_label": "3 min",
"notes": [
"Pass by AutoZone Auto Parts (on the left)"
],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=-GKwk-gho6mOvevRVuXOJA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=167.44937&pitch=0&thumbfov=100"
},
{
"summary": "Use the right lane to take the ramp onto US-101 S",
"distance_meters": 320,
"distance_label": "0.2 mi",
"duration_seconds": 26,
"duration_label": "26 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=wcm1pzdaLu_Sp5FDPMJLkQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=138.134&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Follow US-101 S to N Mathilda Ave in Sunnyvale. Take exit 396A from US-101 S",
"distance_meters": 57706,
"distance_label": "35.9 mi",
"duration_seconds": 2081,
"duration_label": "35 min",
"instructions": [
{
"summary": "Merge onto US-101 S",
"distance_meters": 57376,
"distance_label": "35.7 mi",
"duration_seconds": 2050,
"duration_label": "34 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=u01juvVlhSTlB-AAVtQDKw&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=3.4890876&pitch=0&thumbfov=100"
},
{
"summary": "Take exit 396A for Mathilda Ave",
"distance_meters": 330,
"distance_label": "0.2 mi",
"duration_seconds": 31,
"duration_label": "31 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=sAO3umxi7P3UQ6IjIB_3uA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=104.554504&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Follow N Mathilda Ave to El Camino Real",
"distance_meters": 3376,
"distance_label": "2.1 mi",
"duration_seconds": 354,
"duration_label": "6 min",
"instructions": [
{
"summary": "Use the right 2 lanes to turn right onto N Mathilda Ave",
"distance_meters": 3287,
"distance_label": "2.0 mi",
"duration_seconds": 333,
"duration_label": "6 min",
"notes": [
"Pass by PNC Bank (on the right in 1.5 mi)"
],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=nm5zhixAlufBUDhxbC-uqg&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=287.45258&pitch=0&thumbfov=100"
},
{
"summary": "Use the left 2 lanes to turn left onto El Camino Real",
"distance_meters": 89,
"distance_label": "292 ft",
"duration_seconds": 21,
"duration_label": "21 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=W_uEiaOpfxu7Do4pe3kSwg&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=230.76291&pitch=0&thumbfov=100"
}
]
}
]
},
{
"route_name": "I-280 S and US-101 S",
"distance_meters": 66900,
"distance_label": "41.6 miles",
"duration_seconds": 2792,
"duration_label": "47 min",
"min_duration_seconds": 2530,
"max_duration_seconds": 3941,
"highlights": [],
"distance_timing_meters_seconds": {
"0": 0,
"9": 2,
"187": 40,
"276": 53,
"328": 70,
"...": "..."
},
"notes": [],
"departure_timestamp": 1733345056,
"departure_datetime_utc": "2024-12-04T20:44:16.000Z",
"arrival_timestamp": 1733347848,
"arrival_datetime_utc": "2024-12-04T21:30:48.000Z",
"route_parts": [
{
"summary": "Get on I-280 S from San Jose Avenue",
"distance_meters": 2434,
"distance_label": "1.5 mi",
"duration_seconds": 225,
"duration_label": "4 min",
"instructions": [
{
"summary": "Head east on 29th St toward Dolores St",
"distance_meters": 188,
"distance_label": "0.1 mi",
"duration_seconds": 34,
"duration_label": "34 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=vJ-VkqrqDkt6vroNpN_3oA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=73.96842&pitch=0&thumbfov=100"
},
{
"summary": "Turn right at the 1st cross street onto Dolores St",
"distance_meters": 368,
"distance_label": "0.2 mi",
"duration_seconds": 77,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=wiT_N6AtRwU1YngnpAdmoQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=275.4786&pitch=0&thumbfov=100"
},
{
"summary": "Turn right onto San Jose Avenue",
"distance_meters": 1239,
"distance_label": "0.8 mi",
"duration_seconds": 84,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=t3UKyZ9G4JOh12EH8Eap2w&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=188.09184&pitch=0&thumbfov=100"
},
{
"summary": "Use any lane to merge onto I-280 S via the ramp to Daly City",
"distance_meters": 639,
"distance_label": "0.4 mi",
"duration_seconds": 30,
"duration_label": "30 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=ylG9j4FRNtutcETBcxrViQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=59.24323&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Follow I-280 S and US-101 S to N Mathilda Ave in Sunnyvale. Take exit 396A from US-101 S",
"distance_meters": 61090,
"distance_label": "38.0 mi",
"duration_seconds": 2214,
"duration_label": "37 min",
"instructions": [
{
"summary": "Merge onto I-280 S",
"distance_meters": 13884,
"distance_label": "8.6 mi",
"duration_seconds": 494,
"duration_label": "8 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=LpzaL4U1bVETaf0TKM0xgQ&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=33.9227&pitch=0&thumbfov=100"
},
{
"summary": "Use the right lane to take exit 43A for I-380 toward US-101/S F Intl Airport",
"distance_meters": 801,
"distance_label": "0.5 mi",
"duration_seconds": 35,
"duration_label": "35 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=vtMqBZLHXRgLRsOarax7sA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=315.0639&pitch=0&thumbfov=100"
},
{
"summary": "Continue onto I-380 E",
"distance_meters": 1609,
"distance_label": "1.0 mi",
"duration_seconds": 60,
"duration_label": "1 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=itB6usRZLnCefBlpFnkUfA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=232.78703&pitch=0&thumbfov=100"
},
{
"summary": "Use the right 2 lanes to take exit 6A to merge onto US-101 S toward San Jose",
"distance_meters": 44466,
"distance_label": "27.6 mi",
"duration_seconds": 1594,
"duration_label": "27 min",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=Avkg658UMvZtNujUrHRJ1Q&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=278.438&pitch=0&thumbfov=100"
},
{
"summary": "Take exit 396A for Mathilda Ave",
"distance_meters": 330,
"distance_label": "0.2 mi",
"duration_seconds": 31,
"duration_label": "31 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=sAO3umxi7P3UQ6IjIB_3uA&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=104.554504&pitch=0&thumbfov=100"
}
]
},
{
"summary": "Follow N Mathilda Ave to El Camino Real",
"distance_meters": 3376,
"distance_label": "2.1 mi",
"duration_seconds": 354,
"duration_label": "6 min",
"instructions": [
{
"summary": "Use the right 2 lanes to turn right onto N Mathilda Ave",
"distance_meters": 3287,
"distance_label": "2.0 mi",
"duration_seconds": 333,
"duration_label": "6 min",
"notes": [
"Pass by PNC Bank (on the right in 1.5 mi)"
],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=nm5zhixAlufBUDhxbC-uqg&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=287.45258&pitch=0&thumbfov=100"
},
{
"summary": "Use the left 2 lanes to turn left onto El Camino Real",
"distance_meters": 89,
"distance_label": "292 ft",
"duration_seconds": 21,
"duration_label": "21 sec",
"notes": [],
"photo_url": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=W_uEiaOpfxu7Do4pe3kSwg&cb_client=maps_sv.tactile.gps&w=1024&h=768&yaw=230.76291&pitch=0&thumbfov=100"
}
]
}
]
}
],
"origin": {
"google_id": "0x808f7e68549a4ca1:0xc6055db04d6c9cb0",
"name": "Church St & 29th St",
"latitude": 37.74359,
"longitude": -122.42658,
"full_address": "Church St & 29th St, San Francisco, CA 94131",
"address": "San Francisco, CA 94131"
},
"destination": {
"google_id": "0x808fb645a9d05d3b:0x768dfb26dd7cc3a2",
"name": "Sunnyvale",
"latitude": 37.368829999999996,
"longitude": -122.0363496,
"full_address": "Sunnyvale, California",
"address": "California"
},
"directions_link": "https://www.google.com/maps/dir/Church+St+%26+29th+St,+San+Francisco,+CA+94131/Sunnyvale,+California/data=!4m17!4m16!1m5!1m1!1s0x808f7e68549a4ca1:0xc6055db04d6c9cb0!2m2!1d-122.42658!2d37.74359!1m5!1m1!1s0x808fb645a9d05d3b:0x768dfb26dd7cc3a2!2m2!1d-122.0363496!2d37.368829999999996!2m2!2b1!3b1!3e0"
}Key Features & Capabilities
The main features and capabilities supported by the API
- Turn-by-turn navigation instructions
- Real-time traffic information
- Alternative routes suggestions
- Distance and duration estimates
- Waypoint support
API Docs & Code Examples
Please find our API docs and try the API on the RapidAPI Playground. Code samples are available for all language and frameworks - JavaScript / Node.js, Python, Java, Ruby, cURL, and more:
Why Use OpenWeb Ninja Driving Directions API?
To provide you with top quality API, we work hard every day keeping it fast and reliable while contantly taking user feedback and looking to add new capabilities and features.
Comprehensive
Get detailed driving directions with traffic data and alternative routes from Google Maps.
Reliable
Access the same routing engine used by millions of Google Maps users.
Lightning Fast
Get directions within seconds for smooth user experience.
Scalable
Handle thousands of direction requests with our robust infrastructure.
Real-Time Data
Access up-to-date traffic and routing information.
Free Tier
Start with our free tier for easy testing and integration (no credit card required).
Plans and Pricing
If the plans below do not meet your needs, please contact us for a custom pricing plan.
FAQ
Most common questions and answers
