dlstadther / webmercator

Webmercator is a Python package for geographic point conversion on a Mercator projection for tile systems.

WebMercator

WebMercator is a Python (2.7, 3.4, 3.5, 3.6, 3.7) package to aid in geographic point conversion onto a Mercator projection for tile systems.

Getting Started

Prerequisites

To utilize or contribute to Webmercator, all you need is Python!

Installing

For bleeding edge

# keeping the repo local
$ git clone [e-mail]:republicwireless-open/webmercator
$ cd webmercator
$ python setup.py install

# only install; no need to clone
$ pip install git+https://github.com/republicwireless-open/webmercator@master

Or for PyPi releases

$ pip install webmercator>=0.1.2

Running the tests

Tests can be run in many ways:

# runs all tests, in all environments
$ path/to/tox

# runs all tests, only in Python 2.7
$ path/to/tox -e py27

# runs specific test class, only in Python 3.6
$ path/to/tox -e py36 tests/point.py

# runs specific test class, only in Python 3.6
$ path/to/tox -e py36 tests/point.py:TestPoint

# runs specific test class, only in Python 3.6
$ path/to/tox -e py36 tests/point.py:TestPoint.test_init_empty

# only runs style guide tests
$ path/to/tox -e flake8

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Dayne Batten
• Dillon Stadther

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License

Acknowledgments

• Bing Maps Tile System - The Mercator calculations used
• Decimal Degrees - Precision translation
• Zoom Levels - Zoom level pixel/tile size
• Haversine Formula
• Geocoordinate Translation (distance)