COG & tiles operations
Cloud-optimized GeoTIFF tiling and rendering.
Each operation below is reachable at POST /v1/op/{operation_id} or the resource path POST /v1/{resource}/{action}, with a Bearer token (a gpra_ API key or a session token). Back to the Operations Reference index.
cog.colormaps
Curated colormap groups for the frontend picker (bare-dict).
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.colormaps · POST /v1/cog/colormaps |
| Python / TypeScript | client.cog.colormaps(…) |
| CLI | geopera cog colormaps … |
Request — CogEmptyInput (see the OpenAPI schema for fields).
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
cog.formulas
Predefined spectral-index formula templates (bare-dict, keyed by index id).
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.formulas · POST /v1/cog/formulas |
| Python / TypeScript | client.cog.formulas(…) |
| CLI | geopera cog formulas … |
Request — CogEmptyInput (see the OpenAPI schema for fields).
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
cog.statistics
AOI-scoped percentile statistics for a COG — drives per-AOI colormap rescale.
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.statistics · POST /v1/cog/statistics |
| Python / TypeScript | client.cog.statistics(…) |
| CLI | geopera cog statistics … |
Request — CogStatsInput
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | |
geometry | object | yes | |
expression | string | — | |
bands | string | — | |
percentiles | array of any | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
cog.thumbnail
Generate a JPEG thumbnail from the smallest COG overview.
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.thumbnail · POST /v1/cog/thumbnail |
| Python / TypeScript | client.cog.thumbnail(…) |
| CLI | geopera cog thumbnail … |
Request — CogThumbnailInput
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | |
width | integer | — | |
height | integer | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
cog.tile.render
Render an XYZ tile from a COG (bands or band-math expression).
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.tile.render · POST /v1/cog/tile/render |
| Python / TypeScript | client.cog.tile.render(…) |
| CLI | geopera cog tile render … |
Request — CogTileInput
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | |
z | integer | yes | |
x | integer | yes | |
y | integer | yes | |
format | string | yes | |
bands | string | — | |
expression | string | — | |
rescale | string | — | |
colormap | string | — | |
quality | integer | — | |
aoi | string | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
cog.tile.terrain
Render a Mapbox Terrain-RGB tile from a single-band elevation/depth COG.
| Scope | tiles:read |
| Side-effect | read |
| HTTP | POST /v1/op/cog.tile.terrain · POST /v1/cog/tile/terrain |
| Python / TypeScript | client.cog.tile.terrain(…) |
| CLI | geopera cog tile terrain … |
Request — CogTerrainInput
| Field | Type | Required | Description |
|---|---|---|---|
url | string | yes | |
z | integer | yes | |
x | integer | yes | |
y | integer | yes | |
invert | boolean | — | |
aoi | string | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.