Places (Search) API Developer's Guide

Suggest Entrypoint

The Suggest Entrypoint represents lists of suggested search terms related to a given (partial) search term and location context. This entrypoint is used to help users to provide suggested search terms to the user while typing.

The Suggest Entrypoint is a Places (Search) API Core entrypoint.

Entrypoint URI

/suggest

Entrypoint Parameters

Parameter Type Description
at Position (format: latitude,longitude[;cgen=(map|gps|sgps)][;u=\d+]); required, unless one of the Geolocation or X-Map-Viewport headers or the in are set. Coordinates of search location expressed as latitude, longitude. Additional parameters can be passed which provide more context such as the uncertainty and how the coordinates were generated. For example, "52.5304417,13.4111201", "52.5304417,13.4111201;cgen=gps;u=100" or "52.5304417,13.4111201;u=100". For a full description, see the Location Contexts documentation.
q String; required Plain-text search term. For example, "restaurant" or "Brandenburger Tor"

GET Method

The GET method returns the list of suggested search terms related to the partial search term.

The method allows applications to provide to application users query completion suggestions as they type.

Representation Modifiers

The following options are available in this context:

Parameter Type Description
size Number (non-negative integer); optional The maximum number of result items in each collection.

For additional information and examples, see Changing Responses with Representation Modifiers.

Response Media Type

Responses to requests to this endpoint will have the urn:nlp-types:suggest media type. See the urn:nlp-types:suggest media type documentation for details about the structure and content of the response.

Request Example


https://places.cit.api.here.com/places/v1/suggest
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&at=52.5304417,13.4111201
&q=rest
&pretty

Response Example

{
  "suggestions": [
    "Restaurant", 
    "Restaurant Fleischerei Berlin", 
    "Restorf, Lüchow-Dannenberg",
    "Rest area", 
    "Restaurant Fleischerei", 
    "Restaurant und Caffee Marrakesch", 
    "Simplicity Restaurant", 
    "Restaurant \"das pfeffer\"", 
    "Las Olas-Restaurant GmbH & Co.KG",
    "Ars Vini 1. Berliner Fondue Restaurant", 
    "Yam Yam Korean Restaurant", 
    "Restaurant Blaues Band", 
    "Kaffeehaus & Restaurant K\u00fcrbis Inh. Simon Eder",
    "Kaffeehaus & Restaurant Kurbis",
    "Restaurant Schmitz", 
    "Restaurant Luso", 
    "www.partycard.de Club Bar Restaurant Kino Food Disco Sport Berlin", 
    "Aapka - indisches Restaurant Berlin", 
    "Restaurant Frarosa"
  ]
}

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 selfservesupport@here.com.