Skip to content

feat: update for titiler 2.0 #46

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vincentsarago merged 8 commits into from
Mar 16, 2026
Merged

feat: update for titiler 2.0 #46

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
361fba5
feat: update for titiler 2.0
vincentsarago Feb 13, 2026
25da217
do not fetch collection extent if bbox
vincentsarago Feb 13, 2026
2fc1e13
use input bbox in info
vincentsarago Feb 13, 2026
c45fe31
update for titiler 2.0.0b2
vincentsarago Feb 22, 2026
3734f8f
add band options
vincentsarago Feb 27, 2026
b7ea8c8
update for 2.0
vincentsarago Mar 16, 2026
b93d74b
remove vrt
vincentsarago Mar 16, 2026
0bd9b01
update docs
vincentsarago Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@

## [Unreleased]

## [2.0.0] - 2026-03-16

* change: titiler-* requirements to >=2.0,<2.1
* change: asset notation to `assets={name}|{options=...}`
* remove `vrt:` asset notation

## [1.1.3] - 2026-03-05

* fix: better handling of custom TMS ids in WMTS endpoints
Expand Down Expand Up @@ -76,7 +82,9 @@

* initial release

[Unreleased]: <https://github.com/developmentseed/titiler-stacapi/compare/1.1.2..main>
[Unreleased]: <https://github.com/developmentseed/titiler-stacapi/compare/2.0.0..main>
[2.0.0]: <https://github.com/developmentseed/titiler-stacapi/compare/1.1.3..2.0.0>
[1.1.3]: <https://github.com/developmentseed/titiler-stacapi/compare/1.1.2..1.1.3>
[1.1.2]: <https://github.com/developmentseed/titiler-stacapi/compare/1.1.1..1.1.2>
[1.1.1]: <https://github.com/developmentseed/titiler-stacapi/compare/1.1.0..1.1.1>
[1.1.0]: <https://github.com/developmentseed/titiler-stacapi/compare/1.0.0..1.1.0>
Expand Down
47 changes: 22 additions & 25 deletions docs/src/endpoints/collections_endpoints.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,19 +2,20 @@
### STAC Collections endpoints


| Method | URL | Output | Description
| ------ | ---------------------------------------------------------------------------------|-----------------------------------------|--------------
| `GET` | `/collections/{collection_id}/info` | JSON | return mosaic's basic info
| `GET` | `/collections/{collection_id}/info.geojson` | GeoJSON | return mosaic's basic info as a GeoJSON feature
| `GET` | `/collections/{collection_id}/tiles` | JSON | List of OGC Tilesets available
| `GET` | `/collections/{collection_id}/tiles/{tileMatrixSetId}` | JSON | OGC Tileset metadata
| `GET` | `/collections/{collection_id}/tiles/{TileMatrixSetId}/{z}/{x}/{y}[@{scale}x][.{format}]` | image/bin | Create a web map tile image for a collection and a tile index
| `GET` | `/collections/{collection_id}/{TileMatrixSetId}/tilejson.json` | JSON ([TileJSON][tilejson_model]) | Return a Mapbox TileJSON document
| `GET` | `/collections/{collection_id}/{TileMatrixSetId}/map.html` | HTML | simple map viewer
| `GET` | `/collections/{collection_id}/point/{lon},{lat}` | JSON | return pixel value from a mosaic assets
| `GET` | `/collections/{collection_id}/bbox/{minx},{miny},{maxx},{maxy}/assets` | JSON | return list of assets intersecting a bounding box
| `GET` | `/collections/{collection_id}/point/{lon},{lat}/assets` | JSON | return list of assets intersecting a point
| `GET` | `/collections/{collection_id}/tiles/{tileMatrixSetId}/{z}/{x}/{y}/assets` | JSON | return list of assets intersecting a XYZ tile
| Method | URL | Output | Description
| ------ | ---------------------------------------------------------------------------------|-----------------------------------|--------------
| `GET` | `/collections/{collection_id}/info` | JSON | return mosaic's basic info
| `GET` | `/collections/{collection_id}/info.geojson` | GeoJSON | return mosaic's basic info as a GeoJSON feature
| `GET` | `/collections/{collection_id}/tiles` | JSON | List of OGC Tilesets available
| `GET` | `/collections/{collection_id}/tiles/{tileMatrixSetId}` | JSON | OGC Tileset metadata
| `GET` | `/collections/{collection_id}/tiles/{TileMatrixSetId}/{z}/{x}/{y}[.{format}]` | image/bin | Create a web map tile image for a collection and a tile index
| `GET` | `/collections/{collection_id}/{TileMatrixSetId}/tilejson.json` | JSON ([TileJSON][tilejson_model]) | Return a Mapbox TileJSON document
| `GET` | `/collections/{collection_id}/{TileMatrixSetId}/map.html` | HTML | simple map viewer
| `GET` | `/collections/{collection_id}/point/{lon},{lat}` | JSON | return pixel value from a mosaic assets
| `GET` | `/collections/{collection_id}/tiles/{tileMatrixSetId}/{z}/{x}/{y}/assets` | JSON | return list of assets intersecting a XYZ tile
| `GET` | `/collections/{collection_id}/bbox/{minx},{miny},{maxx},{maxy}/assets` | JSON | return list of assets intersecting a bounding box
| `GET` | `/collections/{collection_id}/point/{lon},{lat}/assets` | JSON | return list of assets intersecting a point
| `GET` | `/collections/{collection_id}/WMTSCapabilities.xml` | XML | return OGC WMTS Get Capabilities

### Tiles

Expand All @@ -26,14 +27,13 @@
- **z**: Tile's zoom level.
- **x**: Tile's column.
- **y**: Tile's row.
- **scale**: Tile size scale, default is set to 1 (256x256). OPTIONAL
- **format**: Output image format, default is set to None and will be either JPEG or PNG depending on masked value. OPTIONAL

- QueryParams:
- **assets** (array[str]): asset names.
- **expression** (str): rio-tiler's math expression with asset names (e.g `Asset1_b1/Asset2_b1`).
- **asset_as_band** (bool): tell rio-tiler that each asset is a 1 band dataset, so expression `Asset1/Asset2` can be passed.
- **asset_bidx** (array[str]): Per asset band index (e.g `Asset1|1;2;3`).
- **assets** (array[str]): asset names. **Required**
- **expression** (str): rio-tiler's math expression with asset names (e.g `b1/b2`).
- **asset_as_band** (bool): tell rio-tiler that each asset is a 1 band dataset.
- **tilesize** (int): overwrite TMS tileWidth x tileHeight with fixed tilesize.
- **nodata**: Overwrite internal Nodata value. OPTIONAL
- **unscale** (bool): Apply dataset internal Scale/Offset.
- **resampling** (str): RasterIO resampling algorithm. Defaults to `nearest`.
Expand All @@ -59,9 +59,6 @@
- **limit** (int): The maximum number of results to return (page size). Defaults to 10.
- **max_items** (int): The maximum number of items to used in a mosaic. Defaults to 100.

!!! important
**assets** OR **expression** is required

Example:

- `https://myendpoint/collections/my-collection/tiles/WebMercatorQuad/1/2/3?assets=B01`
Expand All @@ -78,13 +75,13 @@ Example:
- **TileMatrixSetId**: TileMatrixSet name (e.g `WebMercatorQuad`).

- QueryParams:
- **assets** (array[str]): asset names. **Required**
- **tile_format**: Output image format, default is set to None and will be either JPEG or PNG depending on masked value.
- **tile_scale**: Tile size scale, default is set to 1 (256x256). OPTIONAL
- **tilesize** (int): overwrite TMS tileWidth x tileHeight with fixed tilesize. Defaults to 512.
- **minzoom**: Overwrite default minzoom. OPTIONAL
- **maxzoom**: Overwrite default maxzoom. OPTIONAL
- **expression** (str): rio-tiler's math expression with asset names (e.g `Asset1_b1/Asset2_b1`).
- **asset_as_band** (bool): tell rio-tiler that each asset is a 1 band dataset, so expression `Asset1/Asset2` can be passed.
- **asset_bidx** (array[str]): Per asset band index (e.g `Asset1|1;2;3`).
- **expression** (str): rio-tiler's math expression with asset names (e.g `b1/b2`).
- **asset_as_band** (bool): tell rio-tiler that each asset is a 1 band dataset.
- **nodata** (str, int, float): Overwrite internal Nodata value.
- **unscale** (bool): Apply dataset internal Scale/Offset.
- **resampling** (str): RasterIO resampling algorithm. Defaults to `nearest`.
Expand Down
Loading
Loading