Reverse geocode tutorials

The Reverse Geocode resource offers the ability to find the nearest address based on querying with geocoordinates.

Submit the HTTP GET request to https://revgeocode.search.hereapi.com/v1/revgeocode with the appropriate parameters for your search.

The following tutorials are available:

• Find multiple nearby addresses using geocoordinates
• Find nearby addresses limited by a spatial filter

Example

A user selects a map point on a street in Rome, Italy, identifying point coordinates, and submits the following request to the endpoint:

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=41.89993%2C12.45447
    &lang=en-US
    &apiKey={YOUR_API_KEY}

The API returns the nearest address - "Via di Porta Cavalleggeri, 71, 00165 Rome Rome, Italy".

The response to the above request looks like the following:

{
  "items": [
    {
      "title": "Via di Porta Cavalleggeri, 71, 00165 Rome, Italy",
      "id": "here:af:streetsection:-mIf.iRKqBlDfek-zjPSdD:CggIBCCuquP2AhABGgI3MQ",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Via di Porta Cavalleggeri, 71, 00165 Rome, Italy",
        "countryCode": "ITA",
        "countryName": "Italy",
        "state": "Latium",
        "county": "Rome",
        "city": "Rome",
        "district": "Aurelio",
        "street": "Via di Porta Cavalleggeri",
        "postalCode": "00165",
        "houseNumber": "71"
      },
      "position": {
        "lat": 41.89991,
        "lng": 12.45449
      },
      "access": [
        {
          "lat": 41.89999,
          "lng": 12.45443
        }
      ],
      "distance": 3,
      "mapView": {
        "west": 12.456,
        "south": 41.89879,
        "east": 12.45298,
        "north": 41.90103
      }
    }
  ]
}

Review the result JSON. You see much more detail about the address. Notice the distance from the map point (in meters) towards the nearest coordinates of the returned item. The nearest coordinates might differ from its position or access coordinates.