Quad key object used for Geospatial segmentation. Based off the idea of a quadtree and used as the Bing Maps tile system.
Given a (lat, lon) and level produce a quadkey to be used in Bing Maps. Can also supply methods to generate a Google Maps TileXYZ
Built off of the TileSystem static class outlined here: http://msdn.microsoft.com/en-us/library/bb259689.aspx
Converts a lat,lon to pixel space to tile space to a quadkey
import quadkey
qk = quadkey.from_geo((-105, 40), 17)
print qk.key # => 02310101232121212
assert qk.level is 17
tile = qk.to_tile() # => [(x, y), z]
Not a lot of documentation here, but the implementation has quite a bit, so look at the QuadKey definitions for better documention
The package on pypi is quadtweet, so the recommended installation is with pip
pip install quadkey
There are many straightforward methods, so I'll only go into detail of the unique ones
- children()
- parent()
- is_ancestor()
- is_descendent()
- area()
- to_geo()
- to_tile()
####difference(to)
Gets the quadkeys between self and to forming a rectangle, inclusive.
qk.difference(to) -> [qk,,,,,to]
####unwind()
Gets a list of all ancestors in descending order by level, inclusive.
QuadKey('0123').unwind() -> ['0123','012','01','0']