Introduction
The HERE Batch Geocoder API is a REST API that allows you to geocode and reverse geocode large data sets. Batch processing is optimized for large batch jobs and there is a penalty for executing small jobs, such as those having less than 10 addresses.
The Batch Geocoder API supports the following use cases:
- Geocode large data sets in one request, such as submitting a single file of addresses to request the corresponding geocoodinates. Addresses may use structured input or free-form search strings with complete or partial address information. The request processing is asynchronous. The more detailed the address you submit, the higher the potential match accuracy.
- Reverse geocode large data sets in one request, such as submitting a single file of geocoordinate/radius pairs to request the corresponding addresses. The request processing is asynchronous.
Although there are no technical limitations in place for either the minimum number of addresses in a batch job nor for the frequency or number of submitted batch jobs, HERE recommends you accumulate larger sets of addresses into fewer batch jobs to receive a faster response.
Note: As a general rule, a batch job should have either more than 100 addresses or be submitted at least 10 minutes after the previous job was submitted. Under no circumstances should a batch job be submitted more often than once a minute.
For information on:
- How to quickly set up and start using the Batch Geocoder API, see Quick Start.
- The terms and conditions covering this documentation, see the HERE Documentation License.
