Search for an address near a geo-position

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

Procedure

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:

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
    &apiKey={YOUR_API_KEY}

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.

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.