Skip to main content

A lightweight offline reverse geocoder implemented in Rust.

Project description

RGeocoder: a reverse geocoding module for Python
================================================

[![PyPI version](https://img.shields.io/pypi/v/rgeocoder.svg)](https://pypi.python.org/pypi/rgeocoder)
[![Build Status](https://img.shields.io/travis/Phil-V/rgeocoder.svg)](https://travis-ci.org/Phil-V/rgeocoder)
[![Updates](https://pyup.io/repos/github/Phil-V/rgeocoder/shield.svg)](https://pyup.io/repos/github/Phil-V/rgeocoder/)

A lightweight offline reverse geocoder implemented in Rust with
[pyo3](https://github.com/PyO3/pyo3) python bindings.

Based on [llambda/rust-reverse-geocoder](https://github.com/llambda/rust-reverse-geocoder) and
[thampiman/reverse-geocoder](https://github.com/thampiman/reverse-geocoder).

**Note:** *Still in an early, pre-release state.*

Basic usage
-----------

```sh
pip install rgeocoder
```

```py
>>> from rgeocoder import ReverseGeocoder
>>> rg = ReverseGeocoder()
>>> r = rg.nearest(41.891929,12.511331) # lat, lon
>>> print(r.name, r.cc)
'Rome IT'
>>> print(r.lat, r.lon)
41.89193 12.51133
```

Some locations include the first-
and second-level administrative divisions:
```py
>>> print(r.admin1)
'Latium'
>>> print(r.admin2)
'Citta metropolitana di Roma Capitale'
```

See http://download.geonames.org/export/dump/readme.txt for more
information on the dataset.


License
-------

[MIT License](LICENSE)


Credits
-------

This package was created with
[audreyr/cookiecutter](https://github.com/audreyr/cookiecutter)
and the [mckaymatt/cookiecutter-pypackage-rust-cross-platform-publish](https://github.com/mckaymatt/cookiecutter-pypackage-rust-cross-platform-publish) project template.


=======
History
=======

0.1.2 (2018-05-03)
------------------

* First release on PyPI.


Project details


Download files

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

Files for rgeocoder, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size rgeocoder-0.1.2-cp27-cp27m-macosx_10_12_x86_64.whl (2.5 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp27-cp27m-manylinux1_i686.whl (3.2 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp27-cp27m-manylinux1_x86_64.whl (3.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp27-cp27mu-manylinux1_i686.whl (3.2 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp27-cp27mu-manylinux1_x86_64.whl (3.1 MB) File type Wheel Python version cp27 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp35-cp35m-macosx_10_12_x86_64.whl (2.5 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp35-cp35m-manylinux1_i686.whl (3.2 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp35-cp35m-manylinux1_x86_64.whl (3.1 MB) File type Wheel Python version cp35 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp36-cp36m-macosx_10_12_x86_64.whl (2.5 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp36-cp36m-manylinux1_i686.whl (3.2 MB) File type Wheel Python version cp36 Upload date Hashes View
Filename, size rgeocoder-0.1.2-cp36-cp36m-manylinux1_x86_64.whl (3.1 MB) File type Wheel Python version cp36 Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page