Search for an address near a geo-position

This tutorial demonstrates how to search for an address using its geo-position.


End users can search for a textual latitude/longitude geo-position and retrieve the nearest address and its distance from the search center (the value of the at parameter). The following units and formats are supported on /discover and /autosuggest endpoints.

  • latitude and longitude in sexagesimal degrees

    for example: 59 53 30 N 30 21 11 E

  • latitude and longitude in degrees and decimal minutes

    for example: 59.89171,30.35314

The result is by default in the language of the queried position.

To search for the closest address to the geo-position 59 53 30 N 30 21 11 E, an application centered in Mexico would send the request:


The following parameters are used:

  • at - Specify the center of the search context expressed as coordinates.
  • lang - Select the language to be used for result rendering from a list of BCP 47 compliant language codes.
  • q - Enter a free-text query.
  • apiKey - Your API key.


This request uses API key authentication. For more information about authentication options on the HERE platform, see the Identity & Access Management Guide.

The related result appears as follows:

  "items": [
      "title": "Volkovskiy prospekt 61, San Petersburgo, Rusia, 192102",
      "id": "here:af:streetsection:KjyjeR89GuuvRuAyOf2BtD:CgcIBCCxhuE0EAEaAjYx",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Volkovskiy prospekt 61, San Petersburgo, Rusia, 192102",
        "countryCode": "RUS",
        "countryName": "Rusia",
        "state": "Distrito Federal del Noroeste",
        "county": "San Petersburgo",
        "city": "San Petersburgo",
        "district": "Frunzenskiy rayon",
        "street": "Volkovskiy prospekt",
        "postalCode": "192102",
        "houseNumber": "61"
      "position": { "lat": 59.89076, "lng": 30.35442 },
      "access": [{ "lat": 59.89081, "lng": 30.35489 }],
      "distance": 7141017,
      "mapView": { "west": 30.3549, "south": 59.87979, "east": 30.36541, "north": 59.90181 }

Additional information

For more information about /discover parameters, see: API Reference.

results matching ""

    No results matching ""