Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lukes/ISO-3166-Countries-with-Regional-Codes

ISO 3166-1 country lists merged with their UN Geoscheme regional codes in ready-to-use JSON, XML, CSV data sets
https://github.com/lukes/ISO-3166-Countries-with-Regional-Codes

countries csv data dataset iso iso3166 iso3166-1 iso3166-2 json region-codes xml

Last synced: 17 days ago
JSON representation

ISO 3166-1 country lists merged with their UN Geoscheme regional codes in ready-to-use JSON, XML, CSV data sets

Awesome Lists containing this project

README 

        

### ISO-3166 Country and Dependent Territories Lists with UN Regional Codes



These lists are the result of merging data from two sources, the Wikipedia [ISO 3166-1 article](http://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements) for alpha and numeric country codes, and the [UN M49 Standard country or area codes for statistical use data](https://unstats.un.org/unsd/methodology/m49/overview) for countries' regional, and sub-regional codes. In addition to countries, it includes dependent territories.



The [International Organization for Standardization (ISO)](https://www.iso.org/iso-3166-country-codes.html) site provides partial data (capitalised and sometimes stripped of non-latin ornamentation), but sells the complete data set as a Microsoft Access 2003 database. Other sites give you the numeric and character codes, but there appeared to be no sites that included the associated UN-maintained regional codes in their data sets. I scraped data from the above two websites that is all publicly available already to produce some ready-to-use complete data sets that will hopefully save someone some time who had similar needs.



### What's available?



The data is available in



* JSON

* XML

* CSV



3 versions exist for each format



* `all.format` - Everything I can find, including regional and sub-regional codes

* `slim-2.format` - English name, numeric country code and alpha-2 code (e.g., NZ)

* `slim-3.format` - English name, numeric country code and alpha-3 code (e.g., NZL)



### What does it look like?



Take a peek inside the `all`, `slim-2` and `slim-3` directories for the full lists of JSON, XML and CSV.



Using JSON as an example:



#### all.json



    [

      {

        "name":"Nigeria",

        "alpha-2":"NG",

        "alpha-3":"NGA",

        "country-code":"566",

        "iso_3166-2":"ISO 3166-2:NG",

        "region":"Africa",

        "sub-region":"Sub-Saharan Africa",

        "intermediate-region":"Western Africa",

        "region-code":"002",

        "sub-region-code":"202",

        "intermediate-region-code":"011"

      },

      // ...

    ]



#### slim-2.json



    [

      {

        "name":"New Zealand",

        "alpha-2":"NZ",

        "country-code":"554"

      },

      // ...

    ]



#### slim-3.json



    [

      {

        "name":"New Zealand",

        "alpha-3":"NZL",

        "country-code":"554"

      },

      // ...

    ]



### Caveats



1. Please check the data independently for accuracy before using it in any system and for any purpose

1. Although I've tried to ensure the data is as accurate as possible, the data is not authoritative, and so should not be considered accurate



### scrubber.rb



`scrubber.rb` is a dirty Ruby script I used to generate these files. You can run it yourself if you wish to re-generate the files fresh from the sources.



To install the gems in the Gemfile:



    bundle



To run:



    bundle exec ruby scrubber.rb



### Timestamp



* UN Statistical data retrieved 19 June 2024

* Wikipedia data retrieved 19 June 2024, from a document last revised 6 June 2024



### Revisions



* 30 June 2024 - `tag 10.0`

* 8 December 2020 - `tag 9.0`

* 19 March 2019 - `tag 8.0`

* 25 July 2018 - `tag 7.0`

* 10 April 2018 - `tag 6.0`

* 26 August 2016 - `tag 5.0`

* 28 August 2015 - `tag 4.0`

* 20 April 2014 - `tag 3.0`

* 13 June 2012 - `tag 2.0`

* 18 May 2011 - `tag 1.0`