Skip to main content

Python implementation of geographical tiling using QuadKeys as proposed by Microsoft

Project description

🌍 pyquadkey2


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.

Using Pip

  • 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.

From archive

  • 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

From source

  • Clone repository: git clone
  • Make sure Cython is installed: pip3 install cython
  • Compile Cython modules: cd pyquadkey2/quadkey/tilesystem && python3 build_ext --inplace && ../../
  • Install the library with Pip: pip3 install .


  • ImportError: cannot import name 'tilesystem': Simply try pip3 install --upgrade pyquadkey2 once 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

Buy me a coffee

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 pyquadkey2, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pyquadkey2-0.2.0.tar.gz (40.9 kB) File type Source Python version None 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