Geocoder API Developer's Guide

Information about the Map Version

A user wants to retrieve the latitude, longitude of 5 Wayside Rd, Burlington, MA 01803-4609 and the map version currently used by the Geocoder API.

Request

The following GET request uses the parameter locationattributes=mapReference to retrieve information about the currently used map version.

https://geocoder.cit.api.here.com/6.2/geocode.json
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &locationattributes=mapReference
  &searchtext=5%20Wayside%20Road%20Burlington%20MA

Response

The response to the request contains the following information blocks:
  • metadata about the information used in determining the location
  • information about the map data version currently used by the Geocoder API
{
  "Response": {
    "MetaInfo": {
      "Timestamp": "2016-11-09T14:52:24.750+0000"
    },
    "View": [
      {
        "_type": "SearchResultsViewType",
        "ViewId": 0,
        "Result": [
          {
            "Relevance": 1,
            "MatchLevel": "houseNumber",
            "MatchQuality": {
              "State": 1,
              "City": 1,
              "Street": [
                1
              ],
              "HouseNumber": 1
            },
            "MatchType": "pointAddress",
            "Location": {
              "LocationId": "NT_KeUAcUWfT9iYFhcrSRzRGD_1A",
              "LocationType": "address",
              "DisplayPosition": {
                "Latitude": 42.48421,
                "Longitude": -71.19155
              },
              "NavigationPosition": [
                {
                  "Latitude": 42.48512,
                  "Longitude": -71.1924
                }
              ],
              "MapView": {
                "TopLeft": {
                  "Latitude": 42.4853342,
                  "Longitude": -71.1930743
                },
                "BottomRight": {
                  "Latitude": 42.4830858,
                  "Longitude": -71.1900257
                }
              },
              "Address": {
                "Label": "5 Wayside Rd, Burlington, MA 01803, United States",
                "Country": "USA",
                "State": "MA",
                "County": "Middlesex",
                "City": "Burlington",
                "Street": "Wayside Rd",
                "HouseNumber": "5",
                "PostalCode": "01803",
                "AdditionalData": [
                  {
                    "value": "United States",
                    "key": "CountryName"
                  },
                  {
                    "value": "Massachusetts",
                    "key": "StateName"
                  },
                  {
                    "value": "Middlesex",
                    "key": "CountyName"
                  },
                  {
                    "value": "N",
                    "key": "PostalCodeType"
                  }
                ]
              },
              "MapReference": {
                "ReferenceId": "1112313865",
                "MapId": "NAAM16134",
                "MapVersion": "Q1/2016",
                "MapReleaseDate": "2016-10-26",
                "Spot": 0.87,
                "SideOfStreet": "right",
                "CountryId": "21000001",
                "StateId": "21014299",
                "CountyId": "21014501",
                "CityId": "25985545",
                "AddressId": "354074416"
              }
            }
          }
        ]
      }
    ]
  }
}