GET /v1/presets
Lists the named render presets, or returns one.
| Method and path | GET /v1/presets, GET /v1/presets/{presetId} |
| Key | not needed |
| Response | application/json |
| Lean OpenAPI | listPresets, getPreset |
| Full contract | listPresets, getPreset |
Lean v1 presets
Section titled “Lean v1 presets”The recipes are the web map’s tested ones.
presetId |
Sentinel-2 | Landsat 8-9 | Formats | Cloud ceiling |
|---|---|---|---|---|
true-color |
the 8-bit visual (TCI) asset | red, green, blue, reflectance 0 to 0.3 |
png, jpg, webp | 30% |
false-color |
nir (B08), red, green, reflectance 0 to 0.4 |
nir08, red, green, reflectance 0 to 0.4 |
png, jpg, webp | 30% |
ndvi |
from nir (B08) and red, -0.2 to 0.8, rdylgn ramp |
from nir08 and red, -0.2 to 0.8, rdylgn ramp |
png, webp | 60% |
NDVI is computed from reflectance, with the Collection 1 offsets removed. On Sentinel-2 the presets use the 10 m broad NIR band (B08), as the web map does, not nir08; see the B08 trap. For a strictly cross-sensor comparison, use process with nir08.
All three presets mosaic least cloudy first at harmonize: offset_removed, with a default window of the last 30 days (P30D) and no pixel cloud mask.
Example
Section titled “Example”curl -s https://api.satellitedata.net/v1/presets/ndviPreset members
Section titled “Preset members”| Member | Meaning |
|---|---|
id, title, description |
names |
collection |
the default collection, sentinel-2-l2a |
collections |
collections accepted through ?collection= |
bands, expression, rescale, colormap |
the recipe in common-name terms |
harmonize, mosaickingOrder, maxCloudCoverage, defaultWindow |
how scenes are chosen and treated |
minzoom, maxzoom |
the default collection’s zoom range |
tileMatrixSets, formats |
what the tile route serves |
sdn:recipes |
the per-collection recipe: Earth Search assets, expression, stretch and zoom range |
links |
the preset’s TileJSON |
Errors
Section titled “Errors”| Status | Code | When |
|---|---|---|
| 404 | not-found |
no such preset |
Coming later
Section titled “Coming later”ndwi, ndmi, nbr and swir on optical collections and hillshade and elevation on the DEM; cloud-mask settings per preset; nir08 NDVI with bandpass_adjusted over optical-sr; WMTS links.