Places (Search) API Developer's Guide

Guiding free-text entry with suggestions

Sometimes, especially in mobile use cases, it is not practical to force the user to type in the whole query. One way to deal with this is to use suggestions based on what the user has already entered. This partial matching can be invoked multiple times, while the user is typing more characters to refine the search.

Finding a specific place by it's name

Here is an example for suggestions offered for "madi" when standing in Bryant Park in New York, which will offer the nearby "Madison Ave" as a possible result:

https://places.cit.api.here.com/places/v1/autosuggest
        ?app_id={YOUR_APP_ID}
        &app_code={YOUR_APP_CODE}
        &at=40.7539,-73.9837
        &q=madi
        &pretty
      


Restricting suggestion types

By default autosuggest response could contain the following result types:

Result Type Media Type Description
address urn:nlp-types:place Location and address suggestion
place urn:nlp-types:place POI suggestion
category urn:nlp-types:search Category search suggestion
chain urn:nlp-types:search Chain/Brand search suggestion
query urn:nlp-types:autosuggest Query completion suggestion

In some cases, like for example a navigation/guidance use case, user might want only to find only a specific address or POI as destination.



For this kind of purpose, application developer could restrict the Autosuggest response by passing the result_types=address,place query parameter in the request.

https://places.cit.api.here.com/places/v1/autosuggest
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&at=52.531,13.3843
&q=garten
&result_types=address,place
&pretty

Using query completions

Application developer could also strict Autosuggest to return query completions only.





https://places.cit.api.here.com/places/v1/autosuggest
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&at=40.7539,-73.9837
&q=mc
&result_types=query
&pretty
{
  "results":[
    {
      "title":"mcdonald",
      "highlightedTitle":"<b>mc</b>donald",
      "completion":"donald",
      "href": "http://...",
      "type":"urn:nlp-types:autosuggest"
    },
    {
      "title":"mccarthy",
      "highlightedTitle":"<b>mc</b>carthy",
      "completion":"carthy",
      "href": "http://...",
      "type":"urn:nlp-types:autosuggest"
    },
    {
      "title":"mcguinness",
      "highlightedTitle":"<b>mc</b>guinness",
      "completion":"guinness",
      "href": "http://...",
      "type":"urn:nlp-types:autosuggest"
    },
    ...
  ]
}

The query completion results contain href attribute, which application developer can use to trigger next Autosuggest request with the user's chosen completed query term.

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.