Skip to content

Elixir package for translating names of ISO3166-1, ISO3166-2 and geoname IDs

License

Notifications You must be signed in to change notification settings

Kylmakalle/location

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Location

Elixir library for accessing ISO3166-1 (country) and ISO3166-2 (subdivision) data as well as geoname data for cities. Source data comes from the upstream debian iso-codes package and the Geonames project.

Countries

The data for countries comes primarily from the debian iso-codes package. The data file for that is stored in priv/iso_3166-1.json. We do manually add some data that is missing from upstream. Overrides can be found in priv/override/iso_3166-1.json

Subdivisions

The data for subdivisions comes primarily from the debian iso-codes package. The data file for that is stored in priv/iso_3166-2.json. The subdivision names in this file are mostly in local language (i.e. Wien instead of Vienna). English translations are obtained from Wikipedia using a scraper. The translations found in priv/iso_3166-2.en-translations.json are used when available instead of the original name.

We also add some data manually that is missing from upstream. Overrides can be found in priv/override/iso_3166-2.json

Cities

The data for cities comes from the geonames project. This project has scripts to downlaod the main allCountries.txt file. It is then processed to make it smaller (from 1.3GB to about 130MB). Still, the resulting file is quite large so we also provide a city database based on the smaller cities500.txt file.

About

Elixir package for translating names of ISO3166-1, ISO3166-2 and geoname IDs

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Elixir 100.0%