Batch Geocoder API Developer's Guide

Reverse geocoding

The user wants to request a set of addresses corresponding to a data set of locations.

Request

The POST request below includes a key/value pair mode=retrieveAddresses that indicates the request is for reverse geocoding. Also specify the HTTP-Header Content-Type=text/plain.

https://batch.geocoder.ls.hereapi.com/6.2/jobs
?apiKey={YOUR_API_KEY}
&action=run
&header=true
&indelim=%7C
&outdelim=%7C
&outcols=displayLatitude%2CdisplayLongitude%2ClocationLabel%2ChouseNumber%2Cstreet%2Cdistrict%2Ccity%2CpostalCode%2Ccounty%2Cstate%2Ccountry
&outputCombined=false
&mode=retrieveAddresses
Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
This POST body includes the locations:
recId|prox
0001|52.505308,13.327739,250
0002|49.917257,8.486488,250
0003|51.119593,7.399356,250
0004|49.20012,8.12326,250
0005|51.116845,7.397318,250
0006|52.265938,7.976922,250
0007|48.143131,10.829233,250
0008|51.770237,7.442682,250
0009|51.511877,7.461382,250
0010|52.53,13.391389,250

Response

The response contains a RequestID. Use this RequestID for all actions you want to perform on this job.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:SearchBatch xmlns:ns2="http://www.navteq.com/lbsp/Search-Batch/1">
  <Response>
    <MetaInfo>
      <RequestId>E2bc948zBsMCG4QclFKCq3tddWYCsE9g</RequestId>
    </MetaInfo>
    <Status>accepted</Status>
    <TotalCount>0</TotalCount>
    <ValidCount>0</ValidCount>
    <InvalidCount>0</InvalidCount>
    <ProcessedCount>0</ProcessedCount>
    <PendingCount>0</PendingCount>
    <SuccessCount>0</SuccessCount>
    <ErrorCount>0</ErrorCount>
  </Response>
</ns2:SearchBatch>

You can download the result of the job request as a zip file. For an example of how to download the results, see Get Job Results.