Spherical mercator and XYZ tile utilities
Project description
Spherical mercator coordinate and tile utilities
The mercantile module provides ul(xtile, ytile, zoom) and bounds(xtile, ytile, zoom) functions that return longitudes and latitudes for XYZ tiles, and a xy(lon, lat) function that returns spherical mercator x and y coordinates.
>>> import mercantile
>>> mercantile.ul(486, 332, 10)
(-9.140625, 53.33087298301705)
>>> mercantile.bounds(486, 332, 10)
(-9.140625, 53.12040528310657, -8.7890625, 53.33087298301705)
>>> mercantile.xy(*mercantile.ul(486, 332, 10))
(-1017529.7205322663, 7044436.526761846)mercantile.tool
Mercantile includes a script that writes the extent of an XYZ tile out as GeoJSON.
$ python -mmercantile.tool 20,35,6 --pretty
{
"features": [
{
"geometry": {
"coordinates": [
[
[
-67.5,
-21.943046
],
[
-67.5,
-16.636192
],
[
-61.875,
-16.636192
],
[
-61.875,
-21.943046
],
[
-67.5,
-21.943046
]
]
],
"type": "Polygon"
},
"id": "20,35,6",
"properties": {
"title": "XYZ tile 20,35,6"
},
"type": "Feature"
}
],
"type": "FeatureCollection"
}If you have geojsonio-cli installed, you can shoot this GeoJSON straight to geojson.io for lightning-fast visualization and editing.
$ python -mmercantile.tool 20,35,6 --compact | geojsonioRelease history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mercantile-0.1.tar.gz
(3.2 kB
view hashes)
