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 information on other possible options, see Authentication Guide. For examples of how to use the other authentication options with the Batch Geocoder API, see Authentication Examples.
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.