Constructing a Request

A request to the HERE Geocoding and Search includes the basic elements shown in the following table and, in addition, may contain resource-specific parameters.

Info

All HERE Geocoding and Search endpoints are called with a GET method.

ElementValue/ExampleDescription
Schemehttps
Base URL Global:[service].search.hereapi.com, China:[service].search.hereapi.cn Base URL for the [service]. Note that endpoints are named after their related service. For instance the Discover service is served by the endpoint /discover.
So that the base url for the Discover service is discover.search.hereapi.com
Versionv1
Endpoint/discoverFind places or locations using a free-form text query
/autosuggestGet suggestions to build up search queries.
/geocodeSearch for an address and return the corresponding geo-coordinates
/revgeocodeFind the nearest address to specific geo-coordinates
/browseFind places data using names or category ids
/lookupFind a place or other location objects using its identifier
Parameters[key]=[value]&...Endpoint specific parameters.
Note that the repetition of the same parameter keys throws a 400.
Check the API Reference for more details.

for instance the following URI

https://discover.search.hereapi.com/v1/discover?at=52.5228,13.4124&q=petrol+station&limit=5

is used to reach the service/endpoint Discover with the following parameters:

  • at set to the latitude 52.5228 and longitude 13.4124
  • q set to "petrol station"
  • limit set to 5

results matching ""

    No results matching ""