Geocoder API Developer's Guide

Location for an Intersection

The user wants to retrieve the latitude and longitude of the intersection of S State St & W Madison St in Chicago, IL USA.

Request

The following GET request uses the parameter street to specify the cross-streets and the parameter city to define in which city to search.

https://geocoder.cit.api.here.com/6.2/geocode.json
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &city=Chicago
  &street=State%20%40%20Madison

Response

The response to the request contains the following information blocks:
  • metadata about the request
  • information about each address that matches the intersection address, including
    • match quality
    • location information
    • address information
{"Response": {
  "MetaInfo": {"Timestamp": "2016-11-09T13:22:38.981+0000"},
  "View": [{
    "_type": "SearchResultsViewType",
    "ViewId": 0,
    "Result": [{
      "Relevance": 1,
      "MatchLevel": "street",
      "MatchQuality": {
        "City": 1,
        "Street": [
          0.85,
          0.85
        ]
      },
      "Location": {
        "LocationId": "NT_PL5nT7C0c78FqTmyfKw-FA_x_dcbIw9g5JN1KU03adYKFHC",
        "LocationType": "point",
        "DisplayPosition": {
          "Latitude": 41.88206,
          "Longitude": -87.6278
        },
        "NavigationPosition": [{
          "Latitude": 41.88206,
          "Longitude": -87.6278
        }],
        "MapView": {
          "TopLeft": {
            "Latitude": 41.8910532,
            "Longitude": -87.6398792
          },
          "BottomRight": {
            "Latitude": 41.8730668,
            "Longitude": -87.6157208
          }
        },
        "Address": {
          "Label": "S State St & W Madison St, Chicago, IL 60603, United States",
          "Country": "USA",
          "State": "IL",
          "County": "Cook",
          "City": "Chicago",
          "District": "Loop",
          "Street": "S State St & W Madison St",
          "PostalCode": "60603",
          "AdditionalData": [
            {
              "value": "United States",
              "key": "CountryName"
            },
            {
              "value": "Illinois",
              "key": "StateName"
            },
            {
              "value": "Cook",
              "key": "CountyName"
            },
            {
              "value": "N",
              "key": "PostalCodeType"
            }
          ]
        }
      }
    }]
  }]
}}