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, it may contain resource-specific parameters.

Table 1. Basic Request Elements
Element Value/Example Description
Base URL https://places.api.here.com Production environment
https://places.cit.api.here.com CIT environment

For information about the available evironments, 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.
categories/places Get place categories that are supported within a region.
categories/cuisines Get cuisines categories that are supported within a region.
discover/around Find places around a location. Similar to discover/explore, but optimized for 3D visual-exploration overlays.
discover/explore Find 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 ?app_id={YOUR_APP_ID} Substitute with your own unique app_id
Application Code &app_code={YOUR_APP_CODE} Substitute with your own unique app_code

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

https://places.cit.api.here.com/places/v1/discover/search
      ?app_id={YOUR_APP_ID}
      &app_code={YOUR_APP_CODE}
      &at=52.531,13.3843
      &q=Brandenburg+Gate