Geonames data for continents, cities and US states.
Project description
A Python library that provides functions to retrieve names and codes of continents, countries and US states as Python dictionaries.
Geonames data is obtained from GeoNames.
Installation
To install geonamescache, run:
$ sudo pip install geonamescache
Or, if necessary:
$ sudo easy_install geonamescache
Usage
A simple usage example:
import geonamescache gc = geonamescache.GeonamesCache() countries = gc.get_countries() # print countries dictionary print(countries) # you really wanna do something more useful with the data...
Methods
Currently geonamescache provides the following methods, that all return dictionaries with the requested data:
get_continents()
get_countries()
get_us_states()
get_cities()
get_countries_by_names()
get_us_states_by_names()
get_cities_by_name(name)
Mappers
The mappers module provides function(s) to map data properties. Currently you can create a mapper that maps country properties, e. g. the name property to the iso3 property, to do so you’d write the following code:
from geonamescache.mappers import country mapper = country(from_key=’name’, to_key=’iso3’)
iso3 = mapper(‘Spain’) # iso3 is assigned ESP
TODOs
create sphinx docs
analyze performance of get_cities_by_name
call get_dataset_by_key with name of dataset, so there is no need for *_by_names methods
Contributing
Fork the repository on GitHub
Commit your changes to the develop branch
Write test(s) for any new feature
Push your changes and send a pull request
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.