Geospatial troubleshooting - Amazon QuickSight

Geospatial troubleshooting

Use this section to discover the Amazon QuickSight requirements for correctly processing geospatial data. If Amazon QuickSight doesn't recognize your geospatial data as geospatial, use this section to help troubleshoot the issue. Make sure that your data follows the guidelines listed, so that it works in geospatial visuals.

Note

Geospatial charts in Amazon QuickSight currently aren't supported in some AWS Regions, including in China. We are working on adding support for more Regions.

If your geography follows all the guidelines listed here, and still generates errors, contact the Amazon QuickSight team from within the Amazon QuickSight console.

Geocoding issues

Amazon QuickSight geocodes place names into latitude and longitude coordinates. It uses these coordinates to display place names on the map. Amazon QuickSight skips any places that it can't geocode.

For this process to work properly, your data must include at least the country. Also, there can't be duplicate place names inside of a parent place name.

A few issues prevent place names from showing up on a map chart. These issues include unsupported, ambiguous, or invalid locations, as described following.

Issues with unsupported areas

To map unsupported locations, include latitude and longitude coordinates in your data. Use these coordinates in the geospatial field well to make locations show on a map chart.

Issues with ambiguous locations

Geospatial data can't contain ambiguous locations. For example, suppose that the data contains a city named Springfield, but the next level in the hierarchy is country. Because multiple states have a city named Springfield, it isn't possible to geocode the location to a specific point on a map.

To avoid this problem, you can add enough geographical data to indicate what location should show on a map chart. For example, you can add a state level into your data and its hierarchy. Or, you might add latitude and longitude.

Issues with invalid geospatial data

Invalid geospatial data occurs when a place name (a city, for example) is listed under an incorrect parent (a state, for example). This issue might be a simple misspelling, or data entry error.

Note

Amazon QuickSight doesn't support regions (for example, West Coast or South) as geospatial data. However, you can use a region as a filter in a visual.

Issues with the default country in geocoding

Make sure that you are using the correct default country.

The default for each hierarchy is based on the country or country field that you choose when you create the hierarchy.

To change this default, you can return to the Create hierarchy screen. Then edit or create a hierarchy, and choose a different country.

If you don't create a hierarchy, your default country is based on your AWS Region. For details, see the following table.

Region Default country

US West (Oregon) Region

US East (Ohio) Region

US East (N. Virginia) Region

US
Asia Pacific (Singapore) Singapore
Asia Pacific (Sydney) Australia
Europe (Ireland) Region Ireland

Issues with latitude and longitude

Amazon QuickSight uses latitude and longitude coordinates in the background to find place names on a map. However, you can also use coordinates to create a map without using place names. This approach also works with unsupported place names.

Latitude and longitude values must be numeric. For example, the map point indicated by 28.5383355 -81.3792365 is compatible with Amazon QuickSight. But 28° 32' 18.0096'' N 81° 22' 45.2424'' W is not.

Valid ranges for latitude and longitude coordinates

Amazon QuickSight supports latitude and longitude coordinates within specific ranges.

Coordinate Valid range
Latitude Between -90 and 90
Longitude Between -180 to 180

Amazon QuickSight skips any data outside these ranges. Out-of-range points can't be mapped on a map chart.

Using coordinates in degrees, minutes, and seconds (DMS) format

You can use a calculated field with a formula to create a numeric latitude and longitude out of character strings. Use this section to find different ways that you can create calculated fields in Amazon QuickSight, to parse GPS latitude and longitude into numeric latitude and longitude.

The following sample converts latitude and longitude to numeric format from separate fields. For example, suppose that you parse 51° 30' 26.4636'' N 0° 7' 39.9288'' W using space as a delimiter. In this case, you can use something like the following sample to convert the resulting fields to numeric latitude and longitude.

In this example, the seconds are followed by two single quotation marks. If your data has a double quotation mark instead, then you can use strlen(LatSec)-1) instead of strlen(LatSec)-2).

/*Latitude*/ ifelse( LatDir = "N", parseInt(split(LatDeg, "°", 1)) + (parseDecimal(split(LatMin, "'", 1) ) /60) + (parseDecimal((substring(LatSec, 1, strlen(LatSec)-2) ) ) /3600), (parseInt(split(LatDeg, "°", 1)) + (parseDecimal(split(LatMin, "'", 1) ) /60) + (parseDecimal((substring(LatSec, 1, strlen(LatSec)-2) ) ) /3600)) * -1 ) /*Longitude*/ ifelse( LongDir = "E", parseInt(split(LongDeg, "°", 1)) + (parseDecimal(split(LongMin, "'", 1) ) /60) + (parseDecimal((substring(LongSec, 1, strlen(LongSec)-2) ) ) /3600), (parseInt(split(LongDeg, "°", 1)) + (parseDecimal(split(LongMin, "'", 1) ) /60) + (parseDecimal((substring(LongSec, 1, strlen(LongSec)-2) ) ) /3600)) * -1 )

If your data doesn't include the symbols for degree, minute and second, the formula looks like the following.

/*Latitude*/ ifelse( LatDir = "N", (LatDeg + (LatMin / 60) + (LatSec / 3600)), (LatDeg + (LatMin / 60) + (LatSec / 3600)) * -1 ) /*Longitude*/ ifelse( LongDir = "E", (LongDeg + (LongMin / 60) + (LongSec / 3600)), (LongDeg + (LongMin / 60) + (LongSec / 3600)) * -1 )

The following sample converts 53°21'N 06°15'W to numeric format. However, without the seconds, this location doesn't map as accurately.

/*Latitude*/ ifelse( right(Latitude, 1) = "N", (parseInt(split(Latitude, '°', 1)) + parseDecimal(substring(Latitude, (locate(Latitude, '°',3)+1), 2) ) / 60) , (parseInt(split(Latitude, '°', 1)) + parseDecimal(substring(Latitude, (locate(Latitude, '°',3)+1), 2) ) / 60) * -1 ) /*Longitude*/ ifelse( right(Longitude, 1) = "E", (parseInt(split(Longitude, '°', 1)) + parseDecimal(substring(Longitude, (locate(Longitude, '°',3)+1), 2) ) / 60) , (parseInt(split(Longitude, '°', 1)) + parseDecimal(substring(Longitude, (locate(Longitude, '°',3)+1), 2) ) / 60) * -1 )

The formats of GPS latitude and longitude can vary, so customize your formulas to match your data. For more information, see the following:

Supported administrative areas and postal codes by country

The following is a list of supported administrative areas by country.

Supported administrative areas
Country name Country code Country State County City

Aruba

ABW

Country

Regions

Zones

Afghanistan

AFG

Country

Wilayat

Wuleswali

Localities/Urban Areas

Angola

AGO

Country

Provinces/Províncias

Municipios

Localities/Urban Areas

Anguilla

AIA

Country

Parishes

Albania

ALB

Country

Qarqe/Qark

Communes/Bashki

Njësi/Localities/Urban Areas

Andorra

AND

Country

Parishes/Parròquies

Localities/Urban Areas

United Arab Emirates

ARE

Country

Emirates

Municipalities

Cities/Localities/Urban Areas

Argentina

ARG

Country

Provinces/Provincias

Departamentos/Departments

Comunas/Barrios

Armenia

ARM

Country

Provinces/Marzpet

Localities/Urban Areas

American Samoa

ASM

Country

Districts

Counties

Villages

Antarctica

ATA

Country

French Southern Territories

ATF

Country

Districts

Antigua and Barbuda

ATG

Country

Parishes

Localities/Urban Areas

Australia

AUS

Country

States

Local Government Areas

Suburbs/Urban Centers

Austria

AUT

Country

States/Bundesländer

Districts/Bezirke

Municipalities/Gemeinden/Urban Areas/Stadtteil

Azerbaijan

AZE

Country

Regions/Iqtisadi Rayonlar

Districts/Rayonlar

Localities/Urban Areas

Burundi

BDI

Country

Provinces

Communes

Localities/Urban Areas

Belgium

BEL

Country

Regions/Gewest

Provinces/Provincie

Districts/Arrondissements/Municipalities/Communes

Benin

BEN

Country

Departments

Communes

Localities/Urban Areas

Bonaire, Sint Eustasius, and Saba

BES

Country

Municipalities

Localities/Urban Areas

Burkina Faso

BFA

Country

Regions

Provinces

Communes/Localities/Urban Areas

Bangladesh

BGD

Country

Divisions/Bibhag

Districts/Zila

Subdistricts/Upzila/Localities/Urban Areas

Bulgaria

BGR

Country

Oblasts

Obshtina

Localities/Urban Areas

Bahrain

BHR

Country

Governorates

Constituencies

Localities

Bahamas

BHS

Country

Island Groups

Districts

Towns

Bosnia and Herzegovina

BIH

Country

Federation/Republika

Kanton

Opština/Localities/Urban Areas

Saint Barthélemy

BLM

Country

Localities/Urban Areas

Belarus

BLR

Country

Voblasts

Rayon

Selsoviet/Localities/Urban Areas

Belize

BLZ

Country

Districts

Constituencies

Localities/Urban Areas

Bermuda

BMU

Country

Parishes

Localities/Urban Areas

Bolivia

BOL

Country

Provinces/Provincias

Departamentos/Departments

Municipalities/Municipios/Localities/Urban Areas

Brazil

BRA

Country

Provinces/States/Unidades

Municipalities/Municipios

Localities/Urban Areas

Barbados

BRB

Country

Parishes

Localities/Urban Areas

Brunei

BRN

Country

Districts/Dawaïr

Subdistricts/Mukim

Villages/Kampung/Localities/Urban Areas

Bhutan

BTN

Country

Districts/Dzongkhag

Localities/Urban Areas

Bouvet Island

BVT

Country

Botswana

BWA

Country

Districts

Subdistricts

Localities/Urban Areas

Central African Republic

CAF

Country

Regions

Prefectures

Sub Prefectures/Communes

Canada

CAN

Country

Provinces/Territories

Census Divisions

Census Subdivisions/Localities/Urban Areas

Switzerland

CHE

Country

Cantons/Kanton/Cantone/Chantun

District/Bezirk/Distretto/Circul

"Commune/Gemeinde/Comune/Cumün/Localities/Urban Areas"

Chile

CHL

Country

Regions/Regiones

Province/Provincias

Communes/Comunas/Localities/Urban Areas

China, People's Republic of

CHN

Country

Provinces

Prefectures

Cities/Counties

Cote d'Ivoire

CIV

Country

Districts

Regions

Departments/Sub Prefectures

Cameroon

CMR

Country

Provinces/Regions

Departments

Arrondissements/Cities

Congo, Democratic Republic of

COD

Country

Provinces

Districts

Localities/Urban Areas

Congo, Republic of

COG

Country

Departments

Communes/Arrondissements

Cook Islands

COK

Country

Island Councils

Colombia

COL

Country

Departmentos

Municipios

Localities/Urban Areas

Comoros

COM

Country

Autonomous Islands/îles Autonomes

Villes/Villages

Clipperton Island

CPT

Country

Cape Verde

CPV

Country

Ilhas

Concelhos

Localities/Urban Areas

Costa Rica

CRI

Country

Provincias

Cantons

Distritos/Localities/Urban Areas

Cuba

CUB

Country

Provincias

Municipios

Localities/Urban Areas

Curaçoa

CUW

Country

Localities/Urban Areas

Cayman Islands

CYM

Country

Districts

Cyprus

CYP

Country

Districts/Eparchies

Municipalities/Dimos

Localities/Urban Areas/Sinikia

Czech Republic

CZE

Country

Regions/Kraj

Municipalities/Orp

Obec/Mesto

Germany

DEU

Country

Bundesland/States

Kreis/Districts

Gemeinde/Municipalities/Stadtteil/Localities/Urban Areas

Djibouti

DJI

Country

Regions

Localities/Urban Areas

Dominica

DMA

Country

Parishes

Localities/Urban Areas

Denmark

DNK

Country

Regions

Provinces

Municipalities/Localities/Urban Areas

Dominican Republic

DOM

Country

Regions/Regiones

Provinces/Provincias

Municipalities/Municipios/Localities/Urban Areas

Algeria

DZA

Country

Provinces/Wilayas

Districts

Municipalities/Baladiyas/Localities/Urban Areas

Ecuador

ECU

Country

Provinces

Cantons

Parishes/Localities/Urban Areas

Egypt

EGY

Country

Governorates/Muhafazat

Municipal Divisions/Markaz

Towns/Cities/Sub Municipal Divisions

Eritrea

ERI

Country

Regions/Zoba

Districts/Subzobas

Localities/Urban Areas

Spain

ESP

Country

Autonomous Communities/Comunidados Autonomas

Provincias

Municipios/Localities/Urban Areas

Estonia

EST

Country

Maakond

Omavalitsus/Linn/Vald

Küla/Localities/Urban Areas

Ethiopia

ETH

Country

Regions/Kililoch

Zones/Zonouch

Localities/Urban Areas

Finland

FIN

Country

Regions/Maakunta

Sub-Regions/Seutukunta

Municipalities/Kunta/Localities/Urban Areas

Fiji

FJI

Country

Divisions

Provinces

Districts/Villages

Falkland Islands

FLK

Country

France

FRA

Country

Regions

Départements

Arrondissements/Cantons

Faroe Islands

FRO

Country

Regions/Syslur

Municipalities/Kommunur

Localities/Urban Areas

Federated States of Micronesia

FSM

Country

States

Gabon

GAB

Country

Provinces

Departments

Localities/Urban Areas

United Kingdom

GBR

Country

Nations

Counties

Districts/Localities/Urban Areas

Georgia

GEO

Country

Regions/Mkhare

Municipalities/Munitsipaliteti

Localities/Urban Areas

Ghana

GHA

Country

Regions

Districts

Localities/Urban Areas

Gibraltar

GIB

Country

Localities/Urban Areas

Guinea

GIN

Country

Regions

Prefectures

Sub Prefectures/Localities/Urban Areas

Guadeloupe

GLP

Country

Arrondissements

Communes

Localities/Urban Areas

Gambia

GMB

Country

Regions

Districts

Localities/Urban Areas

Guinea Bissau

GNB

Country

Regions

Sectors

Localities/Urban Areas

Equatorial Guinea

GNQ

Country

Regions

Provincias

Distritos/Localities/Urban Areas

Greece

GRC

Country

Regions/Periphenies

Regional Units Peri Enotities

Municipalities/Domoi/Localities/Urban Areas

Grenada

GRD

Country

States

Parishes/Dependencies

Localities/Urban Areas

Greenland

GRL

Country

Municipalities/Kommunia

Guatemala

GTM

Country

Departments/Departamentos

Municipalities/Municipios

Localities/Urban Areas

French Guiana

GUF

Country

Arrondissements

Communes

Localities/Urban Areas

Guam

Country = USA

States

Districts

Guyana

GUY

Country

Regions

Neighborhood Councils

Localities/Urban Areas

Hong Kong

HKG

Country

Districts

Subdistricts

Localities/Urban Areas

Heard and McDonald Islands

HMD

Country

Honduras

HND

Country

Departments/Departamentos

Municipalities/Municipios

Localities/Urban Areas

Croatia

HRV

Country

Counties

Municipalities

Localities/Urban Areas

Haiti

HTI

Country

Departments/Départements

Districts/Arrondissements

Communes/Localities/Urban Areas

Hungary

HUN

Country

Regiok

Megyék

Járások/Városok

Indonesia

IDN

Country

Provinces/Provinsi

Regency/Kabupaten

Districts/Kecamatan/Localities/Urban Areas

India

IND

Country

States/Territories

Districts

Subdistricts/Towns/Localities/Urban Areas

British Indian Ocean Territory

IOT

Country

Ireland

IRL

Country

Regions

Counties

Electoral Divisions/Localities/Urban Areas

Iran

IRN

Country

Provinces/Ostanha

Counties/Shahrestan

Localities/Dehestân

Iraq

IRQ

Country

Governorates/Muhafazat

Districts/Qadaa/Kaza

Urban Areas/Localities

Iceland

ISL

Country

Regions/Landsvaedi

Municipalities/Sveitarfelog

Localities/Urban Areas

Israel

ISR

Country

Districts

Cities/Local Councils

Localities/Urban Areas

Italy

ITA

Country

Regiones

Provincias

Communes/Localities/Urban Areas

Jamaica

JAM

Country

Counties

Parishes

Constituencies/Localities/Urban Areas

Jordan

JOR

Country

Governorates

Districts

Subdistricts/Cities

Japan

JPN

Country

Prefectures

Cities/Districts/Municipalities

Kazakhstan

KAZ

Country

Regions/Oblystar

Districts/Audandar

Towns/Kent/Localities/Urban Areas

Kenya

KEN

Country

Counties

Constituencies

Localities/Urban Areas/Suburbs

Kyrgyzstan

KGZ

Country

Regions/Oblasttar

Districts/Raions

Localities/Urban Areas

Cambodia

KHM

Country

Provinces/Khaet

Districts/Srŏk

Communes/Khum/Localities/Urban Areas

Kiribati

KIR

Country

Districts

Island Councils

Saint Kitts and Nevis

KNA

Country

Parishes

States

Localities/Urban Areas

South Korea

KOR

Country

Provinces/Do

Districts/Si/Gun

Localities/Urban Areas

Kuwait

KWT

Country

Governorates/Muhafazah

Areas/Mintaqah

Cities/Communities

Laos

LAO

Country

Provinces/Khoueng

Districts/Muang

Localities/Urban Areas

Lebanon

LBN

Country

Governorates/Muhafazat

Districts/Qadaa

Municipalities/Localities/Urban Areas

Liberia

LBR

Country

Counties

Districts

Clans/Localities/Urban Areas

Libya

LBY

Country

Districts/Shabiya

Cities/Localities/Urban Areas

Saint Lucia

LCA

Country

Districts/Quarters

Localities/Urban Areas

Liechtenstein

LIE

Country

Districts/Bezirk

Municipalities/Gemeinden

Localities/Urban Areas

Sri Lanka

LKA

Country

Provinces

Districts

Divisional Secretariats/Localities/Urban Areas

Lesotho

LSO

Country

Districts

Constituencies

Community Councils/Localities

Lithuania

LTU

Country

Apskritis

Savivaldybé

Seniūnija

Luxembourg

LUX

Country

Cantons/Kantounen/Kantone

Communes/Gemengen/Gemeinden

Localities/Ortschaft/Uertschaft/Cities

Latvia

LVA

Country

Regions

Municipalities/Novadi

Pilsētas/Pagasti/Localities/Urban Areas

Macao

MAC

Country

Parishes

Districts

Saint Martin

MAF

Country

Localities/Urban Areas

Morocco

MAR

Country

Regions

Provinces/Prefectures

Communes/Localities/Urban Areas

Monaco

MCO

Country

Communes

Wards/Quartiers

Moldova

MDA

Country

Raion

Comuna

Localities/Urban Areas

Madagascar

MDG

Country

Regions/Faritra

Districts

Communes/Localities/Urban Areas

Maldives

MDV

Country

Atolls/Cities

Islands

Mexico

MEX

Country

Estados

Municipios/Delegaciones

Colonias/Localities/Urban Areas

Marshall Islands

MHL

Country

Municipalities

Macedonia

MKD

Country

Statistical Regions

Opstina

Localities/Urban Areas

Mali

MLI

Country

Regions

Communes

Localities/Urban Areas

Malta

MLT

Country

Districts

Local Councils/Kunsilli Lokali

Localities/Urban Areas

Myanmar

MMR

Country

States/Regions/Union Territories

Districts

Townships/Localities/Urban Areas

Montenegro

MNE

Country

Opštine/Municipalities

Localities/Urban Areas

Mongolia

MNG

Country

Regions

Provinces/Aimags

Districts/Sums/Localities/Urban Areas

Northern Mariana Islands

MNP

Country

Municipalities

Mozambique

MOZ

Country

Provinces

Districts/Distritos

Localities/Urban Areas

Mauritania

MRT

Country

Regions

Départements

Localities/Urban Areas

Montserrat

MSR

Country

Parishes

Regions

Localities/Urban Areas

Martinique

MTQ

Country

Arrondissements

Communes

Localities/Urban Areas

Mauritius

MUS

Country

Islands

Districts

Wards/Localities/Urban Areas

Malawi

MWI

Country

Regions

Districts

Localities/Urban Areas

Malaysia

MYS

Country

States/Negeri

Districts/Daïra/Daerah

Subdistricts/Mukim/Localities/Urban Area/Bahagian Kecil

Mayotte

MYT

Country

Communes

Villages

Namibia

NAM

Country

Provinces

Constituencies

Suburbs/Localities

New Caledonia

NCL

Country

Provinces

Communes

Niger

NER

Country

Regions

Departments

Localities/Urban Areas

Nigeria

NGA

Country

States

Local Government Areas

Towns/Cities

Nicaragua

NIC

Country

Departments/Departamentos

Municipalities/Municipios

Localities/Urban Areas

Niue

NIU

Country

Villages

Towns

Netherlands

NLD

Country

Counties/Fylker

Districts/Okonomisk

Municipalities, Kommuner, Localities, or Urban Areas

Norway

NOR

Country

Counties/Fylker

Districts/Okonomisk

Municipalities, Kommuner, Localities, or Urban Areas

Nepal

NPL

Country

Provinces/Pradeshaharu

Districts/Jilla

Municipalities/Localities/Urban Areas

Nauru

NRU

Country

Districts

New Zealand

NZL

Country

Regions

Territorial Authorities

Statistical Areas/Localities/Urban Areas

Oman

OMN

Country

Governorates/Muhafazah

Provinces/Wilayat

Cities/Urban Areas/Communities

Pakistan

PAK

Country

Provinces

Districts

Localities/Tehsils

Panama

PAN

Country

Provinces/Provincias

Districts/Distrito

Corregimientos/Localities/Urban Areas

Pitcairn Islands

PCN

Country

Islands

Peru

PER

Country

Regions

Districts

Distritos/Localities/Urban Areas

Philippines

PHL

Country

Regions/Rehiyon

Provinces/Lalawigan

Municipalities/Munisipiyos/Cities/Lungsod

Palau

PLW

Country

States

Papua New Guinea

PNG

Country

Regions

Provinces

Districts/Localities/Urban Areas

Poland

POL

Country

Provinces/Voivodeships

Counties/Powiats

Communes/Gminas/Towns/Dzielnicas

North Korea

PRK

Country

Provinces

Localities/Urban Areas

Portugal

PRT

Country

Districts/Distritos

Municipalities/Concelhos

Civil Parish/Freguesias/Localities/Urban Areas

Paraguay

PRY

Country

Departments

Distritos

Localities/Urban Areas

Palestine

PSE

Country

Territories

Governorates/Muhafazat

Localities/Urban Areas

French Polynesia

PYF

Country

Subdivisions/Iles

Communes

Qatar

QAT

Country

Municipalities/Baladiyat

Zones

Localities/Urban Areas

Réunion

REU

Country

Arrondissements

Communes

Localities/Urban Areas

Romania

ROU

Country

Regions/Judete

Communes

Towns/Oraș

Russia

RUS

Country

Federal District/Federal'nyy Okrug

Oblast'

Rayon/Raion/Urban Area/Gorod

Rwanda

RWA

Country

Provinces

Districts

Sectors/Secteurs/Localities/Urban Areas

Saudi Arabia

SAU

Country

Regions/Manatiq

Governorates/Muhafazat

Municipalities/Amanah

Sudan

SDN

Country

States/Wilaya'at

Localities/Urban Areas

Senegal

SEN

Country

Regions

Departments

Arrondissements/Localities/Urban Areas

Singapore

SGP

Country

Districts

Constituencies

Wards

Saint Helena

SHN

Country

Islands

Districts

Localities/Urban Areas

Solomon Islands

SLB

Country

Provinces

Constituencies

Wards

Sierra Leone

SLE

Country

Provinces

Districts

Chiefdoms/Localities/Urban Areas

El Salvador

SLV

Country

Departments/Departamentos

Municipalities/Municipios

Localities/Urban Areas

San Marino

SMR

Country

Municipalities/Castelli

Localities/Urban Areas

Somalia

SOM

Country

Regions/Gobolada

Localities/Urban Areas

Saint Pierre and Miquelon

SPM

Country

Communes

Serbia

SRB

Country

Autonomna Pokrajina/Regions

Okrug/Districts

Opstina/Municipalities/Localities/Urban Areas

South Sudan

SSD

Country

States/Wilayat

Counties

Localities/Urban Areas

São Tomé and Príncipe

STP

Country

Provinces

Districts

Localities/Urban Areas

Suriname

SUR

Country

Districts/Distrikt

Resorts

Localities/Urban Areas

Slovakia

SVK

Country

Regions/Kraje

Districts/Okresy

Municipalities/Obec/Mestská cast

Slovenia

SVN

Country

Regions/Regi

Upravne Enote

Municipalities/Obcine/Localities/Urban Areas

Sweden

SWE

Country

Counties

Municipalities

Localities/Urban Areas

Eswatini

SWZ

Country

Regions

Tinkhundla

Towns/Suburbs/Localities

Sint Maarten

SXM

Country

Settlements

Seychelles

SYC

Country

Districts

Localities/Urban Areas

Syria

SYR

Country

Governorates

Districts/Muhafazah

Cities/Localities/Urban Areas

Turks and Caicos Islands

TCA

Country

Districts

Localities

Chad

TCD

Country

Regions

Départements

Arrondissements/Localities/Urban Areas

Togo

TGO

Country

Regions/Provinces

Prefectures

Localities/Urban Areas

Thailand

THA

Country

Provinces/Changwat

Districts/Amphoe

Subdistricts/Tambon/Localities/Urban Areas

Tajikistan

TJK

Country

Provinces/Regions

Districts/Raion/Rayon

Localities/Urban Areas

Tokelau

TKL

Country

Atolls

Turkmenistan

TKM

Country

Provinces/Welayat

Districts/Etraplar

Towns

East Timor (Timor-Leste)

TLS

Country

Municipalities

Administrative Post

Localities/Urban Areas

Tonga

TON

Country

Subdivisions

Trinidad and Tobago

TTO

Country

Municipalities

Localities/Urban Areas

Tunisia

TUN

Country

Governates/Wilayahs

Delegations/Mutamadiyats

Municipalities/Shaykhats/Localities/Urban Areas

Turkey

TUR

Country

Provinces/Il

Districts/Ilce

Urban Areas/Belde/Subdistricts/Bucak/Neighborhoods/Mahalle

Tuvalu

TUV

Country

Islands

Taiwan

TWN

Country

Provinces

Counties

Townships/Local Neighborhoods

Tanzania

TZA

Country

Provinces/Mkoa

Districts/Wilaya

Localities/Urban Areas

Uganda

UGA

Country

Regions

Districts

Counties/Localities/Urban Areas

Ukraine

UKR

Country

Oblast/Mista/Avtonomna Respublika

Raions

Settlement Councils/Rural Councils/Localities/Urban Areas

United States Minor Outlying Islands

UMI

Country

Islands/Atolls

Uruguay

URY

Country

Departments/Departamentos

Municipios/Municipalities/Secciones

Segmentos/Localities/Urban Areas

United States of America

USA

Country

States/Territories

Counties

MCD/CCD/Post Localities/Municipalities

Uzbekistan

UZB

Country

Regions/Viloyatlar

Districts/Tumanlar

Localities/Urban Areas

Vatican City

VAT

Country

Localities/Urban Areas

Saint Vincent and the Grenadines

VCT

Country

Parishes

Divisions

Localities/Urban Areas

Venezuela

VEN

Country

States/Estados

Municipalities/Municipios

Localities/Urban Areas/Parish/Parroquias

British Virgin Islands

VGB

Country

Districts

Vietnam

VNM

Country

Provinces/Cities

Districts

Wards/Localities/Urban Areas

Vanuatu

VUT

Country

Provinces

Wallis and Futuna Islands

WLF

Country

Districts/Rayaumes

Samoa

WSM

Country

Districts/Itūmālō

Towns

Localities/Urban Areas

Kosovo

XKS

Country

Districts

Municipalities

Localities/Urban Areas

Yemen

YEM

Country

Governorates/Muhafazat

Districts/Muderiah

Localities/Urban Areas

South Africa

ZAF

Country

Provinces

Districts

Municipalities/Wards

Zambia

ZMB

Country

Provinces

Districts

Suburbs/Localities

Zimbabwe

ZWE

Country

Provinces

Districts/Muderiah

Localities/Urban Areas

The following is a list of the supported postal code formats by country, including the number of digits and an example postal code.

Supported postal codes
Country Postal format Example

Afghanistan

4 digit

1001

Albania

4 digit

1001

Algeria

5 digit

01000

American Samoa

5 digit

96799

Andorra

5 digit

AD100

Anguilla

6 digit

AI-2640

Argentina

5 digit

A4126

Armenia

2 digit

00

Australia

4 digit

0800

Austria

4 digit

1010

Azerbaijan

2 digit

01

Brunei Darussalam

6 digit

BA1111

Bahrain

4 digit

0101

Bangladesh

2 digit

10

Belarus

6 digit

202115

Belgium

4 digit

1000

Bermuda

4 digit

CR 01

Bhutan

2 digit

11

Bosnia and Herzegovina

5 digit

70101

Brazil

5 digit

01001

British Indian Ocean Territory

Alphanumeric ‐ 5 digit

BBND 1

British Virgin Islands

4 digit

1110

Bulgaria

4 digit

1000

Cabo Verde

4 digit

1101

Cambodia

2 digit

01

Canada

3 digit

A0A

Cayman Islands

Alphanumeric - 7 digit

KY1-1000

Chile

3 digit

100

China

4 digit

0100

Colombia

4 digit

0500

Costa Rica

5 digit

10101

Croatia

5 digit

10000

Cuba

1 digit

1

Cyprus

4 digit

1010

Czechia

5 digit

100 00

Democratic Republic of the Congo

4 digit

1001

Denmark

4 digit

1050

Dominican Republic

5 digit

10101

Ecuador

6 digit

010101

Egypt

2 digit

11

El Salvador

4 digit

1101

Estonia

5 digit

10001

Falkland Islands

Alphanumeric - 5 digit

FIQQ 1

Faroe Islands

3 digit

100

Finland

5 digit

00100

France

5 digit

01000

French Guiana

5 digit

97300

French Polynesia

5 digit

98701

Georgia

2 digit

01

Germany

5 digit

01067

Ghana

2 digit

A2

Gibraltar

Alphanumeric - 5 digit

GX11 1

Greece

5 digit

104 31

Greenland

4 digit

3900

Guadeloupe

5 digit

97100

Guam

5 digit

96910

Guatemala

5 digit

01001

Guernsey

Alphanumeric - 4 digit, 5 digit

GY1 1, GY10 1

Guinea-Bissau

4 digit

1000

Haiti

4 digit

1110

Holy See

5 digit

00120

Honduras

2 digit

11

Hungary

4 digit

1007

Iceland

3 digit

101

India

6 digit

110001

Indonesia

5 digit

10110

Iran

2 digit

11

Iraq

2 digit

10

Ireland

3 digit

A41

Isle of Man

Alphanumeric - 4 digit

IM1 1

Israel

5 digit

10292

Italy

5 digit

00010

Japan

7 digit

001-0010

Jersey

Alphanumeric - 4 digit

JE2 3

Jordan

5 digit

11100

Kazakhstan

4 digit

0100

Kenya

1 digit

0

Kiribati

6 digit

KI0101

Kosovo

5 digit

10000

Kuwait

2 digit

00

Kyrgyzstan

4 digit

7200

Laos

2 digit

01

Latvia

4 digit

1001

Lesotho

1 digit

1

Liberia

2 digit

10

Liechtenstein

4 digit

9485

Lithuania

5 digit

00100

Luxembourg

4 digit

1110

Macedonia

4 digit

1000

Madagascar

3 digit

101

Malawi

3 digit

101

Malaysia

5 digit

01000

Maldives

2 digit

00

Malta

3 digit

ATD

Marshall Islands

3 digit

969

Martinique

5 digit

97200

Mauritius

3 digit

111

Mayotte

5 digit

97600

Mexico

5 digit

01000

Micronesia

5 digit

96941

Moldova

4 digit

2001

Monaco

5 digit

98000

Mongolia

4 digit

1200

Montenegro

5 digit

81000

Montserrat

4 digit

1120

Morocco

5 digit

10000

Mozambique

4 digit

1100

Myanmar

2 digit

01

Namibia

3 digit

100

Nepal

3 digit

101

Netherlands

4 digit

1011

New Caledonia

5 digit

98800

New Zealand

4 digit

0110

Nicaragua

3 digit

110

Niger

4 digit

1000

Nigeria

4 digit

1002

Niue

4 digit

9974

Norfolk Island

4 digit

2899

Northern Mariana Islands

5 digit

96950

Norway

4 digit

0010

Oman

1 digit

1

Pakistan

2 digit

10

Palau

5 digit

96939

Palestine

4 digit

P104

Papua New Guinea

3 digit

111

Paraguay

6 digit

001001

Peru

5 digit

01000

Philippines

4 digit

1000

Pitcairn

Alphanumeric - 5 digit

PCRN 1

Poland

5 digit

00-002

Portugal

4 digit

1000

Puerto Rico

5 digit

00601

Romania

6 digit

010011

Russia

6 digit

101000

Réunion

5 digit

97400

Saint Barthélemy

5 digit

97133

Saint Helena, Ascension and Tristan da Cunha

Alphanumeric - 5 digit

ASCN 1

Saint Lucia

7 digit

LC01 101

Saint Martin

5 digit

97150

Saint Pierre and Miquelon

5 digit

97500

Saint Vincent and the Grenadines

4 digit

VC01

Samoa

2 digit

11

San Marino

5 digit

47890

Saudi Arabia

2 digit

12

Senegal

5 digit

10000

Serbia

5 digit

11000

Singapore

6 digit

018906

Slovakia

5 digit

010 01

Slovenia

4 digit

1000

South Africa

4 digit

0001

South Georgia and the South Sandwich Islands

Alphanumeric - 5 digit

SIQQ 1

South Korea

5 digit

01000

Spain

5 digit

01001

Sri Lanka

2 digit

00

Sudan

2 digit

11

Svalbard and Jan Mayen

4 digit

8099

Swaziland

1 digit

H

Sweden

5 digit

111 15

Switzerland

4 digit

1000

Taiwan

3 digit

100

Tajikistan

4 digit

7340

Tanzania, United Republic of

3 digit

111

Thailand

5 digit

10100

Timor-Leste

4 digit

TL10

Trinidad and Tobago

2 digit

10

Tunisia

4 digit

1000

Turkey

5 digit

01010

Turkmenistan

3 digit

744

Turks and Caicos Islands

Alphanumeric - 5 digit

TKCA 1

U.S. Virgin Islands

5 digit

00802

Ukraine

3 digit, 5 digit

070, 01001

United Kingdom

Alphanumeric - 2 to 5 digits

B1, AL1, AB10, AB10 1

United States

5 digit

00001

Uruguay

5 digit

11000

Uzbekistan

4 digit

1000

Venezuela

4 digit

0000

Vietnam

5 digit

01106

Wallis and Futuna

5 digit

98600

Zambia

5 digit

10100