Bulk (batch) geocoding converts many addresses or places to coordinates in a single API call instead of one request per address. The Stadia Maps Bulk Geocoding API accepts up to 5,000 forward or structured geocoding queries per HTTP request, streams results back as they complete, and consumes the same per-query credits as individual requests, with no extra fees.

Since we launched our geocoding product, we've learned a lot about what developers need to build applications that convert addresses, places, and more to coordinates. While we've always supported forward, reverse, and structured queries, one thing we haven't supported is making multiple queries in one request. Bulk (also known as batch) geocoding makes it faster and simpler to geocode many addresses at once. Whether supporting a batch job or improving performance of multiple simultaneous requests, our new Bulk Geocoding API helps developers build more efficient solutions based on the same, high-quality Geocoding API they already know.

How Many Addresses Can You Geocode in One Request?

With the new API, you can make up to 5,000 geocoding queries with a single HTTP request. Both forward geocoding and structured geocoding are supported. You can even combine multiple request types in a single bulk request!

By using the bulk endpoint instead of individual requests, your queries will be faster. The endpoints' internal parallelization will simultaneously improve throughput, reduce total latency, and simplify the calling code. This new endpoint is useful in environments without easy access to lightweight concurrency and connection pooling, where each request incurs the connection establishment overhead. Older web frameworks, lower-level code, and shell scripts will especially benefit from opting for the bulk endpoint over the standard endpoints.

For particularly latency sensitive applications, you can also process the results as they are produced. The endpoint streams the results back as a JSON body, enabling much lower time-to-first-result if required.

How Much Does Bulk Geocoding Cost?

Bulk geocoding is available for all accounts subscribed to our Standard and Professional plans. Each request consumes credits as if you made a request to the underlying endpoint directly, so there are no additional fees or credits used. You can find how many credits each API call consumes in our credit schedule.

Which SDKs and Languages Support Bulk Geocoding?

As usual, our official SDKs are already updated with support for the new API. You can access it from JavaScript, Python, Kotlin, Swift or PHP without writing any new network or parsing code! You can even find a curl example in our API documentation so your shell scripts aren't left behind.

Learn More & Next Steps