Geocoder API Developer's Guide

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