Skip to main content

Geonames data for continents, cities and US states.

Project description

Geonames Cache
==============

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
<http://www.geonames.org/>`_.


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
- rather 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

.. _`the repository`: http://github.com/yaph/geonamescache

Project details


Release history Release notifications

History Node

1.0.1

History Node

0.21

History Node

0.20

History Node

0.19

History Node

0.18

History Node

0.17

History Node

0.16

History Node

0.15

History Node

0.13

History Node

0.12

History Node

0.11

History Node

0.10

History Node

0.9

This version
History Node

0.8

History Node

0.7

History Node

0.6

History Node

0.5

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
geonamescache-0.8.tar.gz (867.5 kB) Copy SHA256 hash SHA256 Source None Jun 18, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page