Find multiple nearby addresses using geocoordinates

The Reverse Geocode resource offers the ability to find the nearest addresses based on querying with geocoordinates. It is an option to get multiple results by setting a limit parameter with value >1 [1..100].

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

Procedure

A user selects a map point on a location in Nendaz, Switzerland, identifying point coordinates, sets a result size limit and submits the following request to the endpoint:

GET https://revgeocode.search.hereapi.com/v1/
    revgeocode
    ?at=46.1802980%2C7.2913685
    &limit=20
    &apiKey={YOUR_API_KEY}

The following parameters are used:

• at - Specify the center of the search context expressed as coordinates.
• limit - Maximum number of results to be returned.
• apiKey - Your API key.

The API returns the nearest address - "Route de la Télécabine 67, 1997 Nendaz Valais, Suisse" and additional nearby results.

The response to the above request looks like the following:

{
  "items": [
    {
      "title": "Route de la Télécabine 67, 1997 Nendaz Valais, Suisse",
      "id": "here:af:streetsection:9z62iGVQH0LlHrihOC9UMD:CgcIBCDLq9J-EAEaAjY3",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Route de la Télécabine 67, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997",
        "houseNumber": "67"
      },
      "position": {
        "lat": 46.18017,
        "lng": 7.29134
      },
      "access": [
        {
          "lat": 46.18028,
          "lng": 7.29128
        }
      ],
      "distance": 15,
      "mapView": {
        "west": 7.29039,
        "south": 46.17957,
        "east": 7.29552,
        "north": 46.18338
      }
    },
    {
      "title": "Nv Remontées Mécaniques SA",
      "id": "here:pds:place:756u0jnt-1c66d7a60c1645c2a827244ca1cf9bfe",
      "resultType": "place",
      "address": {
        "label": "Nv Remontées Mécaniques SA, Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.18017,
        "lng": 7.29134
      },
      "access": [
        {
          "lat": 46.18028,
          "lng": 7.29128
        }
      ],
      "distance": 15,
      "categories": [
        {
          "id": "800-8600-0197",
          "primary": true
        }
      ]
    },
    {
      "title": "Route de la Télécabine 40, 1997 Nendaz Valais, Suisse",
      "id": "here:af:streetsection:9z62iGVQH0LlHrihOC9UMD:CgcIBCDOq9J-EAEaAjQw",
      "resultType": "houseNumber",
      "houseNumberType": "PA",
      "address": {
        "label": "Route de la Télécabine 40, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997",
        "houseNumber": "40"
      },
      "position": {
        "lat": 46.18035,
        "lng": 7.29104
      },
      "access": [
        {
          "lat": 46.18023,
          "lng": 7.29109
        }
      ],
      "distance": 26,
      "mapView": {
        "west": 7.29039,
        "south": 46.17957,
        "east": 7.29552,
        "north": 46.18338
      }
    },
    {
      "title": "Edelweiss",
      "id": "here:pds:place:756u0jnt-7fac56ee086c4c4d97451e273f4bd5a6",
      "resultType": "place",
      "address": {
        "label": "Edelweiss, Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.18035,
        "lng": 7.29104
      },
      "access": [
        {
          "lat": 46.18023,
          "lng": 7.29109
        }
      ],
      "distance": 26,
      "categories": [
        {
          "id": "500-5000-0000",
          "primary": true
        },
        {
          "id": "100-1000-0000"
        },
        {
          "id": "200-2000-0011"
        },
        {
          "id": "500-5000-0053"
        }
      ],
      "foodTypes": [
        {
          "id": "301-000",
          "primary": true
        },
        {
          "id": "307-000"
        },
        {
          "id": "310-000"
        },
        {
          "id": "800-074"
        }
      ]
    },
    {
      "title": "Sentier Panoramique de Tracouet",
      "id": "here:pds:place:756u0jnt-863de29b7d664dd5b74bde192dd06e60",
      "resultType": "place",
      "address": {
        "label": "Sentier Panoramique de Tracouet, Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.17995,
        "lng": 7.29107
      },
      "access": [
        {
          "lat": 46.17995,
          "lng": 7.29107
        }
      ],
      "distance": 45,
      "categories": [
        {
          "id": "550-5510-0359",
          "primary": true
        },
        {
          "id": "300-3000-0000"
        },
        {
          "id": "550-5510-0000"
        }
      ]
    },
    ... 14 more results ...,
    {
      "title": "Apartment Ambassador II Haute Nendaz",
      "id": "here:pds:place:756u0jnt-435b2aaa21214569a7a1fff5f6cb4593",
      "resultType": "place",
      "address": {
        "label": "Apartment Ambassador II Haute Nendaz, Route de la Télécabine, 1997 Nendaz Valais, Suisse",
        "countryCode": "CHE",
        "countryName": "Suisse",
        "state": "Valais",
        "county": "Conthey",
        "city": "Nendaz",
        "district": "Haute-Nendaz",
        "street": "Route de la Télécabine",
        "postalCode": "1997"
      },
      "position": {
        "lat": 46.17957,
        "lng": 7.29092
      },
      "access": [
        {
          "lat": 46.17957,
          "lng": 7.29092
        }
      ],
      "distance": 88,
      "categories": [
        {
          "id": "500-5000-0000",
          "primary": true
        }
      ]
    }
  ]
}

Review the result JSON. You see much more detail about the address. Notice the additional returned addresses. 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.