Geocoder API Developer's Guide

Landmarks around Multiple Locations

The user wants to retrieve the details of landmarks around two locations.

Request

The following POST request uses the parameter mode to define the action taken for the request. Note that the HTTP POST body contains the locations used in the request.

https://reverse.geocoder.ls.hereapi.com/6.2/multi-reversegeocode.json
?apiKey={YOUR_API_KEY}
&mode=retrieveLandmarks
Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
POST body:
id=0001&prox=52.5309,13.3845,500
id=0002&prox=50.1618,8.5334,500

Response

The response to the request contains the following information blocks:
  • metadata about the information used in determining the route
  • information about each landmark near the items in the POST body, including
    • match quality
    • location information
    • address information
    • map reference information
{"Response": {
  "MetaInfo": {"Timestamp": "2016-11-08T07:46:07.664+0000"},
  "Item": [
    {
      "ItemId": 1,
      "Result": [
        {
          "Relevance": 1,
          "Distance": 161.2,
          "MatchLevel": "landmark",
          "MatchQuality": {
            "Country": 1,
            "State": 1,
            "County": 1,
            "City": 1,
            "District": 1,
            "Street": [1],
            "HouseNumber": 1,
            "PostalCode": 1,
            "Name": 1
          },
          "Location": {
            "LocationId": "NT_2tJfMbwzYPMKlNdDmb5jBB_p_bUfMBOrFIallcDBNjbQ6VD",
            "LocationType": "cemetery",
            "Name": "Dorotheenstädtischer Friedhof",
            "DisplayPosition": {
              "Latitude": 52.52882,
              "Longitude": 13.38524
            },
            "MapView": {
              "TopLeft": {
                "Latitude": 52.5299442,
                "Longitude": 13.3833922
              },
              "BottomRight": {
                "Latitude": 52.5276958,
                "Longitude": 13.3870878
              }
            },
            "Address": {
              "Label": "Chausseestraße 126, 10115 Berlin, Deutschland",
              "Country": "DEU",
              "State": "Berlin",
              "County": "Berlin",
              "City": "Berlin",
              "District": "Mitte",
              "Street": "Chausseestraße",
              "HouseNumber": "126",
              "PostalCode": "10115",
              "AdditionalData": [
                {
                  "value": "Deutschland",
                  "key": "CountryName"
                },
                {
                  "value": "Berlin",
                  "key": "StateName"
                },
                {
                  "value": "Berlin",
                  "key": "CountyName"
                }
              ]
            },
            "MapReference": {
              "CountryId": "20147700",
              "StateId": "20187401",
              "CountyId": "20187402",
              "CityId": "20187403",
              "DistrictId": "20187417",
              "PlaceId": "898512796"
            }
          }
        },
      
     ...
     
     // Additional objects removed for readability

      ]
    }
  ]
}}