Geocoder API Developer's Guide

Landmarks around a Location

The user wants to retrieve the details of landmarks within a 1000 meter radius around a location (Yosemite National Park (37.7442°N, 119.5931°W)).

Request

The following GET request uses the parameter prox to specify the point around which addresses are provided and the parameter mode to define the action taken.

https://reverse.geocoder.ls.hereapi.com/6.2/reversegeocode.json
?apiKey={YOUR_API_KEY}
&mode=retrieveLandmarks
&prox=37.7442,-119.5931,1000
Note: This example uses a HERE API Key to authenticate your request. For information on other possible options, see Authentication Guide. For examples of how to use the other authentication options with the Geocoder API, see Authentication Examples.

Response

The response to the request contains the following information blocks:
  • metadata about the information used in determining the route
  • information about each landmark in the request area, with match, location, address and map reference data per landmark
{"Response": {
  "MetaInfo": {
    "Timestamp": "2016-11-07T12:07:13.023+0000",
    "NextPageInformation": "2"
  },
  "View": [{
    "_type": "SearchResultsViewType",
    "ViewId": 0,
    "Result": [
      {
        "Relevance": 1,
        "Distance": -14382.7,
        "MatchLevel": "landmark",
        "MatchQuality": {
          "Country": 1,
          "State": 1,
          "County": 1,
          "City": 1,
          "Street": [1],
          "PostalCode": 1,
          "Name": 1
        },
        "Location": {
          "LocationId": "NT_7U3RMtjyjRsEmGe.YC4S8D_p_Kgfqf4tWl9AGlk04wpQ81B",
          "LocationType": "park",
          "Name": "Yosemite National Park",
          "DisplayPosition": {
            "Latitude": 37.74896,
            "Longitude": -119.58851
          },
          "MapView": {
            "TopLeft": {
              "Latitude": 38.18491,
              "Longitude": -119.88604
            },
            "BottomRight": {
              "Latitude": 37.49379,
              "Longitude": -119.19545
            }
          },
          "Address": {
            "Label": "Village Dr, Yosemite National Park, CA 95389, United States",
            "Country": "USA",
            "State": "CA",
            "County": "Mariposa",
            "City": "Yosemite National Park",
            "Street": "Village Dr",
            "PostalCode": "95389",
            "AdditionalData": [
              {
                "value": "United States",
                "key": "CountryName"
              },
              {
                "value": "California",
                "key": "StateName"
              },
              {
                "value": "Mariposa",
                "key": "CountyName"
              },
              {
                "value": "N",
                "key": "PostalCodeType"
              }
            ]
          },
          "MapReference": {
            "CountryId": "21000001",
            "StateId": "21009408",
            "CountyId": "21009811",
            "CityId": "21570523",
            "PlaceId": "17552007"
          }
        }
      },
     ...
     
     // Additional objects removed for readability
    ]
  }]
}}