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

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