Skip to main content

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)

TODOs

  • 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

  1. Fork the repository on GitHub

  2. Commit your changes to the develop branch

  3. Write test(s) for any new feature

  4. Push your changes and send a pull request

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geonamescache-0.10.tar.gz (887.3 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page