Mercator coordinate manipulation for tile systems
Project description
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 git@github.com: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.
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.