Search an address by 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 instance: 59 53 30 N 30 21 11 E

  • latitude and longitude in degrees and decimal minutes

    for instance: 59.89171,30.35314

The result is per 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:

GET https://discover.search.hereapi.com/v1/
    discover
    ?at=39.28808,-76.54617
    &lang=es-ES
    &q=59+53+30+N+30+21+11+E

Authorization: Bearer [your token]

The related result looks like:

{
  "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 }
    }
  ]
}

results matching ""

    No results matching ""