Get Ingestion Tile Urls
Mint fresh overlay tile URL templates for a completed ingestion โ the raster layers behind the results map's layer picker.
โถUse Cases
- Render the
natural_forest,commodity,deforestation,fire, andfloodoverlays on a results map (each value is an XYZ raster tile URL template with{z}/{x}/{y}placeholders, directly usable by Mapbox / deck.gl / Leaflet raster layers). - Re-mint expired overlay URLs by calling the endpoint again.
โถBehaviour
- URLs expire. Each URL embeds an expiring session token that lapses after a few hours. Never persist them โ re-fetch this endpoint to mint fresh ones. Responses are served from a short-lived server-side cache, safely inside the token lifetime.
- Layers can be omitted. A layer whose generation fails, or whose mask
is empty for the ingestion's area (commonly
deforestationwhere no post-2020 alerts intersect), is omitted fromtile_urlsrather than failing the request. Treat the key set as dynamic. - The resource is computed on read, so
datahas noid. - The before/after satellite basemap is a separate concern โ see
POST /imagery/tiles.
โถErrors
404 NOT_FOUNDโ unknown task id, or a task belonging to another organization.409 CONFLICTโ the ingestion has not reached astaged/completed/completed_with_errorsstate yet (overlay inputs don't exist before then), or it has no staged locations with geometry.502 IMAGERY_UPSTREAM_ERRORโ the upstream tile service is unavailable or minted no layers; retry later (nothing is cached on this path).
Required scope:
ingestions:read