Places (Search) API Developer's Guide

Autosuggest Media Type

The autosuggest media type describes suggested places and searches

Media Type URI

urn:nlp-types:autosuggest
Attribute Type Description
results Array[AutosuggestPlace | AutosuggestQueryCompletion | AutosuggestSearch]  

Suggested Place

A link to a suggested place. Additional information is included that can be displayed to the user to help them to decide if this is the place they are interested in. It has the following attributes:

Attribute Type Description
title String A title for this place to be displayed to the user.
highlightedTitle String The same content as the 'title' field. However, it contains markup highlighting the parts of the string that were matched.
vicinity String (formatted text); optional The textual description of the location of the place; usually derived from the address of the place, but may also contain any other description that helps a user understand where the place is located.
highlightedVicinity String (formatted text); optional The same content as the 'vicinity' field. However, it contains markup highlighting the parts of the string that were matched.
position Array[Number] The latitude and longitude of the place, for example [37.785141,-122.4047775]. This latitude and longitude is suitable for displaying the place's position on a map.
category String A category id for this place.
bbox Array[Number]; optional A bounding box that is associated with this place, e.g. for moving the map view.
href String (URI) A hyperlink that refers to the resource with details for this place
type String  
id String The unique identifier of the place.

Suggested Completion

A suggested completion of the given string

Attribute Type Description
title String A title for this query completion to be displayed to the user.
highlightedTitle String The same content as the 'title' field. However, it contains markup highlighting the parts of the string that were matched.
completion String The suggested query completion
href String (URI) A hyperlink to Autosuggest with completed query term.
type String  

Suggested Search

A link to a a search applying filters.

Attribute Type Description
title String A title for this search to be displayed to the user.
highlightedTitle String The same content as the 'title' field. However, it contains markup highlighting the parts of the string that were matched.
category String; optional A category associated with this search.
position Array[Number]; optional A position that is associated with the suggested search.
bbox Array[Number]; optional A bounding box that is associated with the suggested search.
href String (URI) A hyperlink to the search suggested (e.g. category search).
type String  

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.