Geocoder API Developer's Guide

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 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.

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