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

Production environment only

Legacy Base URL

Production environment only








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

Format specifier



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.


Substitute your own unique apikey.

Application Code - Legacy

Substitute your own unique app_code .

Application Id - Legacy

Substitute your own unique app_id.

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.
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see For examples of how to use the other authentication options with the Geocoder API, see Authentication Examples.

For further information, see: