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 when you use an app_id/app_code pair. For more information, see Authentication Examples

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. For more information, see Authentication Examples.
Application Code - Legacy &app_code={YOUR_APP_CODE} Substitute with your own unique app_code. For more information, see Authentication Examples.
API Key ?apiKey={YOUR_API_KEY} 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_API_KEY}
&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 Authentication Guide. For examples of how to use the other authentication options with the Places (Search) API, see Authentication Examples.