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.cit.api.here.com/6.2/reversegeocode.json
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &mode=retrieveLandmarks
  &prox=37.7442,-119.5931,1000

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
    ]
  }]
}}