0 purchases
pyquadkey2 0.3.1
🌍 pyquadkey2
This is a feature-rich Python implementation of QuadKeys, an approach to geographical tiling, popularized by Microsoft to be used for Bing Maps.
In essence, the concept is to recursively divide the flat, two-dimensional world map into squares. Each square contains four squares as children, which again contain four squares and so on, up centimeter-level precision. Each of these squares is uniquely identifiable with a string like 021030032.
For more details on the concept, please refer to
the original article.
muety/pyquadkey2 originates from a fork
of buckhx/QuadKey, which is not maintained anymore. It builds on top of that
project and adds:
✅ Several (critical) bug fixes
✅ Python 3 support
✅ Type hints for all methods
✅ Higher test coverage
✅ Cython backend for improved performance
✅ 64-bit integer representation of QuadKeys
✅ Additional features and convenience methods
Installation
Requirements
This library requires Python 3.10 or higher. To compile it from source, Cython is required in addition.
Using Pip
$ pip install pyquadkey2
Pip installation is only tested for Linux and Mac, yet. If you encounter problems with the installation on Windows, please report them as a new issue.
From archive
$ wget https://github.com/muety/pyquadkey2/releases/download/0.3.1/pyquadkey2-0.3.1.tar.gz
$ pip install pyquadkey2-0.3.1.tar.gz
From source
Prerequisites (Linux)
gcc
Fedora: dnf install @development-tools
Ubuntu / Debian: apt install build-essential
python3-devel
Fedora: dnf install python3-devel
Ubuntu / Debian: apt install python3-dev
Others: See here
Prerequisites (Windows)
Visual C++ Build Tools 2015 (with Windows 10 SDK) (see here)
Build
# Check out repo
$ git clone https://github.com/muety/pyquadkey2
# Create and active virtual environment (optional)
$ python -m venv ./venv
$ source venv/bin/activate
# Install depencencies
$ pip install -r requirements.txt
# Compile
$ cd src/pyquadkey2/quadkey/tilesystem && python setup.py build_ext --inplace && cd ../../../..
# Install as module
$ pip install .
Developer Notes
Unit Tests
python tests/__init__.py
Release
See here.
pip install setuptools wheel auditwheel
python -m build
cd dist
auditwheel repair *.whl
twine upload --repository testpypi wheelhouse/* ../*.tar.gz
License
Apache 2.0
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
There are no reviews.