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