Terrain Viewer
Features

Catalog search

Finding data you have no URL for, from the Add Terrain and Add Basemap dialogs - STAC catalogs and APIs, NextGIS QMS and the OSM Editor Layer Index - and the app's own sources published as STAC

The Add Terrain and Add Basemap dialogs take a URL, or recognise one. When there is no URL yet, their search tabs look one up: a STAC catalog for scenes and DEMs over the view, and for basemaps the two big registries of public map services. What a search found keeps its provenance in Source info. The historical catalogs (post-crisis imagery, national archives, old maps) are a different thing: they feed the timeline and are listed on Historical sources.

A tab in both the Add Terrain and Add Basemap dialogs.

STAC is the standard index for cloud-native imagery and elevation. This tab searches a catalog for scenes over your current view and adds the COG assets it finds as sources, with no download step.

Twenty-six presets ship, grouped by what they hold:

GroupCatalogs
MixedOpenAerialMap, Earth Search (AWS/Element 84), eoAPI demo, NASA VEDA, swisstopo
ImageryCopernicus Data Space Ecosystem (CDSE, catalog only), LINZ New Zealand, Maxar and Vantor open-data disaster events, Planet disaster releases, Planet Data API (your account), Umbra and Capella open SAR, Lower Saxony orthophotos, SPOT Canada
ElevationCopernicus DEM GLO-30 / GLO-90 (CDSE catalog, AWS copy), OpenTopography raster DEMs, LINZ elevation, Polar Geospatial Center (ArcticDEM, REMA, EarthDEM)
Registriesfederated collection discovery (MAAP)

Or paste any catalog URL: a .json is crawled as a static catalog, anything else is treated as a STAC API.

Planet Data API is the one catalog behind a login. Its STAC (api.planet.com/x/data) takes an OpenID access token, not the API key: pip install planet, planet auth login, then paste the output of planet auth print-access-token under Settings → API Keys → Planet access token (it lasts about 2 h 20). Planet's items carry only a thumbnail, so a scene is added as XYZ tiles from tiles.planet.com, signed with your Planet API key (the other field). What a search returns depends on the account's plan.

Copernicus Data Space Ecosystem (CDSE, the EU's official Copernicus archive) is searchable, one collection at a time, but without an account its scenes cannot be shown: every band sits on CDSE's S3 store or behind its download service, both of which need a Copernicus account, and Sentinel-2 comes as JPEG 2000. Each scene is still listed, with its quicklook, its footprint against the searched view, why it does not load, and a link that opens the Copernicus Browser on that dataset, place and day. For Sentinel-2 or Landsat you can actually load, use Earth Search. The Copernicus DEM (CDSE) preset does load: each GLO-30 or GLO-90 tile is read from the identically named keyless copy on AWS Open Data, through titiler. Details: STAC search internals. With a free account, your Sentinel Hub instance id in Settings adds a True colour via your Sentinel Hub button to each Sentinel-2 scene: see API keys.

The same list is also in the Library, under Catalogs — a catalog cannot be "added" the way a single dataset URL can, so its row offers Browse, which closes the Library and opens this tab with that endpoint already selected. That is the entry point worth remembering: the Library is where you look for data, and per-scene DEMs (EarthDEM strips, ArcticDEM strips, OpenTopography's rasters) only exist behind a search.

Datasets get the same button. A Library row with Browse opens this tab on its catalog and its collection, and searches the current view straight away. Some datasets have nothing else, because there is no mosaic to add, only thousands of strips or tiles: EarthDEM, the ArcticDEM and REMA strips, OpenTopography's rasters, the LINZ 1 m DSM, NRCan's HRDEM projects and mosaic tiles, LidarBC, Minnesota's 0.5 m DEM and swissALTI3D. Their rows say stac and offer Browse in place of +, and Load all leaves them out. A mosaic that also has its strips or tiles in a catalog (ArcticDEM, REMA, the LINZ 1 m DEM) has both buttons: + adds the mosaic, Browse finds a dated strip or a full-resolution tile under the current view. Move the map to the area first, since the search covers what is on screen.

Each catalog row also has a +/−, which decides whether that endpoint is offered in the search's own picker at all — so a list you never use can be trimmed to the handful you do. The choice is remembered, and it is stored as the exclusions, so a catalog added in a later release turns up rather than being silently absent.

What the panel does for you:

  • Two access shapes, one UI. A STAC API is paged through its /search endpoint with bbox and datetime; a static catalog has no search, so its child links are crawled breadth-first and filtered to the view. Static crawls of deeply nested archives (Umbra's year-nested tree, for instance) are slow by nature — the progress line says where it is.
  • Filters — date range, current view only, cloud cover.
  • Web Mercator first. Assets already in EPSG:3857 sort ahead of the rest, because they load directly; anything else is pinned to titiler automatically rather than failing quietly.
  • Terrain is filtered to single-band elevation rasters, so the terrain dialog does not offer you an RGB quicklook as a DEM.
  • Collections offering a xyz web-map-link can be added as a tile source directly, without picking an item at all.
  • WMTS links (a wmts web-map-link, or a WMTS capabilities asset) on a collection or an item get a WMTS button in the basemap dialog: the named layer is added in one click, with the link's style or date; without a layer name, the WMTS layer list opens on the service. NASA VEDA publishes these for its GIBS-backed collections.

Your last catalog, collection and filters are remembered per target, so reopening the tab resumes where you left off.

A catalog has to send CORS headers to be usable from a browser at all, regardless of how open its licence is. CNES GEODES, for example, answers 200 with 66 collections and no Access-Control-Allow-Origin — unreachable from any client-side app.

Terrain Viewer's own sources, as STAC

The other way round: every source the app knows is published as a static STAC catalog at /docs/stac/catalog.json. Open it in STAC Map or STAC Browser (the file is served with CORS, in production by GitHub Pages and in development by the Vite proxy). Eight collections:

  • terrain-builtin: the global elevation tiles (Mapterhorn, Mapbox, MapTiler, AWS, Esri, Cesium), each link carrying its tile encoding and whether it needs a key.
  • terrain-library and basemap-library: the libraries, with their declared footprints and native resolution (gsd); COGs as assets, tile services as web-map links.
  • historical-imagery: the timeline's own sources (Wayback, Google Earth Historical, Bing, Planet, EOX, HLS), one item each spanning its archive.
  • eli: every layer of the OSM Editor Layer Index (about 1,750) with its coverage polygon and capture dates where it has them.
  • ign-historical: every dated IGN Géoplateforme layer (about 140), with WMTS and tile links.
  • national-historical: the regional year series on the timeline (about 330 layers: Catalonia, Spain, NRW, Wallonia, Flanders, the Netherlands, Vienna, Luxembourg, Hamburg, Bavaria, Tyrol, Japan, New York City, 1953 East Germany, Google Earth Timelapse, Planetary Computer Landsat and Sentinel-2, Landsat WELD).
  • timeline-catalogs: the catalogs searched per view (HOT STAC, Planet disaster data, Map Warper, Wikimaps, USGS topo, ArcGIS Online, swisstopo, QMS, Allmaps), linked rather than copied; the two STAC ones are children a client can follow.

Tile services use the web-map-links extension (xyz, wms, wmts); each item also links back to the app at its place. Items without a date carry an open time range and terrain-viewer:undated. The catalog is rebuilt by the docs build (pnpm run stac by hand). QMS and Allmaps could later be served as live STAC through a small proxy that turns a STAC search into their own queries.

Two more tabs of the Add Basemap dialog, for imagery rather than elevation.

NextGIS QMS — searches qms.nextgis.com, a community index of public map services. Only tms and wms entries can become a MapLibre raster source directly, so those are what the list shows; each result carries its zoom range and a permalink into the QMS browser.

OSM Editor Layer Index — the imagery catalog behind iD, JOSM and Rapid: about 1,750 aerial, map and historic sources, most of them national or regional agency services with their licence recorded. It ships bundled (bumped weekly) rather than fetched, so it works offline and cannot break when an upstream index moves. It comes from the @osm-editor-kit/maplibre-editor-layer-index package, stable since its 1.0 release (2026-10-31): its four entry points (the index, React, MapLibre and OpenAerialMap helpers) only change in a major version, while the weekly patches add, change and remove layers as the index itself does. The viewer moved to 1.0.2 on 2026-11-14.

  • Filter by text, by category (aerial, map, historic map, OSM-based, historic aerial, QA, elevation), or to layers covering the current view.
  • "Best" layers are starred, as the OSM editors mark them.
  • Licence and attribution follow the layer into Sources Coverage, along with a permalink to the index entry.
  • An entry's real coverage polygon — not a bounding box — can be drawn as a coverage overlay.

An index entry declares whether it is a basemap or an overlay, and that role is honoured on add: an overlay-role layer joins the overlay list rather than silently replacing your basemap.

On this page