HERE Global Address

HERE provides comprehensive global address data with standardised formats across 240+ countries and territories.

An address from HERE Technologies' map data, covering 230 countries and territories across twelve regional datasets named in dataset. Each address carries its address lines, house number (address), street name, HERE's administrative hierarchy (order1_name, order2_name, order8_name, builtup_name), a postal code where the country has one, display and delivery coordinates and, where HERE holds them, the building, unit, level and unit name. Depth varies by country, from building level down to region level only. HERE refreshes the data quarterly.

Conventions:

• A record is one of four kinds, named after the dataset in id: ap an address point, ar an address range, poi a point of interest, loc a locality. Postal Addressing records are pap and par.
• id is the dataset, the kind, HERE's key and the language code. A range id carries a further segment holding the interpolated house number (herewe_ar|74024700!27769096|8|de).
• Text fields are empty strings, never null. Coordinates are empty strings when absent.
• Only line_1 and line_2 are ever populated. line_1 is the building name line where the record has one, otherwise the street line. Ranges, points of interest and localities produce at most one line.
• Casing is as HERE ships it. Only the Postal Addressing fields are title cased.
• language is the ISO 639-1 code for the record. A street named in more than one language yields one record per language, identical but for the language segment of id.

Example Record

Field	Example	Type
id	herewe_ap|365553439|it	string
dataset	herewe	string
country_iso	ITA	string
line_1	16 Via Giuseppe Garibaldi	string
line_2	Empty in this example	string
line_3	Empty in this example	string
line_4	Empty in this example	string
line_5	Empty in this example	string
language	it	string
address	16	string
building_name	Empty in this example	string
delivery_latitude	45.28441	number
delivery_longitude	12.00825	number
latitude	45.28441	number
longitude	12.00825	number
street_name	Via Giuseppe Garibaldi	string
postal_code	35020	string
order1_name	Veneto	string
order2_name	Padova	string
order8_name	Brugine	string
builtup_name	Empty in this example	string
poi_name	Empty in this example	string
building_unit_name	Empty in this example	string
level_name	Empty in this example	string
unit_name	Empty in this example	string
suppl_address_info	Empty in this example	string
building_grp_name	Empty in this example	string

Every field is documented below.

Essential Elements

id string

ID

Global unique internally generated identifier for an address

Example herewe_ap|365553439|it

dataset string

Dataset

The HERE dataset to query against

Example herewe

Enum

12 possible values

• "herewe"
• "heret"
• "heresa"
• "hereo"
• "herena"
• "heremeas"
• "heremea"
• "herem"
• "herei"
• "herehk"
• "hereee"
• "hereap"

country_iso string

Country ISO

Three character country code based on ISO Standard 3166.

Can be empty string "" if not present.

Example ITA

language string

Language

Language Code of Address and Building Name for the Point Address.

Example it

address string

Address

Address / House Number uniquely identifying the address along the specified road link.

Can be empty string "" if not present.

Example 16

Address Lines

line_1 string

Address Line One

First address line.

Can be empty string "" if not present.

Example 16 Via Giuseppe Garibaldi

line_2 string

Address Line Two

Second address line.

Can be empty string "" if not present.

Example Empty in this example

line_3 string

Address Line Three

Third address line.

Can be empty string "" if not present.

Example Empty in this example

line_4 string

Address Line Four

Fourth address line.

Can be empty string "" if not present.

Example Empty in this example

line_5 string

Address Line Five

Fifth address line.

Can be empty string "" if not present.

Example Empty in this example

Location Details

building_name string

Building Name

Name of the Building to which the Point Address is associated.

Can be empty string "" if not present.

Example Empty in this example

street_name string

Street Name

The full spelling of the street name, including Prefix, Base Name, Suffix, Street Type, and Direction on Sign.

Example Via Giuseppe Garibaldi

postal_code string

Postal Code

Full postal code; could be numeric or alphanumeric postal code.

Can be empty string "" if not present.

Example 35020

Geographical Information

latitude string | number

Latitude

Example 45.28441

longitude string | number

Longitude

Example 12.00825

delivery_latitude string | number

Delivery Latitude

Example 45.28441

delivery_longitude string | number

Delivery Longitude

Example 12.00825

Administrative Areas

order1_name string

Order 1 Name

Identifies the highest administrative level in which a country can be subdivided.

Example Veneto

order2_name string

Order 2 Name

Identifies an intermediate administrative level of a country and is a sub-division of an Order-1 area. Only countries with a five (or more) level administrative hierarchy have Order-2 administrative levels defined. This feature can be used for destination selection and map display.

Example Padova

order8_name string

Order 8 Name

Identifies the lowest level of the country's administrative hierarchy that is present country-wide. (No gaps exist in the coverage.)

Example Brugine

builtup_name string

Built-up Name

Identifies the lowest administrative level for a country. This level does not cover the entire country, (as opposed to the Order-8 Area level which does cover the entire country). This feature should be used in conjunction with Zone and Order-8 Area for destination selection. The Built-up Area polygon, as published in RDF_CARTO, can also be used for map display.

Example Empty in this example