Geocoder API Developer's Guide

Micro Point Unit Addressing

The Forward Geocoder now matches to secondary address units based on HERE Micro Point Address data and includes the precise location information in the response. This feature allows matching and retrieval of secondary addresses for point addresses such as apartments, suites, units, and so on.

There are many use cases where this precise location information can be helpful. For example, delivery services can route to and make their deliveries directly to a particular unit in a large complex, instead of routing to the main address point of the complex.

Micro Point Unit Addressing Activation

This feature is currently limited to United States addresses only. You can enable this feature using the following parameter:

&additionaldata=IncludeMicroPointAddresses,true

The feature is disabled by default.

The point address result has an additional matchQuality field for the unit to indicate a micro point address has been found. In addition, in a related section, details of the micro point unit address:
  • A type microPointAddress
  • A unique location ID that can be used to re-retrieve the micro point unit address
  • A set of navigation coordinates and where available the display coordinates
  • An address section with:
    • A label containing the unit designator and the micro point unit address
    • A unit field containing the micro point unit address
  • When you enable the following features, the details are available specifically for the micro point unit address:
    • &locationattributes=mapReference
      • referenceId which refers to the micro point’s navigation link
      • addressId which refers to the id of the micro point
    • &locationattributes=linkInfo
      • linkInfo with link details on the micro point’s navigable link
This feature requires that one of the following secondary unit designators is provided preceding the micro point unit address and separated with a space character:
  • "Unit"
  • "Apartment" or "APT"
  • "Suite" or "STE"
  • "#"
  • "Building" or "BLDG"
  • "Office" or "OFC"
  • "Penthouse" or "PH"
  • "Room" or "RM"
  • "Space" or "SPC"

Micro Point Unit Addressing Example

The following example is a search for "1731 Pryor Rd SW Unit 306, Atlanta, GA 30315" and requesting additional micro point unit addressing information:

https://geocoder.cit.api.here.com/6.2/geocode.xml
?searchtext=1731+Pryor+Rd+SW+Unit+306,+Atlanta,+GA+30315
&additionaldata=IncludeMicroPointAddresses,true
&locationattributes=mapReference
&gen=9
&app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}

There is only one result for this query. Here is the matchQuality portion of the main point address result and the related location of the result specific to the micro point unit:

<Result>
  <Relevance>1.0</Relevance>
  <MatchLevel>houseNumber</MatchLevel>
  <MatchQuality>
  <State>1.0</State>
  <City>1.0</City>
  <Street>1.0</Street>
  <HouseNumber>1.0</HouseNumber>
  <PostalCode>1.0</PostalCode>
  <Unit>1.0</Unit>
  </MatchQuality>
  <MatchType>pointAddress</MatchType>
  <Location>
  <LocationId>NT_1YF4SQOQLctfT893gwYylD_xczMxA</LocationId>
  <LocationType>address</LocationType>
  ...
  <Related>
    <Type>microPointAddress</Type>
    <Location>
    <LocationId>NT_1YF4SQOQLctfT893gwYylD_xczMxA_m_zAjN</LocationId>
    <LocationType>point</LocationType>
    <DisplayPosition>
      <Latitude>33.70855</Latitude>
      <Longitude>-84.39494</Longitude>
    </DisplayPosition>
    <NavigationPosition>
      <Latitude>33.7084</Latitude>
      <Longitude>-84.39483</Longitude>
    </NavigationPosition>
    <Address>
      <Label>1731 Pryor Rd SW Unit 306, Atlanta, GA 30315, United States</Label>
      <Street>Pryor Rd SW</Street>
      <HouseNumber>1731</HouseNumber>
      <Unit>306</Unit>
    </Address>
    </Location>
  </Related>
  </Location>
</Result>

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.