morecantile 3.3.0__py3-none-any.whl → 4.0.0a0__py3-none-any.whl

{morecantile-3.3.0.dist-info → morecantile-4.0.0a0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: morecantile
-Version: 3.3.0
+Version: 4.0.0a0
 Summary: Construct and use map tile grids (a.k.a TileMatrixSet / TMS).
 Keywords: GIS,TMS,TileMatrixSet,Map Tile
 Author-email: Vincent Sarago <vincent@developmentseed.com>
@@ -17,6 +17,7 @@ Classifier: Topic :: Scientific/Engineering :: GIS
 Requires-Dist: attrs
 Requires-Dist: pyproj~=3.1
 Requires-Dist: pydantic
+Requires-Dist: cachetools
 Requires-Dist: pre-commit ; extra == "dev"
 Requires-Dist: mkdocs ; extra == "docs"
 Requires-Dist: mkdocs-material ; extra == "docs"
@@ -25,6 +26,7 @@ Requires-Dist: rasterio>=1.2.1 ; extra == "rasterio"
 Requires-Dist: mercantile ; extra == "test"
 Requires-Dist: pytest ; extra == "test"
 Requires-Dist: pytest-cov ; extra == "test"
+Requires-Dist: rasterio>=1.2.1 ; extra == "test"
 Project-URL: Documentation, https://developmentseed.org/morecantile/
 Project-URL: Source, https://github.com/developmentseed/morecantile
 Provides-Extra: dev
@@ -34,26 +36,10 @@ Provides-Extra: test
 
 # Morecantile
 
-```
-    +-------------+-------------+  ymax
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 0     |    y: 0     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+
-    |             |             |
-    |    x: 0     |    x: 1     |
-    |    y: 1     |    y: 1     |
-    |    z: 1     |    z: 1     |
-    |             |             |
-    +-------------+-------------+  ymin
-
-xmin                            xmax
-```
-
 <p align="center">
-  <em>Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</em>
+  <img height="500" src="https://github.com/developmentseed/morecantile/assets/10407788/a1523c6d-e255-4dc6-a201-20029715858a"/>
+  <p align="center">Construct and use map tile grids (a.k.a TileMatrixSet / TMS).</p>
+
 </p>
 <p align="center">
   <a href="https://github.com/developmentseed/morecantile/actions?query=workflow%3ACI" target="_blank">
@@ -83,7 +69,12 @@ xmin                            xmax
 
 Morecantile is like [mercantile](https://github.com/mapbox/mercantile) (the best tool to work with Web Mercator tile indexes), but with support for other TileMatrixSet grids.
 
-**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification found in [http://docs.opengeospatial.org/is/17-083r2/17-083r2.html](http://docs.opengeospatial.org/is/17-083r2/17-083r2.html)
+**Morecantile** follows the **OGC Two Dimensional Tile Matrix Set** specification **2.0** found in [https://docs.ogc.org/is/17-083r4/17-083r4.html](https://docs.ogc.org/is/17-083r4/17-083r4.html)
+
+| Morecantile Version | OGC Specification Version | Link
+| ------------------- | ------------------------- |---------
+| 4.0                 | 2.0                       | https://docs.ogc.org/is/17-083r4/17-083r4.html
+| 3.0 and earlier     | 1.0                       | http://docs.opengeospatial.org/is/17-083r2/17-083r2.html
 
 **Note**: Variable matrix width tile set are not supported.
 
@@ -94,17 +85,54 @@ $ python -m pip install -U pip
 $ python -m pip install morecantile
 
 # Or install from source:
-
 $ python -m pip install -U pip
 $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 ```
 
+## Usage
+
+```python
+import morecantile
+
+tms = morecantile.tms.get("WebMercatorQuad")
+
+# Get TMS bounding box
+print(tms.xy_bbox)
+>>> BoundingBox(
+    left=-20037508.342789244,
+    bottom=-20037508.34278919,
+    right=20037508.34278919,
+    top=20037508.342789244,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in the TMS's CRS (e.g epsg:3857)
+print(tms.xy_bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=5009377.085697308,
+    bottom=-7514065.628545959,
+    right=7514065.628545959,
+    top=-5009377.085697308,
+)
+
+# Get the bounds for tile Z=4, X=10, Y=10 in Geographic CRS (e.g epsg:4326)
+print(tms.bounds(morecantile.Tile(10, 10, 4)))
+>>> BoundingBox(
+    left=44.999999999999964,
+    bottom=-55.776573018667634,
+    right=67.4999999999999,
+    top=-40.97989806962009,
+)
+```
+
+More info can be found at https://developmentseed.org/morecantile/usage/
+
 ### Defaults Grids
 
+`morecantile` provides a set of default TMS grids:
+
 - **CanadianNAD83_LCC**: Lambert conformal conic NAD83 for Canada - EPSG:3978
 - **EuropeanETRS89_LAEAQuad**: ETRS89-extended / LAEA Europe - EPGS:3035
 - **LINZAntarticaMapTilegrid**: LINZ Antarctic Map Tile Grid (Ross Sea Region) - EPSG:5482
-- **NZTM2000**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **NZTM2000Quad**: LINZ NZTM2000 Map Tile Grid - EPSG:2193
 - **UPSAntarcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Antarctic - EPSG:5042
 - **UPSArcticWGS84Quad**: Universal Polar Stereographic WGS 84 Quad for Arctic - EPSG:5041
@@ -114,13 +142,16 @@ $ python -m pip install git+https://github.com/developmentseed/morecantile.git
 - **WorldCRS84Quad**: CRS84 for the World
 - **WorldMercatorWGS84Quad**: Elliptical Mercator projection - EPGS:3395
 
-ref: http://schemas.opengis.net/tms/1.0/json/examples/
+ref: https://schemas.opengis.net/tms/2.0/json/examples/tilematrixset/
 
 ## Implementations
 
 - [rio-tiler](https://github.com/cogeotiff/rio-tiler): Create tile from raster using Morecantile TMS.
-- [timvt](https://github.com/developmentseed/timvt): A lightweight PostGIS based dynamic vector tile server.
+- [titiler](https://github.com/developmentseed/titiler): A modern dynamic tile server built on top of FastAPI and Rasterio/GDAL.
+- [tipg](https://github.com/developmentseed/tipg): OGC Features and Tiles API.
 - [planetcantile](https://github.com/AndrewAnnex/planetcantile): Tile matrix sets for other planets.
+- [supermorecado](https://github.com/developmentseed/supermorecado): Extend the functionality of morecantile with additional commands.
+
 
 ## Changes
 

morecantile-4.0.0a0.dist-info/RECORD

@@ -0,0 +1,26 @@
+morecantile/__init__.py,sha256=xiYjERwG1fmSzdVUz0UXMeXmDYQry2iqQut9dPzcQ8c,438
+morecantile/commons.py,sha256=nOj5f5K5EbDZiC0QTK2f14Mpkz6YIZyCaaUI0S9aWIw,1015
+morecantile/defaults.py,sha256=gMhQ2fVXlPGRlRQtZT0z3CByClZp_yStVnsxkutljBg,1748
+morecantile/errors.py,sha256=rhtdpNglfEz5nC8I-BJKUr_gkOwAPwVi1vhLFJ2StYw,907
+morecantile/models.py,sha256=h5WXQryOoBDM2u40oTWmP7PxBIqETsJYomCZpyWmX4k,39247
+morecantile/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+morecantile/utils.py,sha256=J37ixKq_lJC23bqJSAf01mfS-ZEHizvt2uqVE47dPRE,3364
+morecantile/data/CanadianNAD83_LCC.json,sha256=RuR9z5MjxKzU4KE-CutrzjpWBz9c-XXykKAxcD83veU,7267
+morecantile/data/EuropeanETRS89_LAEAQuad.json,sha256=pR2Q7eAlLRG74SRdzYhXj19bf5qBvHrE6kzJ5cvko1Q,4679
+morecantile/data/LINZAntarticaMapTilegrid.json,sha256=dPfxQgpQlCAaaecmems9lTeFkPLbg0iBFqh5ItL-cpQ,5176
+morecantile/data/NZTM2000Quad.json,sha256=PAbOQYz4-TWduSqPVCpbEuaFwNBuVLDbefVVxFN531k,8457
+morecantile/data/README.md,sha256=raRWxSQ6FO-vzkbcwQB_DKKditbRwNvynfFegsaK4Ek,242
+morecantile/data/UPSAntarcticWGS84Quad.json,sha256=mmvm_HNKHpZloQPiN53LsIm8Ix9qZIV9CSxnkTRa--Y,7374
+morecantile/data/UPSArcticWGS84Quad.json,sha256=BupbyUtl1gZOrah5wnVUfOa1cKV_6RShjGx5Q56ReBI,7365
+morecantile/data/UTM31WGS84Quad.json,sha256=-cDrMJ-LFEFug7pVL85PKCdzTIWfiJwevv_QE5811Bs,7367
+morecantile/data/WGS1984Quad.json,sha256=tZMpBJS0fRAwJecH8VR7gvDh2g8F5kPqh6dcCni6VgI,6932
+morecantile/data/WebMercatorQuad.json,sha256=lOt6LFULgDk4mbxRbieESBLmHNmSOgccdWsnoDaVXYE,7843
+morecantile/data/WorldCRS84Quad.json,sha256=l0Wf2faYwzRwO0mG-Tea1Vydpi7V1Oel5L9l2NXHogk,7072
+morecantile/data/WorldMercatorWGS84Quad.json,sha256=JaqoBSu5qVJmL-J7oSVU1etP2OPWx_aVaTc68dGX0Ec,7001
+morecantile/scripts/__init__.py,sha256=-CJncfgWDnSZ8au-SJtgX-OFgCddlf7___d91qQcqQM,23
+morecantile/scripts/cli.py,sha256=_jak-sAa25q96POKCqpJkjLeSNyLYpv6oKslkbxivVA,16657
+morecantile-4.0.0a0.dist-info/entry_points.txt,sha256=keoXuYgnX-mdrGWwXIHqEkSZjQK_iAmtmdrtZ3sCT24,59
+morecantile-4.0.0a0.dist-info/LICENSE,sha256=18IxFIta7rF_RcVSIgLUUd_alyfQ9bGoZKQm5vOarGU,1073
+morecantile-4.0.0a0.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
+morecantile-4.0.0a0.dist-info/METADATA,sha256=PcBM3Tq2KwZ_9uigUWIAUohZdk8axAx-LCb-6_1SfI0,6734
+morecantile-4.0.0a0.dist-info/RECORD,,

{morecantile-3.3.0.dist-info → morecantile-4.0.0a0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: flit 3.8.0
+Generator: flit 3.9.0
 Root-Is-Purelib: true
 Tag: py3-none-any

morecantile/data/NZTM2000.json

@@ -1,242 +0,0 @@
-{
-    "type": "TileMatrixSetType",
-    "title": "LINZ NZTM2000 Map Tile Grid",
-    "abstract": "See https://www.linz.govt.nz/data/linz-data-service/guides-and-documentation/nztm2000-map-tile-service-schema",
-    "identifier": "NZTM2000",
-    "supportedCRS": "urn:ogc:def:crs:EPSG::2193",
-    "boundingBox": {
-        "type": "BoundingBoxType",
-        "crs": "urn:ogc:def:crs:EPSG::2193",
-        "lowerCorner": [
-            3087000,
-            274000
-        ],
-        "upperCorner": [
-            7173000,
-            3327000
-        ]
-    },
-    "tileMatrix": [
-        {
-            "type": "TileMatrixType",
-            "identifier": "0",
-            "scaleDenominator": 32000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 2,
-            "matrixHeight": 4
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "1",
-            "scaleDenominator": 16000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 4,
-            "matrixHeight": 8
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "2",
-            "scaleDenominator": 8000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 8,
-            "matrixHeight": 16
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "3",
-            "scaleDenominator": 4000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 16,
-            "matrixHeight": 32
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "4",
-            "scaleDenominator": 2000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 32,
-            "matrixHeight": 64
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "5",
-            "scaleDenominator": 1000000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 64,
-            "matrixHeight": 128
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "6",
-            "scaleDenominator": 500000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 128,
-            "matrixHeight": 256
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "7",
-            "scaleDenominator": 250000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 256,
-            "matrixHeight": 512
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "8",
-            "scaleDenominator": 100000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 640,
-            "matrixHeight": 1280
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "9",
-            "scaleDenominator": 50000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 1280,
-            "matrixHeight": 2560
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "10",
-            "scaleDenominator": 25000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 2560,
-            "matrixHeight": 5120
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "11",
-            "scaleDenominator": 10000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 6400,
-            "matrixHeight": 12800
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "12",
-            "scaleDenominator": 5000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 12800,
-            "matrixHeight": 25600
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "13",
-            "scaleDenominator": 2500,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 25600,
-            "matrixHeight": 51200
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "14",
-            "scaleDenominator": 1000,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 64000,
-            "matrixHeight": 128000
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "15",
-            "scaleDenominator": 500,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 128000,
-            "matrixHeight": 256000
-        },
-        {
-            "type": "TileMatrixType",
-            "identifier": "16",
-            "scaleDenominator": 250,
-            "topLeftCorner": [
-                10000000,
-                -1000000
-            ],
-            "tileWidth": 256,
-            "tileHeight": 256,
-            "matrixWidth": 256000,
-            "matrixHeight": 512000
-        }
-    ]
-}

morecantile-3.3.0.dist-info/RECORD

@@ -1,27 +0,0 @@
-morecantile/__init__.py,sha256=cdkgr4fLpB3MmoA4qcPfGX9wlQmqpl_9dvmyyY8evaI,436
-morecantile/commons.py,sha256=nOj5f5K5EbDZiC0QTK2f14Mpkz6YIZyCaaUI0S9aWIw,1015
-morecantile/defaults.py,sha256=F-QxTzXGhvdKcsGyfYXr2oixCqAXA4PU6KNZCcvYMGA,1865
-morecantile/errors.py,sha256=X6sHfFUu6rz-OZQVLsewudTRyBuwJssdQK1uAIdCLNQ,818
-morecantile/models.py,sha256=YORs31hRLDztjktMrxePpau2wm7SV50YCn0pUpucqTU,34209
-morecantile/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-morecantile/utils.py,sha256=y5jFjrIEmgaSRUTp65zYU2P7Gtvh3vZtIRsXvWbDeGM,3007
-morecantile/data/CanadianNAD83_LCC.json,sha256=TgT10fJV-oEfI0kRNcX1vRUWS-aODawBQGlfqe4lK54,10093
-morecantile/data/EuropeanETRS89_LAEAQuad.json,sha256=axTfRLPBYAi3_enHs39hbLQqLfRLAcJq1tTCmC3DCZk,8530
-morecantile/data/LINZAntarticaMapTilegrid.json,sha256=KXK27B68qk84kJoQVbb6aYZXc8NIxh_Nrbjeplwk5zQ,5204
-morecantile/data/NZTM2000.json,sha256=CeZ_RhrO5peJCke5YR_1Xucx2p-6Dg11A54Okph_0Lo,6576
-morecantile/data/NZTM2000Quad.json,sha256=kfopCLymnQlw9uXwFzqc3yxoY8CDhwzZzl_WwPHaBWc,7020
-morecantile/data/README.md,sha256=raRWxSQ6FO-vzkbcwQB_DKKditbRwNvynfFegsaK4Ek,242
-morecantile/data/UPSAntarcticWGS84Quad.json,sha256=4EJSpZ42eCJ4DIRsBzxWlASNtCNJk3qW91fcQwCaGKY,9893
-morecantile/data/UPSArcticWGS84Quad.json,sha256=vhknhGCN0wOCzFfqt8zlzd1Oc1oUO74Kr22zN3dMejc,9887
-morecantile/data/UTM31WGS84Quad.json,sha256=m7y0_RU6m695kiVBdCX_QqNRt3lp2AJxh2T61e2oXDA,9679
-morecantile/data/WGS1984Quad.json,sha256=HUYAhJsdjUmJ3SINAxKneTLCvFytMoKphR26Yb-7aM0,6866
-morecantile/data/WebMercatorQuad.json,sha256=aLlYOIhR73R7resgaA6iEuzaRDXM5GY9jYGMmYaQo68,10276
-morecantile/data/WorldCRS84Quad.json,sha256=Xc79e2QCdFcFxinWpp82qj0oZDylRhmk2mYorNzMCQs,6865
-morecantile/data/WorldMercatorWGS84Quad.json,sha256=OvNdMR7ypeCCSgYUdPw7d8KESFPjtonPHh_774OOO1E,10138
-morecantile/scripts/__init__.py,sha256=-CJncfgWDnSZ8au-SJtgX-OFgCddlf7___d91qQcqQM,23
-morecantile/scripts/cli.py,sha256=qeBC66Y1CuBGAN6Tnfg2lBUv-Rio95A9TTvAv3aR9fQ,16665
-morecantile-3.3.0.dist-info/entry_points.txt,sha256=keoXuYgnX-mdrGWwXIHqEkSZjQK_iAmtmdrtZ3sCT24,59
-morecantile-3.3.0.dist-info/LICENSE,sha256=18IxFIta7rF_RcVSIgLUUd_alyfQ9bGoZKQm5vOarGU,1073
-morecantile-3.3.0.dist-info/WHEEL,sha256=rSgq_JpHF9fHR1lx53qwg_1-2LypZE_qmcuXbVUq948,81
-morecantile-3.3.0.dist-info/METADATA,sha256=16WrQuw5dWaiyO0gjWSKnQXOLS4_3GnuuSbQSDgJtfA,5591
-morecantile-3.3.0.dist-info/RECORD,,