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.
| 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 the Identity & Access Management Developer Guide. |
| Legacy Base URL | https://places.api.here.com | Production environment when you use an app_id/app_code pair. For more information, see the Identity & Access Management Developer Guide. |
| 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. | |
discover/explore | Recommended places matching specific categories around 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 the Identity & Access Management Developer Guide. |
| Application Code - Legacy | &app_code={YOUR_APP_CODE} | Substitute with your own unique app_code. For more information, see the Identity & Access Management Developer Guide. |
| API Key | ?apiKey={YOUR_API_KEY} | Substitute with your own unique apiKey. For more information, see the Identity & Access Management Developer Guide. |
Here is an example of a search request, which uses the HTTP GET method:
https://places.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 the available authentication options, see the Identity & Access Management Developer Guide.
Note: apiKey is supported to make initial requests, but keep in mind that any services returning URLs (like autosuggest, discover, etc.) will have app_id and app_code appended instead of apiKey.
