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.

Element Value/Example Description
Base URL Production environment CIT environment: see HERE Server Environments
Path /places/v1/  
Resource autosuggest Get autocomplete suggestions for partial search queries. See Autosuggest Entrypoint
discover/search Find places using a completed text query. See Search Entrypoint
discover/voice Find places using a text query produced by some voice recognition software. See Voice Search Entrypoint
discover/explore Find recommended places with certain categories around a location. See Explore Entrypoint
browse Find places with certain categories around a location sorted by distance. See Browse Entrypoint
browse/by-corridor Find places with certain categories within a corridor area. See Browse by Corridor Entrypoint
browse/by-corridor/short Simplifies route required for the corridor search. See Corridor Shortener Entrypoint
discover/here Identify places at a location. See Here Entrypoint
discover/around Find places around a location. Similar to discover/explore, but optimized for 3D visual-exploration overlays. See Around Entrypoint
actions Report user interactions. See Actions Entrypoint
lookup Find a place by non-Place ID, e.g. PVID. See Lookup Entrypoint
categories/places Get place categories that are supported within a region. See Place Categories Entrypoint
categories/cuisines Get cuisines categories that are supported within a region. See Cuisine Categories Entrypoint
health Monitor the availability of the Places (Search) API See Health Entrypoint
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

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on