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}

Request

  • Base URL: https://api.geopera.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.geopera.com/api/v1/cog-tiles/{z}/{x}/{y}.{format}
  • Auth: HTTP bearer

Path parameters

zinteger required
xinteger required
yinteger required
formatstring required

Query parameters

urlstring required

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

bandsstring nullable

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

expressionstring nullable

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

rescalestring nullable

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

colormapstring nullable

Named colormap for single-band / expression rendering.

qualityinteger

Image quality for lossy formats

aoistring nullable

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.

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.

data_typestring

raster | dem — drives which VisualizationSpecs apply.

render_paramsstring nullable

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

assetstring nullable

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.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 8 revisions of this API.