pygeons 0.9.1

Geographical queries made easy.

pygeons

Geographical queries made simple.

• Free software: MIT license

• Documentation: https://pygeons.readthedocs.io.

Some examples:

>>> from pygeons.api import Country, find_cities
>>> Country('ivory coast')
Country('Ivory Coast')
>>> Country('côte d’ivoire')
Country('Ivory Coast')
>>> Country('civ')
Country('Ivory Coast')
>>> _.iso
'CI'
>>> Country('ivory coast').capital.name
'Yamoussoukro'
>>> Country('ivory coast').neighbors
[Country('Liberia'), Country('Ghana'), Country('Guinea'), Country('Burkina Faso'), Country('Mali')]
>>>
>>> Country('us').cities['moscow']
City.gid(5601538, 'Moscow', 'US')
>>> Country('us').cities['moscow'].admin2
State.gid(5598264, 'ADM2', 'Latah County', 'US')
>>> Country('us').cities['moscow'].admin1
State.gid(5596512, 'ADM1', 'Idaho', 'US')
>>> Country('us').cities['moscow'].distance_to(Country('ru').cities['moscow'])
8375.215117486288
>>>
>>> find_cities("oslo")[:2]
[City.gid(3143244, 'Oslo', 'NO'), City.gid(5040425, 'Oslo', 'US')]

Features

• Determine if a (city, state and country) combination corresponds to an existing place name

• Scrub (city, state, country) combinations

• Normalize city, state and country names to their canonical representations

• Frame queries in English as well as languages native to each particular country

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.9.1 (2020-09-17)

• Added top-level G` collection to pygeons.api

• Implemented handling for alternative place names

0.9.0 (2020-09-11)

• Added new API

• Switched database backend from MongoDB to sqlite3

• Implemented import scripts in Python

0.1.1 (2017-12-03)

• First working release. Includes import scripts and source code.

0.1.0 (2017-11-26)

• First release on PyPI.