Bulk Geocoding API Is Now Available

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.

Make up to 5000 Queries—Simultaneously

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 requests 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.

The Same Simple, Affordable Pricing

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 underlying endpoint directly, so there's no additional fees or credits used. You can find how many credits each API call consumes in our credit schedule.

Available in our SDKs, cURL, and Everything In-Between

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

Talk to us on Slack!

Just two simple steps.
  1. Join OSM US Slack.
  2. Join the #stadia-maps channel.