Raster providers

--raster NAME uses one of these. mapterm --raster-list prints the same list. Each provider’s own terms of use apply.

Name	Imagery	Max zoom	Key	Credit shown
osm	OpenStreetMap standard map. Light use only, per OSM’s tile policy.	19	none	© OpenStreetMap contributors
esri	Esri World Imagery, global satellite	19	none	Esri, Maxar, Earthstar Geographics
usgs	USGS National Map imagery, United States only, public domain	16	none	USGS The National Map
eox	Sentinel-2 cloudless 2024 by EOX, global at ~10 m, CC BY-NC-SA 4.0	14	none	Sentinel-2 cloudless 2024 by EOX
gibs	NASA GIBS daily imagery, ~250 m (MODIS true color)	9	none	NASA EOSDIS GIBS
esri-light	Esri Light Gray Canvas, a quiet background for overlays	16	none	Esri, HERE, Garmin, © OpenStreetMap contributors
esri-dark	Esri Dark Gray Canvas	16	none	Esri, HERE, Garmin, © OpenStreetMap contributors
vantor	Vantor (Maxar) Vivid basemap	21	VANTOR_API_KEY	Vantor (Maxar) Vivid
planet	Planet basemaps: your subscription’s mosaics	18	PL_API_KEY + mosaic	Imagery © Planet Labs PBC
mapbox	Mapbox Satellite, 512 px Retina tiles	22	MAPBOX_ACCESS_TOKEN	© Mapbox © Maxar
maptiler	MapTiler Satellite, 512 px tiles	20	MAPTILER_KEY	© MapTiler © OpenStreetMap contributors

Past a provider’s maximum zoom, mapterm keeps enlarging its highest-zoom tiles.

Notes

GIBS. --date YYYY-MM-DD picks the day (default yesterday, UTC). Other layers: --raster-param layer=VIIRS_SNPP_CorrectedReflectance_TrueColor (JPEG layers at 250 m).

Vantor. The key is sent as the maxar-api-key header, never in the URL.

Planet. Each customer has their own named mosaics. List them with mapterm --raster-list-mosaics, then use --raster planet --raster-param mosaic=NAME or PLANET_MOSAIC. Planet only accepts the key in the tile URL; mapterm still never prints it.

Keyed providers don’t cache tiles on disk unless you pass --raster-cache, since commercial licenses often limit storing them.