x
clear

Invalid app_id app_code combination

Launch demo env | Register your own app

Welcome to the Places API!

The HERE Places API is a web service API that allows your applications to use the HERE Places service as available on here.com, billions of Nokia phones and a huge variety of other applications.

In the playground you can explore the API to get a feel for what it provides.

Discover places

Use position, a visible map-view, categories and a free-text search query to discover places. The simplest case is the free text search query, which is provided by the discover/search resource. For example you might want to search for the famous antipodes coffee-shop in berlin:

If you look for a certain category of places that is supported by our category system, you might want to use the discover/explore endpoint. For example you might want to search for restaurants around the Nokia office in Berlin:

Also, it is possible to restrict the result of a discover/explore search to a radius. If you are not willing to walk for more than 500m for your restaurant, consider the following query:

Use your location

Additionally or alternatively to the explicit location context in the at and in parameter, an application can set implicit location contexts. If the application has a user-visible map it can send the viewport the user is currently looking at:

URL parameters

HTTP headers

If the application has access to the user’s position, it can send this as well:

URL parameters

HTTP headers

Refine search results

Setting the result_types parameter allows for retrieving places only, refined searches or both. A refined search helps the search engine to deal with ambiguity in user queries. This allows the application to suggest refinements to the user’s search.

Tune result representation

The Places API offers a number of representation modifiers. If you want to restrict the number of search results, e.g. to 5, you might want to add the size parameter:

X

Actions: