- Web Services
- Directions API
Try the next generation of Directions features with the Routes API.
- Home
- Products
- Google Maps Platform
- Documentation
- Web Services
- Directions API
The Directions API uses a pay-as-you-go pricing model.Directions API requests generate calls to one of two SKUs depending on the type of request:basic or advanced.Along with the overall Google Terms of Use, there are usage limitsspecific to the Directions API.Manage your costs and usage with tools available in the Google Cloud Console.
How the Directions API is billed
The Directions API uses a pay-as-you-go pricing model. The Google Maps Platform APIsand SDKs are billed by SKU. Usage is tracked for each SKU, and any API or SDK may have more than oneproduct SKU. Cost is calculated by
SKU usage × Price per each use
Use our Pricingand Usage calculator to estimate your usage cost per API or SDK. For qualifyingGoogle Maps Platform SKUs, a $200 USD Google Maps Platform credit is available each monthfor each billing account. This credit is automaticallyapplied1 to the qualifying SKUs.
Pricing for the Directions API
SKU: Directions
A request to theMaps JavaScript API’s Directions Service (excludes requests triggering theDirections Advanced billing SKU) or theDirections API.
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
0.005 USD per each (5.00 USD per 1000) | 0.004 USD per each (4.00 USD per 1000) | Contact Sales for volume pricing |
SKU: Directions Advanced
A request to theMaps JavaScript API’s Directions Serviceor the Directions APIthat uses traffic information, more than 10 waypoints, waypoints optimization, and/or location modifiers.
MONTHLY VOLUME RANGE (Price per QUERY) | ||
---|---|---|
0.01 USD per each (10.00 USD per 1000) | 0.008 USD per each (8.00 USD per 1000) | Contact Sales for volume pricing |
A Directions Advanced SKU is charged for aMaps JavaScript API’s Directions Serviceor a Directions API request that uses one or more of the following:
- Traffic information. Traffic information is used when all the following apply (these are the conditions required to receive the duration_in_traffic field in the Directions response):
- The travel mode parameter is
driving
, or is not specified (driving
is the default travel mode). - The request includes a valid departure_time parameter. The
departure_time
can be set to the current time or some time in the future. It cannot be in the past. - The request does not include stopover waypoints. If the request includes waypoints, prefix each waypoint with
via:
to influence the route but avoid stopovers. For example,&waypoints=via:San Francisco|via:Mountain View|...
- The travel mode parameter is
- More than 10 waypoints (between 11 and 25).
- Waypoints optimization. The optimize parameter is set to
true
for waypoints. For example,&waypoints=optimize:true|San Francisco|Mountain View|...
- Location modifiers. When you use the following location modifiers to indicate how drivers should approach a particular location:
side_of_road
heading
Other usage limits
While there is no maximum number of requests per day, the followingusage limits are still in place for the Directions API:
- Maximum allowed number ofwaypoints per request:25
- Using 1–10 waypoints is billed at theDirections SKU rate.
- Using more than 10 waypoints (11–25) is billed at theDirections Advanced SKU rate.
- 3,000 QPM (requests per minute), calculated as the sum ofclient-side and server-side queries.
Terms of Use restrictions
For information on terms of use, seepolicies for the Directions API, and theLicense Restrictions sectionof the Google Maps Platform Terms of Service.
Manage your cost of use
To manage your cost of use of the Directions API or to meet the demands of your productiontraffic, set daily quota limits on all requests to any API. Daily quotas are reset atmidnight Pacific time.
To view or change quota limits for the Directions API:
- In the Cloud Console, open the Google Maps Platform Quotas page.
- Click the APIs drop-down and select the Directions API.
- To view the quota limits, scroll down to the Requests card.
A table lists the quota names and limits. - To change a quota limit, click the Edit icon for that limit.
In the dialog that appears, in the Quota Limit field, enter the preferred billable daily quota limit (up to the quota limit, if any, specified by Google) and select Save.
If your API usage reaches your billable quota limit on any given day, your application will notbe able to access the API for the remainder of that day.
Related cost management resources
Users in India must create a Google Cloud Platform billing account before creating a Google Maps Platformbilling account to receive the Maps Platform credit.↩
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-03-21 UTC.
[{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }]