Metadata-Version: 2.0
Name: geonames
Version: 0.1.3
Summary: Geonames data parser into Shapefile/KML
Home-page: http://addxy.com
Author: Denis Carriere
Author-email: carriere.denis@gmail.com
License: UNKNOWN
Download-URL: https://github.com/DenisCarriere/geonames
Keywords: geonames parser shapefile kml data
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: unicodecsv (>=0.9.4)

========
Geonames
========

The Geonames library parses **Geonames.org** datasets into clean & simple OGR shapefile format.

----------
How to Use
----------

This very simple Command Line Interface (CLI) converts the text file into a shapefile with a single line of code::

    $ geonames CF.txt
    <Geonames - Central African Republic [15373]>

-------
Install
-------

How to install **Fiona**::

    $ sudo apt-get install python-software-properties
    $ sudo add-apt-repository ppa:ubuntugis/ppa
    $ sudo apt-get update
    $ sudo apt-get install libgdal-dev
    $ pip install fiona

Install Geonames using **PyPi**::

    $ sudo pip install geonames

-------------
Documentation
-------------

Download Geonames data using from `geonames.org <http://geonames.org/export/dump>`_::

    $ wget http://download.geonames.org/export/dump/PH.zip
    $ unzip PH.zip

Export the dataset using the Geoname's CLI::

    $ geonames PH.txt
    <Geonames - Philippines [75003]>


