mercantile

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. They can be combined like this:

$ echo "[-104.99, 39.99, -105, 40]" \
> | mercantile tiles - 14 \
> | mercantile shapes -
{"features": [{"geometry": {"coordinates": [[[-105.00732421875, 39.9939556939733], [-105.00732421875, 40.01078714046552], [-104.9853515625, 40.01078714046552], [-104.9853515625, 39.9939556939733], [-105.00732421875, 39.9939556939733]]], "type": "Polygon"}, "id": "(3413, 6202, 14)", "properties": {"title": "XYZ tile (3413, 6202, 14)"}, "type": "Feature"}, {"geometry": {"coordinates": [[[-105.00732421875, 39.977120098439634], [-105.00732421875, 39.9939556939733], [-104.9853515625, 39.9939556939733], [-104.9853515625, 39.977120098439634], [-105.00732421875, 39.977120098439634]]], "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 \
> | geojsonio

Project details

Release history Release notifications | RSS feed

1.2.1

Apr 21, 2021

1.2.0

Apr 19, 2021

1.2b1 pre-release

Apr 14, 2021

1.2a1 pre-release

Apr 12, 2021

1.1.6

Aug 24, 2020

1.1.5

Jun 16, 2020

1.1.4

Apr 28, 2020

1.1.3

Apr 13, 2020

1.1.2

Aug 5, 2019

1.1.1

Jul 1, 2019

1.1.0

Jun 21, 2019

1.0.4

Jun 4, 2018

1.0.3

May 17, 2018

1.0.2

May 8, 2018

1.0.1

Feb 15, 2018

1.0.0

Dec 1, 2017

1.0b2 pre-release

Nov 28, 2017

1.0b1 pre-release

Nov 21, 2017

1.0a1 pre-release

Nov 16, 2017

0.11.0

Oct 17, 2017

0.10.0

May 26, 2017

0.9.0

May 20, 2016

0.8.3

Aug 25, 2015

0.8.2

Oct 29, 2014

0.8.1

Oct 22, 2014

0.8

Oct 22, 2014

0.7.1

Oct 21, 2014

0.7

Oct 21, 2014

0.6.1

Oct 14, 2014

0.6

Sep 27, 2014

0.5.1

Sep 25, 2014

0.5

Sep 25, 2014

0.4

Aug 21, 2014

0.3

Aug 20, 2014

This version

0.2.1

Aug 19, 2014

0.2

Aug 19, 2014

0.1

Mar 26, 2014

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.2.1.tar.gz (5.2 kB view details)

Uploaded Aug 19, 2014 Source

File details

Details for the file mercantile-0.2.1.tar.gz.

File metadata

Download URL: mercantile-0.2.1.tar.gz
Upload date: Aug 19, 2014
Size: 5.2 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for mercantile-0.2.1.tar.gz
Algorithm	Hash digest
SHA256	`b809a0085370f28de4f3307db8cbfb8c29ea78c30ca9116c44de259c46467b37`
MD5	`30df3b59708bb812ea7fbcb79df1062d`
BLAKE2b-256	`5b3fb9caa1380f4ca83209aef7c4079a74e593e31983601c0a30ba70e4ee419d`