This is a feature-rich Python implementation of QuadKeys, an approach to geographical tiling, that was proposed 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.
n1try/pyquadkey2 originates from a fork of buckhx/QuadKey, which is not maintained anymore. It build 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
This library requires Python 3.6 or higher. To compile it by yourself, Cython is required in addition.
pip3 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.
- Download the latest release as archive (
.tar.gz) or wheel (.whl), e.g.0.1.1.tar.gz - Install it with pip:
pip3 install 0.1.1.tar.gz
- Clone repository:
git clone https://github.com/n1try/pyquadkey2 - Make sure Cython is installed:
pip3 install cython - Compile Cython modules:
cd pyquadkey2/quadkey/tilesystem && python3 setup.py build_ext --inplace && ../../ - Install the library with Pip:
pip3 install .
ImportError: cannot import name 'tilesystem': Simply trypip3 install --upgrade pyquadkey2once again. Second time usually works, as required build extensions are installed then. This is a known issue and will be fixed in the future.
Apache 2.0
