Geocode Request
To find the corresponding geocoordinates based on free-form input, send the following GET request.
https://geocoder.ls.hereapi.com/6.2/geocode.json
?apiKey={YOUR_API_KEY}
&searchtext=425+W+Randolph+Chicago Note: This example uses a HERE API Key to authenticate your request. For the available authentication options, see the Identity & Access Management Developer Guide.
The response to the above request delivers the following high-level elements:
- Metadata about the request
- Results that match the request; the number of results depends on the completeness of the address provided
{"Response": {
"MetaInfo": {"Timestamp": "2016-11-02T13:24:11.575+0000"},
"View": [{
"_type": "SearchResultsViewType",
"ViewId": 0,
"Result": [{
"Relevance": 1,
"MatchLevel": "houseNumber",
"MatchQuality": {
"City": 1,
"Street": [0.9],
"HouseNumber": 1
},
"MatchType": "pointAddress",
"Location": {
"LocationId": "NT_Opil2LPZVRLZjlWNLJQuWB_0ITN",
"LocationType": "point",
"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"
}
]
}
}
}]
}]
}}