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.
The Places API let's you discover places based on parameters like a position, a visible map-view, categories, and a free-text search query. 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:
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:
If the application has access to the user’s position, it can send this as well:
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.
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: