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