Introduction to HERE Batch API v7

HERE Batch API v7 is a REST API that allows you to batch process large data sets of Geocoding and Search requests. Currently supported endpoints are the /geocode, /revgeocode and /lookup. Batch processing is optimized for large batch jobs and there is a penalty for executing small jobs, such as those having less than 100 records.

Small jobs take longer to process as the startup time of a job is the same no matter the size.

The HERE Batch API v7 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 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.
• Lookup large data sets in one request, such as submitting a single file of HERE IDs to lookup their details. The request processing is asynchronous in all cases. HERE recommends you accumulate larger sets of addresses into fewer batch jobs. Jobs may be queued if they are submitted close to each other. The required startup time sums up for a higher number of smaller jobs, which it is required only once for one lager job.

📘

Note

As a general rule, a batch job should have either more than 100 records or be submitted at least 10 minutes after the previous job was submitted. Do not submit more

than one batch job per minute. A new job may be queued if previous jobs are not finished yet.

For information on:

• How to quickly set up and start using the HERE Batch API v7, see Get started - HERE platform.
• The terms and conditions covering this documentation, see the Documentation License.
• HERE is committed to respecting your privacy and to complying with applicable data protection and privacy laws. For more information, see the HERE Privacy Policy.

📘

Note

HERE Batch API v7 is not included in the HERE Base Plan. If you have questions about pricing, contact us.