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 with the appropriate parameters for your search.

The following tutorials are available:


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


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.

results matching ""

    No results matching ""