Python package to handle tiles and points of different projections, in particular WGS 84 (Latitude, Longitude), Spherical Mercator (Meters), Pixel Pyramid and Tiles (TMS, Google, QuadTree)
The package pyGeoTile consist of two main classes, namely Point and Tile. As already mentioned they allow you to convert various geo projections.
The full API documentation could be found under http://pygeotile.readthedocs.io
Example of the class Point.
from pygeotile.point import Point
meter_x, meter_y, zoom = -9757148.442088600, 5138517.444985110, 19 # meters in Spherical Mercator EPSG:900913
point = Point.from_meters(meter_x=meter_x, meter_y=meter_y)
print('Pixels: ', point.pixels(zoom=zoom)) # Pixels: (34430592, 49899136)
print('Lat/Lon: ', point.latitude_longitude) # Lat/Lon: (41.84987190947754, -87.64995574951166)Example of the class Tile.
from pygeotile.tile import Tile
tms_x, tms_y, zoom = 134494, 329369, 19
tile = Tile.from_tms(tms_x=tms_x, tms_y=tms_y, zoom=19) # Tile Map Service (TMS) X Y and zoom
print('QuadTree: ', tile.quad_tree) # QuadTree: 0302222310303211330
print('Google: ', tile.google) # Google: (134494, 194918)To install pyGeoTile, simply:
pip install pyGeoTile
pyGeoTile officially supports Python 2.7, 3.4, 3.5, 3.6, 3.7, 3.5-dev, 3.6-dev, 3.7-dev, nightly and PyPy3.
This repository is inspired by:
- Tiles à la Google Maps: http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/
- Bing Maps Tile System: https://msdn.microsoft.com/en-us/library/bb259689.aspx
- Showing pixel and tile coordinates: https://developers.google.com/maps/documentation/javascript/examples/map-coordinates?hl=de
- Mercantile: https://github.com/mapbox/mercantile
An example usage of the pyGeoTile library is the tool GeoDex. It is able to find all geospatial tile indices contained in an arbitrary boundary at an arbitrary zoom.
Further a C++ port is available cppGeoTile.
We are happy to hear about other projects which are using pyGeoTile and we would like to mention them. So don't hesitate to contact us.
