How to convert country names to ISO 3166-1 alpha-2 values, using python
Asked Answered
D

11

61

I have a list of countries like:

countries=['American Samoa', 'Canada', 'France'...]

I want to convert them like this:

countries=['AS', 'CA', 'FR'...]

Is there any module or any way to convert them?

Dither answered 27/4, 2013 at 14:9 Comment(0)
J
84

There is a module called pycountry.

Here's an example code:

import pycountry

input_countries = ['American Samoa', 'Canada', 'France']

countries = {}
for country in pycountry.countries:
    countries[country.name] = country.alpha_2

codes = [countries.get(country, 'Unknown code') for country in input_countries]

print(codes)  # prints ['AS', 'CA', 'FR']
Jamilajamill answered 27/4, 2013 at 14:19 Comment(8)
Worth mentioning that now you can also use the get method: pycountry.countries.get(name='American Samoa').alpha2.Vinaigrette
alpha2 got renamed to alpha_2Id
it's good, but also 9.2Mb! So I used the csv mentioned by @Ashwini_Chaudhary with only 9.6KbMareah
unfortunately it returns no value for pretty trivial countries out there. for example: pycountry.countries.get(name='Syria').alpha_2 but this library seems to work: pypi.org/project/country-converterHedvig
@PolinaSklyarevsky Plus it's only 49 kb, and much straightforward to use !Euphonize
Syria is there, just not as you were looking for it:[{'alpha_2': 'SY', 'alpha_3': 'SYR', 'name': 'Syrian Arab Republic', 'numeric': '760', 'official_name': nan, 'common_name': nan}]Lemal
@Marc Torrellas Socastro who uses the name Syrian Arab Republic for Syria? I find country-converter to be great for converting user input country names (i.e. actual humans entering what they think the name of a country is)Scyphate
@jackwest yeah, didn't mean it to be the best name. Just explaining that most (if not all) countries are there, but not in the most natural surface form, making it a bad choiceLemal
A
21

You can use this csv file : country code list into a CSV.

import csv

dic = {}
with open("wikipedia-iso-country-codes.csv") as f:
    file= csv.DictReader(f, delimiter=',')
    for line in file:
        dic[line['English short name lower case']] = line['Alpha-2 code']        

countries = ['American Samoa', 'Canada', 'France']

for country in countries:
    print(dic[country])

Will print:

AS
CA
FR

Few more alternatives.

Admiration answered 27/4, 2013 at 14:15 Comment(0)
R
15

Below is a dictionary mapping country names to their codes in ISO 3166-1 alpha-2. You can use it for this purpose. Unless you want to be adventurous, using pycountry is a better idea.

{'Afghanistan': 'AF',
 'Albania': 'AL',
 'Algeria': 'DZ',
 'American Samoa': 'AS',
 'Andorra': 'AD',
 'Angola': 'AO',
 'Anguilla': 'AI',
 'Antarctica': 'AQ',
 'Antigua and Barbuda': 'AG',
 'Argentina': 'AR',
 'Armenia': 'AM',
 'Aruba': 'AW',
 'Australia': 'AU',
 'Austria': 'AT',
 'Azerbaijan': 'AZ',
 'Bahamas': 'BS',
 'Bahrain': 'BH',
 'Bangladesh': 'BD',
 'Barbados': 'BB',
 'Belarus': 'BY',
 'Belgium': 'BE',
 'Belize': 'BZ',
 'Benin': 'BJ',
 'Bermuda': 'BM',
 'Bhutan': 'BT',
 'Bolivia, Plurinational State of': 'BO',
 'Bonaire, Sint Eustatius and Saba': 'BQ',
 'Bosnia and Herzegovina': 'BA',
 'Botswana': 'BW',
 'Bouvet Island': 'BV',
 'Brazil': 'BR',
 'British Indian Ocean Territory': 'IO',
 'Brunei Darussalam': 'BN',
 'Bulgaria': 'BG',
 'Burkina Faso': 'BF',
 'Burundi': 'BI',
 'Cambodia': 'KH',
 'Cameroon': 'CM',
 'Canada': 'CA',
 'Cape Verde': 'CV',
 'Cayman Islands': 'KY',
 'Central African Republic': 'CF',
 'Chad': 'TD',
 'Chile': 'CL',
 'China': 'CN',
 'Christmas Island': 'CX',
 'Cocos (Keeling) Islands': 'CC',
 'Colombia': 'CO',
 'Comoros': 'KM',
 'Congo': 'CG',
 'Congo, the Democratic Republic of the': 'CD',
 'Cook Islands': 'CK',
 'Costa Rica': 'CR',
 'Croatia': 'HR',
 'Cuba': 'CU',
 'Curaçao': 'CW',
 'Cyprus': 'CY',
 'Czech Republic': 'CZ',
 "Côte d'Ivoire": 'CI',
 'Denmark': 'DK',
 'Djibouti': 'DJ',
 'Dominica': 'DM',
 'Dominican Republic': 'DO',
 'Ecuador': 'EC',
 'Egypt': 'EG',
 'El Salvador': 'SV',
 'Equatorial Guinea': 'GQ',
 'Eritrea': 'ER',
 'Estonia': 'EE',
 'Ethiopia': 'ET',
 'Falkland Islands (Malvinas)': 'FK',
 'Faroe Islands': 'FO',
 'Fiji': 'FJ',
 'Finland': 'FI',
 'France': 'FR',
 'French Guiana': 'GF',
 'French Polynesia': 'PF',
 'French Southern Territories': 'TF',
 'Gabon': 'GA',
 'Gambia': 'GM',
 'Georgia': 'GE',
 'Germany': 'DE',
 'Ghana': 'GH',
 'Gibraltar': 'GI',
 'Greece': 'GR',
 'Greenland': 'GL',
 'Grenada': 'GD',
 'Guadeloupe': 'GP',
 'Guam': 'GU',
 'Guatemala': 'GT',
 'Guernsey': 'GG',
 'Guinea': 'GN',
 'Guinea-Bissau': 'GW',
 'Guyana': 'GY',
 'Haiti': 'HT',
 'Heard Island and McDonald Islands': 'HM',
 'Holy See (Vatican City State)': 'VA',
 'Honduras': 'HN',
 'Hong Kong': 'HK',
 'Hungary': 'HU',
 'Iceland': 'IS',
 'India': 'IN',
 'Indonesia': 'ID',
 'Iran, Islamic Republic of': 'IR',
 'Iraq': 'IQ',
 'Ireland': 'IE',
 'Isle of Man': 'IM',
 'Israel': 'IL',
 'Italy': 'IT',
 'Jamaica': 'JM',
 'Japan': 'JP',
 'Jersey': 'JE',
 'Jordan': 'JO',
 'Kazakhstan': 'KZ',
 'Kenya': 'KE',
 'Kiribati': 'KI',
 "Korea, Democratic People's Republic of": 'KP',
 'Korea, Republic of': 'KR',
 'Kuwait': 'KW',
 'Kyrgyzstan': 'KG',
 "Lao People's Democratic Republic": 'LA',
 'Latvia': 'LV',
 'Lebanon': 'LB',
 'Lesotho': 'LS',
 'Liberia': 'LR',
 'Libya': 'LY',
 'Liechtenstein': 'LI',
 'Lithuania': 'LT',
 'Luxembourg': 'LU',
 'Macao': 'MO',
 'Macedonia, the former Yugoslav Republic of': 'MK',
 'Madagascar': 'MG',
 'Malawi': 'MW',
 'Malaysia': 'MY',
 'Maldives': 'MV',
 'Mali': 'ML',
 'Malta': 'MT',
 'Marshall Islands': 'MH',
 'Martinique': 'MQ',
 'Mauritania': 'MR',
 'Mauritius': 'MU',
 'Mayotte': 'YT',
 'Mexico': 'MX',
 'Micronesia, Federated States of': 'FM',
 'Moldova, Republic of': 'MD',
 'Monaco': 'MC',
 'Mongolia': 'MN',
 'Montenegro': 'ME',
 'Montserrat': 'MS',
 'Morocco': 'MA',
 'Mozambique': 'MZ',
 'Myanmar': 'MM',
 'Namibia': 'NA',
 'Nauru': 'NR',
 'Nepal': 'NP',
 'Netherlands': 'NL',
 'New Caledonia': 'NC',
 'New Zealand': 'NZ',
 'Nicaragua': 'NI',
 'Niger': 'NE',
 'Nigeria': 'NG',
 'Niue': 'NU',
 'Norfolk Island': 'NF',
 'Northern Mariana Islands': 'MP',
 'Norway': 'NO',
 'Oman': 'OM',
 'Pakistan': 'PK',
 'Palau': 'PW',
 'Palestine, State of': 'PS',
 'Panama': 'PA',
 'Papua New Guinea': 'PG',
 'Paraguay': 'PY',
 'Peru': 'PE',
 'Philippines': 'PH',
 'Pitcairn': 'PN',
 'Poland': 'PL',
 'Portugal': 'PT',
 'Puerto Rico': 'PR',
 'Qatar': 'QA',
 'Romania': 'RO',
 'Russian Federation': 'RU',
 'Rwanda': 'RW',
 'Réunion': 'RE',
 'Saint Barthélemy': 'BL',
 'Saint Helena, Ascension and Tristan da Cunha': 'SH',
 'Saint Kitts and Nevis': 'KN',
 'Saint Lucia': 'LC',
 'Saint Martin (French part)': 'MF',
 'Saint Pierre and Miquelon': 'PM',
 'Saint Vincent and the Grenadines': 'VC',
 'Samoa': 'WS',
 'San Marino': 'SM',
 'Sao Tome and Principe': 'ST',
 'Saudi Arabia': 'SA',
 'Senegal': 'SN',
 'Serbia': 'RS',
 'Seychelles': 'SC',
 'Sierra Leone': 'SL',
 'Singapore': 'SG',
 'Sint Maarten (Dutch part)': 'SX',
 'Slovakia': 'SK',
 'Slovenia': 'SI',
 'Solomon Islands': 'SB',
 'Somalia': 'SO',
 'South Africa': 'ZA',
 'South Georgia and the South Sandwich Islands': 'GS',
 'South Sudan': 'SS',
 'Spain': 'ES',
 'Sri Lanka': 'LK',
 'Sudan': 'SD',
 'Suriname': 'SR',
 'Svalbard and Jan Mayen': 'SJ',
 'Swaziland': 'SZ',
 'Sweden': 'SE',
 'Switzerland': 'CH',
 'Syrian Arab Republic': 'SY',
 'Taiwan, Province of China': 'TW',
 'Tajikistan': 'TJ',
 'Tanzania, United Republic of': 'TZ',
 'Thailand': 'TH',
 'Timor-Leste': 'TL',
 'Togo': 'TG',
 'Tokelau': 'TK',
 'Tonga': 'TO',
 'Trinidad and Tobago': 'TT',
 'Tunisia': 'TN',
 'Turkey': 'TR',
 'Turkmenistan': 'TM',
 'Turks and Caicos Islands': 'TC',
 'Tuvalu': 'TV',
 'Uganda': 'UG',
 'Ukraine': 'UA',
 'United Arab Emirates': 'AE',
 'United Kingdom': 'GB',
 'United States': 'US',
 'United States Minor Outlying Islands': 'UM',
 'Uruguay': 'UY',
 'Uzbekistan': 'UZ',
 'Vanuatu': 'VU',
 'Venezuela, Bolivarian Republic of': 'VE',
 'Viet Nam': 'VN',
 'Virgin Islands, British': 'VG',
 'Virgin Islands, U.S.': 'VI',
 'Wallis and Futuna': 'WF',
 'Western Sahara': 'EH',
 'Yemen': 'YE',
 'Zambia': 'ZM',
 'Zimbabwe': 'ZW',
 'Åland Islands': 'AX'}
Reimburse answered 28/4, 2013 at 13:55 Comment(1)
This contains 'Country name': 'Code', and 'ISO 3166-2:GB': '(.uk)', in the middle!Giorgio
D
9

Below is a dictionary mapping country names from ISO 3166-1 alpha-2 to ISO 3166-1 alpha-2.

convert_ISO_3166_2_to_1 = {
'AF':'AFG',
'AX':'ALA',
'AL':'ALB',
'DZ':'DZA',
'AS':'ASM',
'AD':'AND',
'AO':'AGO',
'AI':'AIA',
'AQ':'ATA',
'AG':'ATG',
'AR':'ARG',
'AM':'ARM',
'AW':'ABW',
'AU':'AUS',
'AT':'AUT',
'AZ':'AZE',
'BS':'BHS',
'BH':'BHR',
'BD':'BGD',
'BB':'BRB',
'BY':'BLR',
'BE':'BEL',
'BZ':'BLZ',
'BJ':'BEN',
'BM':'BMU',
'BT':'BTN',
'BO':'BOL',
'BA':'BIH',
'BW':'BWA',
'BV':'BVT',
'BR':'BRA',
'IO':'IOT',
'BN':'BRN',
'BG':'BGR',
'BF':'BFA',
'BI':'BDI',
'KH':'KHM',
'CM':'CMR',
'CA':'CAN',
'CV':'CPV',
'KY':'CYM',
'CF':'CAF',
'TD':'TCD',
'CL':'CHL',
'CN':'CHN',
'CX':'CXR',
'CC':'CCK',
'CO':'COL',
'KM':'COM',
'CG':'COG',
'CD':'COD',
'CK':'COK',
'CR':'CRI',
'CI':'CIV',
'HR':'HRV',
'CU':'CUB',
'CY':'CYP',
'CZ':'CZE',
'DK':'DNK',
'DJ':'DJI',
'DM':'DMA',
'DO':'DOM',
'EC':'ECU',
'EG':'EGY',
'SV':'SLV',
'GQ':'GNQ',
'ER':'ERI',
'EE':'EST',
'ET':'ETH',
'FK':'FLK',
'FO':'FRO',
'FJ':'FJI',
'FI':'FIN',
'FR':'FRA',
'GF':'GUF',
'PF':'PYF',
'TF':'ATF',
'GA':'GAB',
'GM':'GMB',
'GE':'GEO',
'DE':'DEU',
'GH':'GHA',
'GI':'GIB',
'GR':'GRC',
'GL':'GRL',
'GD':'GRD',
'GP':'GLP',
'GU':'GUM',
'GT':'GTM',
'GG':'GGY',
'GN':'GIN',
'GW':'GNB',
'GY':'GUY',
'HT':'HTI',
'HM':'HMD',
'VA':'VAT',
'HN':'HND',
'HK':'HKG',
'HU':'HUN',
'IS':'ISL',
'IN':'IND',
'ID':'IDN',
'IR':'IRN',
'IQ':'IRQ',
'IE':'IRL',
'IM':'IMN',
'IL':'ISR',
'IT':'ITA',
'JM':'JAM',
'JP':'JPN',
'JE':'JEY',
'JO':'JOR',
'KZ':'KAZ',
'KE':'KEN',
'KI':'KIR',
'KP':'PRK',
'KR':'KOR',
'KW':'KWT',
'KG':'KGZ',
'LA':'LAO',
'LV':'LVA',
'LB':'LBN',
'LS':'LSO',
'LR':'LBR',
'LY':'LBY',
'LI':'LIE',
'LT':'LTU',
'LU':'LUX',
'MO':'MAC',
'MK':'MKD',
'MG':'MDG',
'MW':'MWI',
'MY':'MYS',
'MV':'MDV',
'ML':'MLI',
'MT':'MLT',
'MH':'MHL',
'MQ':'MTQ',
'MR':'MRT',
'MU':'MUS',
'YT':'MYT',
'MX':'MEX',
'FM':'FSM',
'MD':'MDA',
'MC':'MCO',
'MN':'MNG',
'ME':'MNE',
'MS':'MSR',
'MA':'MAR',
'MZ':'MOZ',
'MM':'MMR',
'NA':'NAM',
'NR':'NRU',
'NP':'NPL',
'NL':'NLD',
'AN':'ANT',
'NC':'NCL',
'NZ':'NZL',
'NI':'NIC',
'NE':'NER',
'NG':'NGA',
'NU':'NIU',
'NF':'NFK',
'MP':'MNP',
'NO':'NOR',
'OM':'OMN',
'PK':'PAK',
'PW':'PLW',
'PS':'PSE',
'PA':'PAN',
'PG':'PNG',
'PY':'PRY',
'PE':'PER',
'PH':'PHL',
'PN':'PCN',
'PL':'POL',
'PT':'PRT',
'PR':'PRI',
'QA':'QAT',
'RE':'REU',
'RO':'ROU',
'RU':'RUS',
'RW':'RWA',
'BL':'BLM',
'SH':'SHN',
'KN':'KNA',
'LC':'LCA',
'MF':'MAF',
'PM':'SPM',
'VC':'VCT',
'WS':'WSM',
'SM':'SMR',
'ST':'STP',
'SA':'SAU',
'SN':'SEN',
'RS':'SRB',
'SC':'SYC',
'SL':'SLE',
'SG':'SGP',
'SK':'SVK',
'SI':'SVN',
'SB':'SLB',
'SO':'SOM',
'ZA':'ZAF',
'GS':'SGS',
'ES':'ESP',
'LK':'LKA',
'SD':'SDN',
'SR':'SUR',
'SJ':'SJM',
'SZ':'SWZ',
'SE':'SWE',
'CH':'CHE',
'SY':'SYR',
'TW':'TWN',
'TJ':'TJK',
'TZ':'TZA',
'TH':'THA',
'TL':'TLS',
'TG':'TGO',
'TK':'TKL',
'TO':'TON',
'TT':'TTO',
'TN':'TUN',
'TR':'TUR',
'TM':'TKM',
'TC':'TCA',
'TV':'TUV',
'UG':'UGA',
'UA':'UKR',
'AE':'ARE',
'GB':'GBR',
'US':'USA',
'UM':'UMI',
'UY':'URY',
'UZ':'UZB',
'VU':'VUT',
'VE':'VEN',
'VN':'VNM',
'VG':'VGB',
'VI':'VIR',
'WF':'WLF',
'EH':'ESH',
'YE':'YEM',
'ZM':'ZMB',
'ZW':'ZWE'
}
Dithionite answered 8/6, 2019 at 2:59 Comment(0)
E
4

It was suggested in a comment by Polina, country_converter is a nice alternative to pycountry :

  • conversion is straightforward :

    convert(names=["list","of","countries"], to=out_format)

    with out_format="ISO2" in OP's case (in my case I needed out_format="short_name"), and the countries being literally anything (try ['United Rep. of Tanzania', 'Cape Verde', 'Burma', 'China', 'FR', 'USA', 'Korea, Rep. of', 'Iran (Islamic Republic)']) ;

  • it's only 49 kB (as of today pycountry is larger than 10 MB) ;

  • I've not used it thoroughly but it seems more coherent (in pycountry, some countries have both a name (e.g. "Italy") and an official_name (e.g. "Italian Republic"), but others only have a name which seems to correspond to the official name (e.g. "Syrian Arab Republic")).

Euphonize answered 20/5, 2021 at 20:46 Comment(1)
country_converter worked much better for me than pycountry. For example, coco.convert(names=['USA', 'United States', 'Russia', 'South Korea']) correctly convert evverything while pycountry.countries.get(name=...) failed for all of thoseNewsprint
M
2

While all the other answers work great, they are all pretty heavy if you care about the size of your app. If you only care about a simple conversion between country name, alpha2, and/or alpha3, there is a great package called iso3166.

For example pycountry is 28MB, while iso3166 is mere 36KB.

Murther answered 21/2, 2023 at 12:46 Comment(0)
S
1

You can use the function clean_country() from the library DataPrep if you put the countries in a DataFrame. Install DataPrep with pip install dataprep.

from dataprep.clean import clean_country
import pandas as pd

df = pd.DataFrame({'country': ['American Samoa', 'Canada', 'France']})
df2 = clean_country(df, 'country', output_format='alpha-2')

df2 contains a new column country_clean with the countries in ISO 3166-1 alpha-2 format:

          country country_clean
0  American Samoa            AS
1          Canada            CA
2          France            FR
Skirt answered 22/2, 2021 at 2:34 Comment(0)
H
1

pycountry can be quite slow when dealing with large datasets. There is a faster library called countrywrangler.

Here's an example code using CountryWrangler:

import countrywrangler as cw

input_countries = ['American Samoa', 'Canada', 'France']

codes = [cw.Normalize.name_to_alpha2(country) for country in input_countries]

print(codes)  # prints ['AS', 'CA', 'FR']

Full documentation: https://countrywrangler.readthedocs.io/en/latest/normalize/country_name/

Haldis answered 18/3, 2023 at 22:16 Comment(0)
I
0

For a reference, to help others. You can as well have all the countries listed here, so it is easy for anyone to create a csv, json, xml, html, excel etc. Just copy and recreate.

+---------+----------------------------------------------+---------------+
| ISOCode |                   Country                    |    Region     |
+---------+----------------------------------------------+---------------+
| AD      | Andorra                                      | Europe        |
| AE      | United Arab Emirates                         | Asia          |
| AF      | Afghanistan                                  | Asia          |
| AG      | Antigua and Barbuda                          | North America |
| AI      | Anguilla                                     | North America |
| AL      | Albania                                      | Europe        |
| AM      | Armenia                                      | Asia          |
| AO      | Angola                                       | Africa        |
| AQ      | Antarctica                                   | Antarctica    |
| AR      | Argentina                                    | South America |
| AS      | American Samoa                               | Australia     |
| AT      | Austria                                      | Europe        |
| AU      | Australia                                    | Australia     |
| AW      | Aruba                                        | North America |
| AZ      | Azerbaijan                                   | Asia          |
| BA      | Bosnia and Herzegovina                       | Europe        |
| BB      | Barbados                                     | North America |
| BD      | Bangladesh                                   | Asia          |
| BE      | Belgium                                      | Europe        |
| BF      | Burkina Faso                                 | Africa        |
| BG      | Bulgaria                                     | Europe        |
| BH      | Bahrain                                      | Asia          |
| BI      | Burundi                                      | Africa        |
| BJ      | Benin                                        | Africa        |
| BM      | Bermuda                                      | North America |
| BN      | Brunei Darussalam                            | Asia          |
| BO      | Bolivia, Plurinational State of              | South America |
| BR      | Brazil                                       | South America |
| BS      | Bahamas                                      | North America |
| BT      | Bhutan                                       | Asia          |
| BW      | Botswana                                     | Africa        |
| BY      | Belarus                                      | Europe        |
| BZ      | Belize                                       | North America |
| CA      | Canada                                       | North America |
| CC      | Cocos (Keeling) Islands                      | Asia          |
| CD      | Congo, The Democratic Republic of the        | Africa        |
| CF      | Central African Republic                     | Africa        |
| CG      | Congo                                        | Africa        |
| CH      | Switzerland                                  | Europe        |
| CI      | Côte d'Ivoire                                | Africa        |
| CK      | Cook Islands                                 | Australia     |
| CL      | Chile                                        | South America |
| CM      | Cameroon                                     | Africa        |
| CN      | China                                        | Asia          |
| CO      | Colombia                                     | South America |
| CR      | Costa Rica                                   | North America |
| CU      | Cuba                                         | North America |
| CV      | Cape Verde                                   | Africa        |
| CX      | Christmas Island                             | Asia          |
| CY      | Cyprus                                       | Asia          |
| CZ      | Czech Republic                               | Europe        |
| DE      | Germany                                      | Europe        |
| DJ      | Djibouti                                     | Africa        |
| DK      | Denmark                                      | Europe        |
| DM      | Dominica                                     | North America |
| DO      | Dominican Republic                           | North America |
| DZ      | Algeria                                      | Africa        |
| EC      | Ecuador                                      | South America |
| EE      | Estonia                                      | Europe        |
| EG      | Egypt                                        | Africa        |
| EH      | Western Sahara                               | Africa        |
| ER      | Eritrea                                      | Africa        |
| ES      | Spain                                        | Europe        |
| ET      | Ethiopia                                     | Africa        |
| FI      | Finland                                      | Europe        |
| FJ      | Fiji                                         | Australia     |
| FK      | Falkland Islands (Malvinas)                  | South America |
| FM      | Micronesia, Federated States of              | Australia     |
| FO      | Faroe Islands                                | Europe        |
| FR      | France                                       | Europe        |
| GA      | Gabon                                        | Africa        |
| GB      | United Kingdom                               | Europe        |
| GD      | Grenada                                      | North America |
| GE      | Georgia                                      | Asia          |
| GF      | French Guiana                                | South America |
| GG      | Guernsey                                     | Europe        |
| GH      | Ghana                                        | Africa        |
| GI      | Gibraltar                                    | Europe        |
| GL      | Greenland                                    | North America |
| GM      | Gambia                                       | Africa        |
| GN      | Guinea                                       | Africa        |
| GP      | Guadeloupe                                   | North America |
| GQ      | Equatorial Guinea                            | Africa        |
| GR      | Greece                                       | Europe        |
| GS      | South Georgia and the South Sandwich Islands | Antarctica    |
| GT      | Guatemala                                    | North America |
| GU      | Guam                                         | Australia     |
| GW      | Guinea-Bissau                                | Africa        |
| GY      | Guyana                                       | South America |
| HK      | Hong Kong                                    | Asia          |
| HN      | Honduras                                     | North America |
| HR      | Croatia                                      | Europe        |
| HT      | Haiti                                        | North America |
| HU      | Hungary                                      | Europe        |
| ID      | Indonesia                                    | Asia          |
| IE      | Ireland                                      | Europe        |
| IL      | Israel                                       | Asia          |
| IM      | Isle of Man                                  | Europe        |
| IN      | India                                        | Asia          |
| IO      | British Indian Ocean Territory               | Asia          |
| IQ      | Iraq                                         | Asia          |
| IR      | Iran, Islamic Republic of                    | Asia          |
| IS      | Iceland                                      | Europe        |
| IT      | Italy                                        | Europe        |
| JE      | Jersey                                       | Europe        |
| JM      | Jamaica                                      | North America |
| JO      | Jordan                                       | Asia          |
| JP      | Japan                                        | Asia          |
| KE      | Kenya                                        | Africa        |
| KG      | Kyrgyzstan                                   | Asia          |
| KH      | Cambodia                                     | Asia          |
| KI      | Kiribati                                     | Australia     |
| KM      | Comoros                                      | Africa        |
| KN      | Saint Kitts and Nevis                        | North America |
| KP      | Korea, Democratic People's Republic of       | Asia          |
| KR      | Korea, Republic of                           | Asia          |
| KW      | Kuwait                                       | Asia          |
| KY      | Cayman Islands                               | North America |
| KZ      | Kazakhstan                                   | Asia          |
| LA      | Lao People's Democratic Republic             | Asia          |
| LB      | Lebanon                                      | Asia          |
| LC      | Saint Lucia                                  | North America |
| LI      | Liechtenstein                                | Europe        |
| LK      | Sri Lanka                                    | Asia          |
| LR      | Liberia                                      | Africa        |
| LS      | Lesotho                                      | Africa        |
| LT      | Lithuania                                    | Europe        |
| LU      | Luxembourg                                   | Europe        |
| LV      | Latvia                                       | Europe        |
| LY      | Libya                                        | Africa        |
| MA      | Morocco                                      | Africa        |
| MC      | Monaco                                       | Europe        |
| MD      | Moldova, Republic of                         | Europe        |
| ME      | Montenegro                                   | Europe        |
| MG      | Madagascar                                   | Africa        |
| MH      | Marshall Islands                             | Australia     |
| MK      | Macedonia, Republic of                       | Europe        |
| ML      | Mali                                         | Africa        |
| MM      | Myanmar                                      | Asia          |
| MN      | Mongolia                                     | Asia          |
| MO      | Macao                                        | Asia          |
| MP      | Northern Mariana Islands                     | Australia     |
| MQ      | Martinique                                   | North America |
| MR      | Mauritania                                   | Africa        |
| MS      | Montserrat                                   | North America |
| MT      | Malta                                        | Europe        |
| MU      | Mauritius                                    | Africa        |
| MV      | Maldives                                     | Asia          |
| MW      | Malawi                                       | Africa        |
| MX      | Mexico                                       | North America |
| MY      | Malaysia                                     | Asia          |
| MZ      | Mozambique                                   | Africa        |
| NA      | Namibia                                      | Africa        |
| NC      | New Caledonia                                | Australia     |
| NE      | Niger                                        | Africa        |
| NF      | Norfolk Island                               | Australia     |
| NG      | Nigeria                                      | Africa        |
| NI      | Nicaragua                                    | North America |
| NL      | Netherlands                                  | Europe        |
| NO      | Norway                                       | Europe        |
| NP      | Nepal                                        | Asia          |
| NR      | Nauru                                        | Australia     |
| NU      | Niue                                         | Australia     |
| NZ      | New Zealand                                  | Australia     |
| OM      | Oman                                         | Asia          |
| PA      | Panama                                       | North America |
| PE      | Peru                                         | South America |
| PF      | French Polynesia                             | Australia     |
| PG      | Papua New Guinea                             | Australia     |
| PH      | Philippines                                  | Asia          |
| PK      | Pakistan                                     | Asia          |
| PL      | Poland                                       | Europe        |
| PM      | Saint Pierre and Miquelon                    | North America |
| PN      | Pitcairn                                     | Australia     |
| PR      | Puerto Rico                                  | North America |
| PS      | Palestinian Territory, Occupied              | Asia          |
| PT      | Portugal                                     | Europe        |
| PW      | Palau                                        | Australia     |
| PY      | Paraguay                                     | South America |
| QA      | Qatar                                        | Asia          |
| RE      | Réunion                                      | Africa        |
| RO      | Romania                                      | Europe        |
| RS      | Serbia                                       | Europe        |
| RU      | Russian Federation                           | Europe        |
| RW      | Rwanda                                       | Africa        |
| SA      | Saudi Arabia                                 | Asia          |
| SB      | Solomon Islands                              | Australia     |
| SC      | Seychelles                                   | Africa        |
| SD      | Sudan                                        | Africa        |
| SE      | Sweden                                       | Europe        |
| SG      | Singapore                                    | Asia          |
| SH      | Saint Helena, Ascension and Tristan da Cunha | Africa        |
| SI      | Slovenia                                     | Europe        |
| SJ      | Svalbard and Jan Mayen                       | Europe        |
| SK      | Slovakia                                     | Europe        |
| SL      | Sierra Leone                                 | Africa        |
| SM      | San Marino                                   | Europe        |
| SN      | Senegal                                      | Africa        |
| SO      | Somalia                                      | Africa        |
| SR      | Suriname                                     | South America |
| ST      | Sao Tome and Principe                        | Africa        |
| SV      | El Salvador                                  | North America |
| SY      | Syrian Arab Republic                         | Asia          |
| SZ      | Swaziland                                    | Africa        |
| TC      | Turks and Caicos Islands                     | North America |
| TD      | Chad                                         | Africa        |
| TF      | French Southern Territories                  | Antarctica    |
| TG      | Togo                                         | Africa        |
| TH      | Thailand                                     | Asia          |
| TJ      | Tajikistan                                   | Asia          |
| TK      | Tokelau                                      | Australia     |
| TM      | Turkmenistan                                 | Asia          |
| TN      | Tunisia                                      | Africa        |
| TO      | Tonga                                        | Australia     |
| TR      | Turkey                                       | Asia          |
| TT      | Trinidad and Tobago                          | North America |
| TV      | Tuvalu                                       | Australia     |
| TW      | Taiwan, Province of China                    | Asia          |
| TZ      | Tanzania, United Republic of                 | Africa        |
| UA      | Ukraine                                      | Europe        |
| UG      | Uganda                                       | Africa        |
| US      | United States                                | North America |
| UY      | Uruguay                                      | South America |
| UZ      | Uzbekistan                                   | Asia          |
| VC      | Saint Vincent and the Grenadines             | North America |
| VE      | Venezuela, Bolivarian Republic of            | South America |
| VG      | Virgin Islands, British                      | North America |
| VI      | Virgin Islands, U.S.                         | North America |
| VN      | Vietnam                                      | Asia          |
| VU      | Vanuatu                                      | Australia     |
| WF      | Wallis and Futuna                            | Australia     |
| WS      | Samoa                                        | Australia     |
| YE      | Yemen                                        | Asia          |
| YT      | Mayotte                                      | Africa        |
| ZA      | South Africa                                 | Africa        |
| ZM      | Zambia                                       | Africa        |
| ZW      | Zimbabwe                                     | Africa        |
+---------+----------------------------------------------+---------------+
Innate answered 12/2, 2019 at 12:45 Comment(1)
Source? It would be great if the three letter country codes are also added to the table.Deracinate
S
-1

There are a few things to consider with Country Names, especially if using them as search keys. They can be in Title Case (what we think of as normal) or Uppercase (from ISO 3166). Names that include commas or apostrophes might need to be wrapped in quotes. Some names have letters with accents (so non-ASCII). However, there might be a combination that works for you at http://www.dataphyx.com/countrynames/ where you can get CSV lists of ISO Names/IDs in various formats.

Sauer answered 28/4, 2013 at 8:40 Comment(0)
U
-1

For those using the ISO 3166-1 Country Codes, they will no longer be freely availalble from ISO after Feb. 20, 2014. See their notice: http://www.iso.org/iso/home/standards/country_codes/country-codes_new-product-info

There are plenty of archived versions on the net. I've placed copies (2/15/2014) of the English and French txt and xml versions here: http://www.opengeocode.org/archive.php

Unfortunate answered 15/2, 2014 at 19:3 Comment(2)
This seems misleading; the site says "All the codes are now available on the Online Browsing Platform (OBP). The information on the OBP is always up-to-date and you can sign up for notifications to be informed when changes are made. This notification functionality replaces the ISO 3166 newsletter." They still appear to be free, they just changed the format.Zapateado
@NickT - Things change in 2 years (hehe). Yes, you can now get a table dump from ISO. I did not track when they made the change, but indeed they abandoned the practice of making you 'buy the codes' and are again freely available.Unfortunate

© 2022 - 2024 — McMap. All rights reserved.