Geocoder API Developer's Guide

Address at a Location

The user wants to retrieve the addresses within 250 meters of a location in Chicago (41.8842,-87.6388).

Request

The following GET request uses the parameter prox to specify the location of the address and the parameter mode to define the action taken.

https://reverse.geocoder.ls.hereapi.com/6.2/reversegeocode.json
?apiKey={YOUR_API_KEY}
&mode=retrieveAddresses
&prox=41.8842,-87.6388,250
Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.

Response

The response to the request contains the following information blocks:
  • metadata about the information used in determining the route
  • information about each address, including
    • match quality
    • location information
    • address information
    • map reference information
{"Response": {
  "MetaInfo": {
    "Timestamp": "2017-10-11T10:58:59.233+0000",
    "NextPageInformation": "2"
  },
  "View": [{
    "_type": "SearchResultsViewType",
    "ViewId": 0,
    "Result": [
      {
        "Relevance": 1,
        "Distance": 13.6,
        "MatchLevel": "houseNumber",
        "MatchQuality": {
          "Country": 1,
          "State": 1,
          "County": 1,
          "City": 1,
          "District": 1,
          "Street": [1],
          "HouseNumber": 1,
          "PostalCode": 1
        },
        "MatchType": "pointAddress",
        "Location": {
          "LocationId": "NT_Opil2LPZVRLZjlWNLJQuWB_0ITN",
          "LocationType": "address",
          "DisplayPosition": {
            "Latitude": 41.88432,
            "Longitude": -87.63877
          },
          "NavigationPosition": [ {
            "Latitude": 41.88449,
            "Longitude": -87.63877
          } ],
          "MapView": {
            "TopLeft": {
              "Latitude": 41.8854442,
              "Longitude": -87.64028
            },
            "BottomRight": {
              "Latitude": 41.8831958,
              "Longitude": -87.63726
            }
          },
          "Address": {
            "Label": "425 W Randolph St, Chicago, IL 60606, United States",
            "Country": "USA",
            "State": "IL",
            "County": "Cook",
            "City": "Chicago",
            "District": "West Loop",
            "Street": "W Randolph St",
            "HouseNumber": "425",
            "PostalCode": "60606",
            "AdditionalData": [
              {
                "value": "United States",
                "key": "CountryName"
              },
              {
                "value": "Illinois",
                "key": "StateName"
              },
              {
                "value": "Cook",
                "key": "CountyName"
              },
              {
                "value": "N",
                "key": "PostalCodeType"
              }
            ]
          },
          "MapReference": {
            "ReferenceId": "776372180",
            "Spot": 0.52,
            "SideOfStreet": "right",
            "CountryId": "21000001",
            "StateId": "21002247",
            "CountyId": "21002623",
            "CityId": "21002647",
            "BuildingId": "9000000000002726912",
            "AddressId": "79186508"
          }
        }
      },

     ...
     
     // Additional objects removed for readability
    ]
  }]
}}