Address locator

The HERE GIS Data Suite locator file uses addressed street line data, as well as address points and micro-point addressess. The data lets users geocode more nuanced and precise addresses by including apartment numbers, place names, or even business names and categories.

The HERE address points and micro-point address datasets, where available, provide more precise individual address locations and support for addresses with non-numeric elements and apartments, such as 26A, 10-12, or 1106/45.

The inclusion of the POIs dataset further enhances the locator by enabling place name searching, including any known address elements. For example, "starbucks miami lakes" matches to "Starbucks, NW 154th St, Miami Lakes, FL, 33016, USA".

The locator consists of .loc and .loz files, which may include one or more translations of an address. For example, the French address, "825 Chemin Richmond, Ottawa", and English address, "825 Richmond Rd, Ottawa", both geocode to the same location.

In countries that use non-Latin alphabets, you can use the local alphabet for geocoding input, as well as translated or transliterated input address elements. Alternate road names, such as route names, are also valid geocoding inputs.

The following table describes the key output fields returned in the locator's response.

Field name	Description
Status	Indicates whether a batch geocode request results in a match, tie, or unmatch. Possible values include: M - Match. The returned address matches the request and is the highest scoring candidate. T - Tie. The returned address matches the request but has the same score as one or more additional candidates. U - Unmatch. No addresses match the request.
Score	A number from 1-100 indicating the degree to which the input tokens in a geocoding request match the address components in a candidate record. A score of 100 represents a perfect match, while lower scores represent decreasing match accuracy. Score is always returned by default.
Match_addr	Address returned for the geocode request. The format originates from address standards for the country matched by the locator.
LongLabel	A longer version of Match_addr containing more administrative information.
ShortLabel	A shortened version of Match_addr.
Addr_type	Available values include: PointAddress - a street address based on points that represent house and building locations. Typically this is the most spatially accurate match level. Subaddress - a subset of a PointAddress that represents a house or building subaddress location, such as an apartment unit, floor, or individual building within a complex. StreetAddress - a street address that differs from PointAddress due to interpolation or estimation of the house number from a range of numbers. StreetInt - a street address consisting of a street intersection, along with city, optional state, and postal code information.StreetAddressExt - an estimated street address match returned when matchOutOfRange is true and the input house number exceeds the matched street segment range. POI - an address point located according to its place name in the POIs dataset and other optional address elements. StreetName - a point on a matching road segment along with administrative divisions and optional postcode. PostalLoc - a combination of postal code and locality name.
Rank	A value indicating the importance of a result relative to other results with the same name.
X	The primary x coordinate of an address.
Y	The primary y coordinate of an address.
ExInfo	A collection of strings from the input that don't match with any part of an address.