plaincities 0.3

plaincities is a library of places in many languages.

plaincities is a library of places in many languages. It is based on the geonames database.

Installation

pip install plaincities

Usage

All countries are loaded after initialization but city data has to be loaded explicitly for performance reasons:

from plaincities import Countries
countries = Countries(language='en')
india = countries['IN']
india.load_cities()
kerala = india.states['Kerala']
kochi = kerala.cities['Kochi']
(kochi.latitude, kochi.longitude)

('9.93988', '76.26022')

You can also load cities during initialization:

from plaincities import Countries
countries = Countries(countries_to_load=['IN', 'MX'])
mexico = countries['MX']
mexico.load_cities()
merida = mexico.cities['Mérida']
merida.timezone.key

'America/Merida'

or load by continent:

from plaincities import Countries
countries = Countries(continents_to_load=['AF'])

or load all the cities on the globe!

from plaincities import Countries
countries = Countries(load_all=True)

Switching languages:

from plaincities import Countries
countries = Countries(language='zh', countries_to_load=['CN'])
china = countries['CN']
beijing = china.cities['北京']
(china.name, beijing.name, beijing.ascii_name)

('中国', '北京', 'Beijing')

Suggestions:

from plaincities import Countries
countries = Countries(countries_to_load=['GR'])
greece = countries['GR']
list(greece.cities.suggest('Tesaloniki', threshold=0.7))

['Heraklion', 'Thessaloniki']

Generating language files

Default installation supports English, Turkish, French, Spanish, Chinese, Russian and Arabic. You can setup additional languages after the installation.

from plaincities import generator
Generator('data', 'new_values').generate_values('cities15000.txt', ['ko'], 'ko')

from plaincities import Countries
countries = Countries(countries_to_load=['TH'], path='new_values')
thailand = countries['TH']
thailand.name

'태국'

Contact:

[e-mail]