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.ls.hereapi.com/6.2/geocode.json
?apiKey={YOUR_API_KEY}
&locationattributes=mapReference
&searchtext=5%20Wayside%20Road%20Burlington%20MA
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 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"
              }
            }
          }
        ]
      }
    ]
  }
}