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 CLI
Mercantile’s command line interface, named “mercantile”, has commands for getting the shapes of Web Mercator tiles as GeoJSON and getting the tiles that intersect with a GeoJSON bounding box.
$ mercantile --help
Usage: mercantile [OPTIONS] COMMAND [ARGS]...
Mercantile command line interface.
Options:
-v, --verbose Increase verbosity.
-q, --quiet Decrease verbosity.
--help Show this message and exit.
Commands:
shapes Write the shapes of tiles as GeoJSON.
tiles List tiles intersecting a lng/lat bounding box.shapes
The shapes command writes Mercator tile shapes to several forms of GeoJSON.
$ echo "[106, 193, 9]" | mercantile shapes --indent 2 --precision 6
{
"features": [
{
"geometry": {
"coordinates": [
[
[
-105.46875,
39.909736
],
[
-105.46875,
40.446947
],
[
-104.765625,
40.446947
],
[
-104.765625,
39.909736
],
[
-105.46875,
39.909736
]
]
],
"type": "Polygon"
},
"id": "(106, 193, 9)",
"properties": {
"title": "XYZ tile (106, 193, 9)"
},
"type": "Feature"
}
],
"type": "FeatureCollection"
}tiles
The tiles command writes descriptions of tiles intersecting with a geographic bounding box.
$ echo "[-104.99, 39.99, -105, 40]" | mercantile tiles 14
[3413, 6202, 14]
[3413, 6203, 14]The commands can be piped together to do this:
$ echo "[-104.99, 39.99, -105, 40]" \
> | mercantile tiles 14 \
> | mercantile shapes --indent 2 --precision 6
{
"features": [
{
"geometry": {
"coordinates": [
[
[
-105.007324,
39.993956
],
[
-105.007324,
40.010787
],
[
-104.985352,
40.010787
],
[
-104.985352,
39.993956
],
[
-105.007324,
39.993956
]
]
],
"type": "Polygon"
},
"id": "(3413, 6202, 14)",
"properties": {
"title": "XYZ tile (3413, 6202, 14)"
},
"type": "Feature"
},
{
"geometry": {
"coordinates": [
[
[
-105.007324,
39.97712
],
[
-105.007324,
39.993956
],
[
-104.985352,
39.993956
],
[
-104.985352,
39.97712
],
[
-105.007324,
39.97712
]
]
],
"type": "Polygon"
},
"id": "(3413, 6203, 14)",
"properties": {
"title": "XYZ tile (3413, 6203, 14)"
},
"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.
$ echo "[-104.99, 39.99, -105, 40]" \
> | mercantile tiles 14 \
> | mercantile shapes --compact \
> | geojsonioSee Also
node-sphericalmercator provides many of the same features for Node.
tilebelt has some of the GeoJSON features as mercantile and a few more (tile parents, quadkey).
Release 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
File details
Details for the file mercantile-0.5.tar.gz.
File metadata
- Download URL: mercantile-0.5.tar.gz
- Upload date:
- Size: 7.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2a41db0665b9958e9c83f699878823b12422148a729bf3284ca817ff9db36607 |
|
| MD5 | bd65627d423a6ae58c9da23cfca893de |
|
| BLAKE2b-256 | 128ba53536e6d45a565423a90b7206a5136ab0b24a310fe4097cbf2d63cebe57 |
