Geocoder API Developer's Guide

Constructing a Request

A request to the Geocoder API includes the basic elements shown in the following table and, in addition, it may contain resource-specific parameters.

Table 1. Basic request elements
Element Value/Example Description

Base URL

https://geocoder.ls.hereapi.com

https://reverse.geocoder.ls.hereapi.com

Production environment only

Legacy Base URL

https://geocoder.api.here.com

https://reverse.geocoder.api.here.com

Production environment when you use an app_id/app_code pair. For more information, see Authentication Examples.

Path

/6.2/  

Resource

/geocode

/reversegeocode

/multi-reversegeocode

/search

GET only except for multi-reversegeocode (POST), specify request details via query parameters.

Format specifier

.xml

.json

Specifies whether XML or JSON output is required. The format specifier must follow the resource name, for example: .../geocode.xml?...

The default output format is XML.

API Key

&apiKey={YOUR_API_KEY} Substitute your own unique apiKey. For more information, see Authentication Examples.

Application Code - Legacy

&app_code={YOUR_APP_CODE} Substitute your own unique app_code. For more information, see Authentication Examples.

Application Id - Legacy

&app_id={YOUR_APP_ID} Substitute your own unique app_id. For more information, see Authentication Examples.

The following geocoding request combines the elements from the table above and adds the parameter searchtext. The request specifies that the required output is XML.

https://geocoder.ls.hereapi.com/6.2/geocode.xml
?apiKey={YOUR_API_KEY}
&searchtext=425+W+Randolph+Chicago
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 Geocoder API, see Authentication Examples.

For further information, see: