skip to navigation
skip to content

Not Logged In

mercantile 0.1

Spherical mercator and XYZ tile utilities

Latest Version: 0.8.2

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 | geojsonio
 
File Type Py Version Uploaded on Size
mercantile-0.1.tar.gz (md5) Source 2014-03-26 3KB
  • Downloads (All Versions):
  • 236 downloads in the last day
  • 761 downloads in the last week
  • 16382 downloads in the last month