Metadata-Version: 2.0
Name: geonames
Version: 0.1.2
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/tarball/master
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**

```bash
$ 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**

```bash
$ sudo pip install geonames
```

## Documentation

Download Geonames data using from [geonames.org](http://geonames.org/export/dump/)

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

Export the dataset using the Geoname's CLI

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


