Geocoder Autocomplete API Developer's Guide

Constructing a Request

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

Table 1. Basic request elements
Element Value/Example Description
Legacy Base URL https://autocomplete.geocoder.api.here.com Production environment when you use an app_id/app_code pair. For more information, see Authentication Examples.
Base URL https://autocomplete.geocoder.ls.hereapi.com Production environment.
Path /6.2/  
Resource suggest GET only, specify request details via query parameters
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.
API Key ?apiKey={YOUR_API_KEY} Substitute your own unique apiKey. For more information, see Authentication Examples.

This example search request uses HTTP GET to request autocomplete suggestions for the search term Berli:

https://autocomplete.geocoder.ls.hereapi.com/6.2/suggest.json
?query=Berli
&apiKey={YOUR_API_KEY}
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 Autocomplete API, see Authentication Examples.