Sign in
cog-tiles

Cog Tile

Projection of cog.tile.render.

Forwards the #97 intent params (viz_id/band_roles/data_type/render_params/asset/aoi) so the op resolves render config server-side. Raw bands/expression/rescale/colormap still work (no viz_id) for back-compat. band_roles + render_params arrive JSON-encoded in the query.

get/api/v1/cog-tiles/{z}/{x}/{y}.{format}

Path parameters

zinteger required
xinteger required
yinteger required
formatstring required

Query parameters

urlstring required

Full HTTP(S) or gs:// URL to the COG

Full HTTP(S) or gs:// URL to the COG

bandsstring nullable

Comma-separated 1-indexed band numbers, e.g. '1,2,3'

Comma-separated 1-indexed band numbers, e.g. '1,2,3'

expressionstring nullable

Band math expression (b1, b2, …). Mutually exclusive with 'bands'.

Band math expression (b1, b2, …). Mutually exclusive with 'bands'.

rescalestring nullable

Min,max rescale values. Single pair or per-band.

Min,max rescale values. Single pair or per-band.

colormapstring nullable

Named colormap for single-band / expression rendering.

Named colormap for single-band / expression rendering.

qualityinteger

Image quality for lossy formats

Image quality for lossy formats

aoistring nullable

GeoJSON geometry (JSON string). Scopes colormap rescale + clips the tile to the AOI.

GeoJSON geometry (JSON string). Scopes colormap rescale + clips the tile to the AOI.

viz_idstring nullable

Visualization id (e.g. 'elevation', 'ndvi', 'natural-colour'). Backend resolves colormap/bands/expression/rescale — the #97 render strangle: the client sends intent, not baked render config.

Visualization id (e.g. 'elevation', 'ndvi', 'natural-colour'). Backend resolves colormap/bands/expression/rescale — the #97 render strangle: the client sends intent, not baked render config.

band_rolesstring nullable

JSON-encoded role→band map, e.g. {"RED":1,"NIR":4}. From the item's eo:bands; lets the op resolve indices/RGB.

JSON-encoded role→band map, e.g. {"RED":1,"NIR":4}. From the item's eo:bands; lets the op resolve indices/RGB.

data_typestring

raster | dem — drives which VisualizationSpecs apply.

raster | dem — drives which VisualizationSpecs apply.

render_paramsstring nullable

JSON-encoded registry render config {asset,bands,colormap}.

JSON-encoded registry render config {asset,bands,colormap}.

assetstring nullable

Named asset for multi-asset items.

Named asset for multi-asset items.

band_assetsstring nullable

JSON-encoded role→COG-href map for per-band-COG sources (Sentinel-2), e.g. {"NIR":"…/B08.tif","RED":"…/B04.tif"}. With viz_id naming an index, the op reads each band COG and evaluates the index across them.

JSON-encoded role→COG-href map for per-band-COG sources (Sentinel-2), e.g. {"NIR":"…/B08.tif","RED":"…/B04.tif"}. With viz_id naming an index, the op reads each band COG and evaluates the index across them.

Response

Successful Response

{"stackTrail":"paths:/api/v1/cog-tiles/{z}/{x}/{y}.{format}:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.