Geocoder API Developer's Guide

Shape around a Location

The user wants to retrieve the shape and the details of the first address around a location in Chicago (41.8839,-87.6389).

Request

The following GET request uses the parameter prox to specify the location of the address and the parameter mode to define the action taken. The parameter maxresults limits the addresses included in the response to the first match, and the key/value pair additionaldata=IncludeShapeLevel%2CpostalCode requests the inclusion of the shape data.

https://reverse.geocoder.cit.api.here.com/6.2/reversegeocode.json
  ?app_id={YOUR_APP_ID}
  &app_code={YOUR_APP_CODE}
  &mode=retrieveAddresses
  &maxresults=1
  &additionaldata=IncludeShapeLevel%2CpostalCode
  &prox=41.8839,-87.6389,150

Response

The response to the request contains the following information blocks:
  • metadata about the information used in determining the route
  • information about the address, including
    • match quality
    • location information
    • address information
    • map reference information
    • shape information
{"Response": {
  "MetaInfo": {
    "Timestamp": "2016-11-08T09:52:54.654+0000",
    "NextPageInformation": "2"
  },
  "View": [{
    "_type": "SearchResultsViewType",
    "ViewId": 0,
    "Result": [{
      "Relevance": 1,
      "Distance": 16.3,
      "MatchLevel": "houseNumber",
      "MatchQuality": {
        "Country": 1,
        "State": 1,
        "County": 1,
        "City": 1,
        "District": 1,
        "Street": [1],
        "HouseNumber": 1,
        "PostalCode": 1
      },
      "MatchType": "interpolated",
      "Location": {
        "LocationId": "NT_puy2gbuVuGd-an6zGdSyNA_xADM",
        "LocationType": "point",
        "DisplayPosition": {
          "Latitude": 41.88425,
          "Longitude": -87.63845
        },
        "MapView": {
          "TopLeft": {
            "Latitude": 41.8853742,
            "Longitude": -87.63996
          },
          "BottomRight": {
            "Latitude": 41.8831258,
            "Longitude": -87.63694
          }
        },
        "Address": {
          "Label": "100 N Riverside Plz, Chicago, IL 60606, United States",
          "Country": "USA",
          "State": "IL",
          "County": "Cook",
          "City": "Chicago",
          "District": "West Loop",
          "Street": "N Riverside Plz",
          "HouseNumber": "100",
          "PostalCode": "60606",
          "AdditionalData": [
            {
              "value": "United States",
              "key": "CountryName"
            },
            {
              "value": "Illinois",
              "key": "StateName"
            },
            {
              "value": "Cook",
              "key": "CountyName"
            },
            {
              "value": "N",
              "key": "PostalCodeType"
            }
          ]
        },
        "MapReference": {
          "ReferenceId": "858376462",
          "Spot": 0.88,
          "SideOfStreet": "left",
          "CountryId": "21000001",
          "StateId": "21002247",
          "CountyId": "21002623",
          "CityId": "21002647",
          "BuildingId": "9000000000002726912",
          "AddressId": "79186499"
        },
        "Shape": {
          "_type": "WKTShapeType",
          "Value": "MULTIPOLYGON (((-87.63376 41.8794, -87.63377 41.87812, -87.6352 41.87811, 
          -87.6352 41.87683, -87.63618 41.87682, -87.63665 41.8768, -87.6366 41.87648, -87.63672 41.87669, -87.63675 41.8768, 
          -87.63707 41.8768, -87.6374 41.87807, -87.63792 41.87807, -87.63787 41.87794, -87.63778 41.87751, -87.63752 41.87751, 
          -87.63752 41.87731, -87.63775 41.87728, -87.6377 41.87687, -87.63784 41.87684, -87.63779 41.87678, -87.64102 41.87676, 
          -87.64104 41.87804, -87.63955 41.87805, -87.63959 41.87933, -87.63966 41.88058, -87.63969 41.88187, -87.63976 41.8832, 
          -87.63992 41.88318, -87.64016 41.88318, -87.64022 41.88462, -87.64025 41.88479, -87.64035 41.8851, -87.64047 41.88571, 
          -87.63981 41.88572, -87.64062 41.88625, -87.64066 41.88742, -87.6407 41.88793, -87.64076 41.88828, -87.64085 41.88859, 
          -87.64097 41.88883, -87.64109 41.88903, -87.64113 41.88907, -87.63971 41.88905, -87.63961 41.88882, -87.63954 41.8887, 
          -87.63918 41.88675, -87.63873 41.8864, -87.63841 41.88588, -87.63722 41.88593, -87.63586 41.88686, -87.63549 41.88706, 
          -87.63536 41.88704, -87.63248 41.8871, -87.63248 41.88703, -87.63374 41.88703, -87.63386 41.887, -87.63395 41.88702, 
          -87.6339 41.88446, -87.63383 41.88195, -87.6338 41.88116, -87.63358 41.88109, -87.63357 41.88079, -87.6335 41.88068, 
          -87.63378 41.88068, -87.63376 41.8794)))"
        }
      }
    }]
  }]
}}

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.