Service Limits¶
Which APIs can I access?¶
Your Stadia Maps account gives access to a subset of APIs based on your selected plan.
If you try to access an API which you do not have access to,
you will receive a 403 Forbidden response.
Throughout our documentation,
we clarify when a feature is not available on all plans using a grid like the one below
(indicating that the free tier cannot access a feature):
Free
Starter
Standard
Professional
A full list of features included with each plan is available on our pricing page.
Who can use the free tier?¶
Our free tier is available for development, evaluation, and non-commercial use (including academic use). Other uses require a paid subscription. See our FAQ for more details on what uses are deemed to be commercial.
You can upgrade your free subscription to a paid plan at any time.
What happens when I run out of credits?¶
After you use all of your credits for a billing period (calendar month for free accounts), our default action is to hard limit until the start of the next billing cycle or plan upgrade (all APIs will respond with HTTP 429 Rate Limit Exceeded). This protects you from unexpected bills.
Our system will automatically email you when you have exhausted 80% of your credits and are about to be hard limited, so please ensure that you give us an email which you check regularly.
If you want to keep serving requests beyond the plan limits, we offer opt-in pay-as-you-go billing with straightforward pricing on the additional credits. See our pricing page for details.
What are your rate limits?¶
We reserve the right to impose rate limits on customers who are abusive or disruptive of service. Contact enterprise sales to discuss higher volume usage.
We also enforce rate limits on local development to prevent abuse. While we do not publish exact limits for local development, it should be usable without issue for most applications. After the limit is exceeded, you will receive HTTP 429 responses for a while. Access via a registered domain or API key is not subject to the same restrictions.
If you expect to be sending requests at a high rate or want to ensure your use case won't be a problem, send us an email and our ops team will coordinate with you to ensure smooth service.
Proxying and Bulk Downloading
Note that proxying and bulk downloading/caching (with few exceptions) are prohibited by our general terms of service. Unless you have an enterprise agreement which allows this, such behavior will typically result in escalating de-prioritization of requests and ultimately a rate limit.
What limits are there on API call complexity?¶
We impose the complexity limits on certain APIs. If you have a more demanding use case, send us a message, and we can discuss your use case. We're happy to discuss higher limits for enterprise customers.
Standard Routing¶
The following complexity limits apply to standard routing requests.
| Costing/mode of travel | Max locations per route | Max b-line distance between all locations |
|---|---|---|
| Automobile, truck, and taxi | 20 | 5000 kilometers |
| Bus | 50 | 5000 kilometers |
| Bicycle, bikeshare, motor scooter, and motorcycle | 50 | 500 kilometers |
| Low speed vehicle, pedestrian | 50 | 250 kilometers |
Optimized Routing¶
The following limits apply to optimized routing requests.
| Costing/mode of travel | Max locations per route | Max b-line distance between all locations |
|---|---|---|
| Automobile, bus, truck, and taxi | 50 | 400 kilometers |
| All others | 50 | 200 kilometers |
Time/Distance Matrix¶
We limit time/distance matrix complexity on two dimensions: the number of matrix elements and the straight-line distance between all locations.
Matrix elements are a simple multiplication of the dimensions of the input. For example, a request with 3 sources (origins) and 5 targets (destinations) has 3 x 5 = 15 elements. The size limits depend on your plan.
| Costing/mode of travel | Max elements (Standard) | Max elements (Professional) | Max b-line distance between all locations |
|---|---|---|---|
| Automobile, bus, truck, and taxi | 625 | 10,000 | 400 kilometers |
| All others | 625 | 10,000 | 200 kilometers |
Bulk Geocoding¶
Bulk geocoding requests may contain up to 5,000 queries.