Data Enrichment

Location can enrich an address with additional data during validation if requested via the "include" attribute:

coordinates-wgs84: WGS-84 GEO coordinates along with precision information
country-info: Country codes in various representations (ISO-3166-1)
region-info: Country-specific region codes (ISO-3166-2)
municipality-info: Information about the municipality of the address
delivery-info: Country-specific information for carriers

Coordinates

Coordinates can be requested via the "include" Attribute "coordinates-wgs84". The coordinates are in decimal degrees format.
The following table describes all relevant output fields:

Field	Description
lat	Latitude of the WGS-84 coordinate. Examples: 48.89855 or -17.77016
lon	Longitude of the WGS-84 coordinate. Examples: 8.66726 or -149.48018
precision	The accuracy level of the coordinates. The most accurate coordinate is at the house number level. The following levels exist: 1. locality 2. street 3. house-number-range 4. house-number Example: house-number

Field

Description

lat

Latitude of the WGS-84 coordinate.
Examples: 48.89855 or -17.77016

lon

Longitude of the WGS-84 coordinate.
Examples: 8.66726 or -149.48018

precision

The accuracy level of the coordinates. The most accurate coordinate is at the house number level.
The following levels exist:

1. locality
2. street
3. house-number-range
4. house-number

Example: house-number

Country Information (ISO-3166-1)

Country information can be requested via the "include" Attribute "country-info".
The following table describes all relevant output fields:

Field	Description
iso3166_1Name	Official ISO-3166-1 Name of the country. Example: Germany
iso3166_1Alpha2	Official ISO-3166-1 two letter code (alpha-2) of the country. Example: DE
iso3166_1Alpha3	Official ISO-3166-1 three letter code (alpha-3) of the country. Example: DEU
iso3166_1Numeric	Official ISO-3166-1 numeric code of the country. Example: 276

Field

Description

iso3166_1Name

Official ISO-3166-1 Name of the country.
Example: Germany

iso3166_1Alpha2

Official ISO-3166-1 two letter code (alpha-2) of the country.
Example: DE

iso3166_1Alpha3

Official ISO-3166-1 three letter code (alpha-3) of the country.
Example: DEU

iso3166_1Numeric

Official ISO-3166-1 numeric code of the country.
Example: 276

Region Information (ISO-3166-2)

Region information can be requested via the "include" Attribute "region-info".
The following table describes all relevant output fields:

Field	Description
iso3166_2Name	Official ISO-3166-2 name of the region. Example: Baden-Württemberg
iso3166_2Code	Official ISO-3166-2 code of the region. Example: DE-BW

Field

Description

iso3166_2Name

Official ISO-3166-2 name of the region.
Example: Baden-Württemberg

iso3166_2Code

Official ISO-3166-2 code of the region.
Example: DE-BW

Municipality Information

Municipality information can be requested via the "include" Attribute "municipality-info".
The following table describes all relevant output fields:

Field	Description
municipalityName	Official name of the municipality. Example: Pforzheim, Stadt
municipalityCode	Official code of the Municipality. Example: 08231000

Field

Description

municipalityName

Official name of the municipality.
Example: Pforzheim, Stadt

municipalityCode

Official code of the Municipality.
Example: 08231000

Delivery Information

Additional information regarding the delivery can be requested via the "include" Attribute "delivery-info".
The following table describes all relevant output fields:

Field	Description
postalCodeAddition	Addition of the postal code. Exists only in Switzerland and consists of two digits. Example: 01

Field

Description

postalCodeAddition

Addition of the postal code. Exists only in Switzerland and consists of two digits.
Example: 01