Places (Search) API Developer's Guide

Find a Place using a Text String

To find a specific place, such as one with the word chrysler in the name, send the following GET request.

https://places.ls.hereapi.com/places/v1/autosuggest
?at=40.74917,-73.98529
&q=chrysler
&apiKey={YOUR_API_KEY}
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide. For examples of how to use the other authentication options with the Places (Search) API, see Authentication Examples.
The response to the above request includes the following high level elements:
  • a results array containing items that represent suggested places
  • metadata – information on each place such as the title, position, category, bounding box, and so on

Most web browsers provide a collapsed array containing the response:

{
  "results": [
    { "Chrysler Building" },
    { "Chrysler Camera Repair" },
    { "Manhattan CHRYSLER" },
    { "Chrysler Cleaners Inc" },
    { "Chrysler Stationery & Gift Inc" },
    { "Chrysler Tower Periodontics" },
    { "Major World CHRYSLER" },
    { "Chrysler Auto Repair" },
    { "Hudson CHRYSLER" },
    { "Teterboro CHRYSLER" },
    { "Riverdale CHRYSLER" },
    { "Major CHRYSLER DODGE Jeep" },
    { "Bayside CHRYSLER" },
    { "Star CHRYSLER" },
    { "Route 46 CHRYSLER" },
    { "Chrysler-Plymouth Authorized Sales & Service" },
    { "Monroe" },
    { "Kacey Chrysler" },
    { "Chrysler Rd" },
    { "CHRYSLER" }
  ]
}

When expanded, each item in the array displays additional information about that place.

{
  "title": "Chrysler Building",
  "highlightedTitle": "<b>Chrysler</b> Building",
  "vicinity": "405 Lexington Ave\nNew York, NY 10017",
  "position": [ 40.75185, -73.97572 ],
  "category": "sights-museums",
  "href": "https://...",
  "type": "urn:nlp-types:place"
}