Places (Search) API Developer's Guide

Constructing a Request

A request to the Places (Search) API includes the basic elements shown in the following table and, in addition, may contain resource-specific parameters.

Table 1. Basic Request Elements
Element Value/Example Description
Base URL https://places.ls.hereapi.com Production environment when you use an API Key or an authentication token. For more information, see Authentication Examples.
https://places.sit.ls.hereapi.com CIT environment

For information about the available environments, see HERE Server Environments

Legacy Base URL https://places.api.here.com Production environment when you use an app_id/app_code pair. For more information, see Authentication Examples.
https://places.cit.api.here.com CIT environment

For information about the available environments, see HERE Server Environments

Path /places/v1/  
Resource actions Report user interactions.
autosuggest Get autocomplete suggestions to build up search queries.
browse Find places matching specific categories around a location sorted by distance.
browse/by-corridor Find places matching specific categories within a corridor area.
discover/around Find places around a location. Similar to discover/explore, but optimized for 3D visual-exploration overlays.
discover/explore Recommended places matching specific categories around a location.
discover/here Identify places at a location.
discover/search Find places using a text query.
health Monitor the availability of the Places (Search) API
lookup Find a place using identifiers not originating from the Places (Search) API, for example PVIDs from HERE maps.
Application Id - Legacy ?app_id={YOUR_APP_ID} Substitute with your own unique app_id
Application Code - Legacy &app_code={YOUR_APP_CODE} Substitute with your own unique app_code
API Key ?apikey={YOUR_APIKEY} Substitute with your own unique apikey

Here is an example of a search request, which uses the HTTP GET method:

https://places.sit.ls.hereapi.com/places/v1/discover/search
?apikey={YOUR_APIKEY}
&at=52.531,13.3843
&q=Brandenburg+Gate
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see https://developer.here.com/documentation/authentication. For examples of how to use the other authentication options with the Places (Search) API, see Authentication Examples.