Location for a Partial Address
The user wants to retrieve the latitude, longitude and complete address details of '425 W Randolph St, Chicago, IL' based on partial address information.
Request
The following GET request uses the parameters housenumber, street, city, and country to specify the address.
https://geocoder.ls.hereapi.com/6.2/geocode.json
?apiKey={YOUR_API_KEY}
&housenumber=425
&street=randolph
&city=chicago
&country=usa 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 request
- information about each address that matches the partial address information, including
- match quality
- location information
- address information
{"Response": {
"MetaInfo": {"Timestamp": "2016-11-09T10:43:21.446+0000"},
"View": [{
"_type": "SearchResultsViewType",
"ViewId": 0,
"Result": [
{
"Relevance": 1,
"MatchLevel": "houseNumber",
"MatchQuality": {
"Country": 1,
"City": 1,
"Street": [0.85],
"HouseNumber": 1
},
"MatchType": "pointAddress",
"Location": {
"LocationId": "NT_Opil2LPZVRLZjlWNLJQuWB_0ITN",
"LocationType": "address",
"DisplayPosition": {
"Latitude": 41.88432,
"Longitude": -87.6387699
},
"NavigationPosition": [{
"Latitude": 41.88449,
"Longitude": -87.6387699
}],
"MapView": {
"TopLeft": {
"Latitude": 41.8854442,
"Longitude": -87.6402799
},
"BottomRight": {
"Latitude": 41.8831958,
"Longitude": -87.6372599
}
},
"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"
}
]
}
}
},
...
// Additional objects removed for readability
]
}]
}}