---
title: "Tilejson"
method: GET
path: "/tiles/cog/{tileMatrixSetId}/tilejson.json"
tags: ["Cloud Optimized GeoTIFF"]
---

# Tilejson

`GET /tiles/cog/{tileMatrixSetId}/tilejson.json`

## Request

- Base URL: `https://app.chloris.earth` (the document declares no server; this is the origin it was published from)
- URL: `https://app.chloris.earth/tiles/cog/{tileMatrixSetId}/tilejson.json`
- Auth: API key in query parameter `access_token`
- TypeScript: <https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/docs/tiles/cog/:tileMatrixSetId/tilejson.json/get.ts> (a function with typed inputs; its response is checked against the schema)

Return TileJSON document for a dataset.

## Path parameters

- `tileMatrixSetId` 'CDB1GlobalGrid' | 'CanadianNAD83_LCC' | 'EuropeanETRS89_LAEAQuad' | 'GNOSISGlobalGrid' | 'LINZAntarticaMapTilegrid' | 'NZTM2000Quad' | 'UPSAntarcticWGS84Quad' | 'UPSArcticWGS84Quad' | 'UTM31WGS84Quad' | 'WGS1984Quad' | 'WebMercatorQuad' | 'WorldCRS84Quad' | 'WorldMercatorWGS84Quad', required: Identifier selecting one of the TileMatrixSetId supported.

## Query parameters

- `tile_format` 'png' | 'npy' | 'tif' | 'jpeg' | 'jpg' | 'jp2' | 'webp' | 'pngraw': Available Output image type.
- `tile_scale` integer: Tile size scale. 1=256x256, 2=512x512...
- `minzoom` integer, nullable: Overwrite default minzoom.
- `maxzoom` integer, nullable: Overwrite default maxzoom.
- `url` string, nullable: Dataset URL, may be omitted if using data_path (recommended).
- `buffer` number, nullable: Buffer on each side of the given tile. It must be a multiple of `0.5`. Output **tilesize** will be expanded to `tilesize + 2 * buffer` (e.g 0.5 = 257x257, 1.0 = 258x258).
- `padding` integer, nullable: Padding to apply to each tile edge. Helps reduce resampling artefacts along edges. Defaults to `0`.
- `bidx` integer[], nullable: Dataset band indexes
- `expression` string, nullable: rio-tiler's band math expression
- `nodata` union: Overwrite internal Nodata value
  - number
  - integer
  - string
- `unscale` boolean, nullable: Apply internal Scale/Offset. Defaults to `False`.
- `resampling` 'nearest' | 'bilinear' | 'cubic' | 'cubic_spline' | 'lanczos' | 'average' | 'mode' | 'gauss' | 'rms', nullable: RasterIO resampling algorithm. Defaults to `nearest`.
- `reproject` 'nearest' | 'bilinear' | 'cubic' | 'cubic_spline' | 'lanczos' | 'average' | 'mode' | 'sum' | 'rms', nullable: WarpKernel resampling algorithm (only used when doing re-projection). Defaults to `nearest`.
- `algorithm` 'hillshade' | 'contours' | 'normalizedIndex' | 'terrarium' | 'terrainrgb': Algorithm name
- `algorithm_params` string, nullable: Algorithm parameter
- `rescale` string[], nullable: comma (',') delimited Min,Max range. Can set multiple time for multiple bands.
- `color_formula` string, nullable: rio-color formula (info: https://github.com/mapbox/rio-color)
- `colormap_name` 'turbo' | 'rplumbo' | 'turbid' | 'summer_r' | 'pubu' | 'pastel2' | 'greys' | 'oxy' | 'jet_r' | 'ylgnbu_r' | 'gist_yarg_r' | 'coolwarm_r' | 'solar_r' | 'tab20c_r' | 'balance_r' | 'algae' | 'speed' | 'rdylgn' | 'gist_yarg' | 'delta_r' | 'set2' | 'gray_r' | 'spectral' | 'rainbow' | 'jet' | 'greens_r' | 'gnuplot2' | 'flag_r' | 'topo_r' | 'viridis' | 'cubehelix' | 'spring' | 'set1_r' | 'rain_r' | 'pastel2_r' | 'tab10_r' | 'gist_gray_r' | 'hot_r' | 'gist_earth' | 'nipy_spectral_r' | 'purples' | 'twilight_r' | 'amp' | 'gist_gray' | 'copper_r' | 'brbg_r' | 'rdylbu' | 'diff_r' | 'phase_r' | 'ice_r' | 'puor' | 'curl' | 'thermal' | 'inferno_r' | 'gist_stern_r' | 'deep' | 'seismic_r' | 'set2_r' | 'dense_r' | 'seismic' | 'haline' | 'diff' | 'bwr' | 'dense' | 'rdgy' | 'tarn_r' | 'prgn' | 'blues' | 'rdylbu_r' | 'rdpu_r' | 'accent' | 'oranges' | 'matter' | 'hsv' | 'orrd_r' | 'copper' | 'brg_r' | 'pubugn' | 'blues_r' | 'rain' | 'algae_r' | 'rdbu_r' | 'rainbow_r' | 'pubu_r' | 'reds_r' | 'winter' | 'puor_r' | 'spectral_r' | 'flag' | 'inferno' | 'gnbu_r' | 'wistia_r' | 'hot' | 'prism' | 'pubugn_r' | 'balance' | 'afmhot' | 'nipy_spectral' | 'brbg' | 'spring_r' | 'terrain' | 'coolwarm' | 'cividis_r' | 'ylorbr' | 'purd_r' | 'bugn_r' | 'ylgn' | 'bupu_r' | 'amp_r' | 'turbid_r' | 'oranges_r' | 'paired' | 'magma_r' | 'oxy_r' | 'set3_r' | 'purples_r' | 'rdylgn_r' | 'plasma_r' | 'curl_r' | 'ylorrd_r' | 'plasma' | 'wistia' | 'pink' | 'bone_r' | 'set3' | 'ylgnbu' | 'tempo_r' | 'brg' | 'thermal_r' | 'dark2_r' | 'gist_heat' | 'ylorbr_r' | 'twilight' | 'prgn_r' | 'twilight_shifted_r' | 'piyg' | 'gist_earth_r' | 'speed_r' | 'gist_rainbow_r' | 'gist_rainbow' | 'gist_ncar' | 'piyg_r' | 'ylgn_r' | 'set1' | 'ice' | 'cubehelix_r' | 'tab20c' | 'binary' | 'accent_r' | 'delta' | 'bone' | 'gnuplot' | 'reds' | 'tab20' | 'greys_r' | 'gist_heat_r' | 'schwarzwald' | 'rdgy_r' | 'tab10' | 'bupu' | 'cividis' | 'pink_r' | 'tarn' | 'purd' | 'tab20_r' | 'gist_ncar_r' | 'viridis_r' | 'gist_stern' | 'gray' | 'gnbu' | 'tab20b' | 'turbo_r' | 'summer' | 'pastel1_r' | 'binary_r' | 'tempo' | 'cmrmap' | 'ylorrd' | 'matter_r' | 'afmhot_r' | 'ocean' | 'tab20b_r' | 'phase' | 'pastel1' | 'prism_r' | 'haline_r' | 'magma' | 'orrd' | 'cmrmap_r' | 'cfastie' | 'winter_r' | 'hsv_r' | 'terrain_r' | 'solar' | 'gnuplot_r' | 'topo' | 'cool_r' | 'autumn_r' | 'gnuplot2_r' | 'cool' | 'twilight_shifted' | 'ocean_r' | 'rdpu' | 'autumn' | 'greens' | 'bwr_r' | 'deep_r' | 'rdbu' | 'dark2' | 'paired_r' | 'bugn' | '2024-02-23_cumulative_change_light' | '2023-07-18_forest_area_gain_light' | '2023-07-18_forest_area_loss_light' | '2023-07-18_non_forest_light' | '2023-07-18_forest_light' | '2023-07-18_forest_area_degradation_light' | '2024-04-09_stock_light_650' | '2023-06-07_stock_light_100' | '2023-06-07_stock_light_150' | '2023-06-07_stock_light_200' | '2023-06-07_stock_light_250' | '2022-11-18_change_light': Colormap name
- `colormap` string, nullable: JSON encoded custom Colormap
- `return_mask` boolean, nullable: Add mask to the output data. Defaults to `True`

## Response `200`

Return a tilejson

- TileJSON: TileJSON model. Based on https://github.com/mapbox/tilejson-spec/tree/master/2.2.0
  - `tilejson` string
  - `name` string, nullable
  - `description` string, nullable
  - `version` string
  - `attribution` string, nullable
  - `template` string, nullable
  - `legend` string, nullable
  - `scheme` 'xyz' | 'tms'
  - `tiles` string[], required
  - `grids` string[], nullable
  - `data` string[], nullable
  - `minzoom` integer
  - `maxzoom` integer
  - `bounds` number[]
  - `center` unknown[], nullable
    - unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler.md) - [All operations](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/llms.txt) - [OpenAPI document](https://skmtc.dev/chloris/apis/chloris-geospatial-s-dynamic-tiler/revisions/8c654362f5b5?raw)