README

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Helpful tools when you want software to support more than a single country
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Collections and code by Johannes Lundberg
Send fixes to first.last@gmail.com

Use freely. Public domain.


== countrynames.php / countrynames.json / countrycodes.json ==
List of all countries and their ISO 3166:2 code.
Names are in UTF-8.

== countrynames-shorter.json / countrycodes-shorter.json / .php ==
Shorter names used commonly in english language instead of the offical names.
Mapping back and forth to their corresponding ISO 3166:2 code.

== countryaliases.php / countryaliases.json ==
You have a UTF-8 string with a supposed country name.
Use this to validate that name, and get the country's ISO 3166:2 code.

** These collections are maintained and up to date. **