Stamen Terrain¶
Free
Starter
Standard
Professional
Orient yourself with our terrain maps, featuring hill shading and natural vegetation colors. Available with raster layer groups separating the background, lines, and labels to enable composition with your own raster layers.
Preview and Use Stamen Terrain¶
Notice a Missing or Outdated Tile?
Today we are still serving the original Stamen tilesets. Note that these have missing tiles, particularly at higher zoom levels. Sometime in September, we will deploy updated styles which will have the same update cadence as our other tiles (approximately monthly) and full global coverage at high zoom levels.
No action further will be required on your part to use the tiles when they are deployed.
Our standard endpoints will serve requests from the fastest server no matter where your users are, and is backed by our global CDN with multiple layers of redundancy.
https://tiles-beta.stadiamaps.com/styles/stamen_terrain.json
https://tiles.stadiamaps.com/tiles/stamen_terrain/{z}/{x}/{y}{r}.png
https://tiles.stadiamaps.com/tiles/stamen_terrain/{z}/{x}/{y}@2x.png
Coming Soon
Coming Soon
What do {x}, {y}, {z}, and {r} mean?
The {x}
, {y}
, and {z}
placeholders represent x, y, and zoom
following the standard slippy map tilename
convention. This format is used by most popular libraries. Note that our tile numbering uses the XYZ
scheme, not TMS.
The {r}
placeholder is used for HiDPI ("retina") display suppoort. Popular web map renderers like Leaflet
understand this placeholder. If your renderer does not understand this (e.g., MapLibre GL JS or QGIS),
you can either remove the placeholder to get raw 256x256 PNGs, or replace it with @2x
for 2x scaled images.
Our EU endpoints allow you to explicitly route all requests to our EU servers. See our EU Endpoints page for more details.
Coming Soon
https://tiles-eu.stadiamaps.com/tiles/stamen_terrain/{z}/{x}/{y}{r}.png
https://tiles-eu.stadiamaps.com/tiles/stamen_terrain/{z}/{x}/{y}@2x.png
Coming Soon
Coming Soon
What do {x}, {y}, {z}, and {r} mean?
The {x}
, {y}
, and {z}
placeholders represent x, y, and zoom
following the standard slippy map tilename
convention. This format is used by most popular libraries. Note that our tile numbering uses the XYZ
scheme, not TMS.
The {r}
placeholder is used for HiDPI ("retina") display suppoort. Popular web map renderers like Leaflet
understand this placeholder. If your renderer does not understand this (e.g., MapLibre GL JS or QGIS),
you can either remove the placeholder to get raw 256x256 PNGs, or replace it with @2x
for 2x scaled images.
Leaflet is one of the oldest mapping libraries still in active use, and its longevity is a testament to its quality. What it lacks in fancy 3D support, it makes up for in ease-of-use and a vibrant plugin ecosystem. Check out our tutorials to get started with your favorite web framework or vanilla JavaScript.
1 2 3 4 5 6 7 8 9 10 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
|
In OpenLayers v8.0.0 and newer, Stadia Maps is one of the bundled tile sources, so it's only a few lines of code to get started.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
If you're using a version before v8.0.0, you'll need to create an XYZ source like so.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
|
Raster Layer Groups¶
If you're building a raster map and want to intersperse your own overlays (for example, to use as layers in QGIS), we offer three separate layer groups.
Name | URL format | QGIS URL format | Description |
---|---|---|---|
Terrain Background | https://tiles.stadiamaps.com/tiles/stamen_terrain_background/{z}/{x}/{y}{r}.png |
https://tiles.stadiamaps.com/tiles/stamen_terrain_background/{z}/{x}/{y}@2x.png |
Includes only background layers (water, landcover, etc.) |
Terrain Lines | https://tiles.stadiamaps.com/tiles/stamen_terrain_lines/{z}/{x}/{y}{r}.png |
https://tiles.stadiamaps.com/tiles/stamen_terrain_lines/{z}/{x}/{y}@2x.png |
Includes only line layers (road, borders, etc.) |
Terrain Labels | https://tiles.stadiamaps.com/tiles/stamen_terrain_labels/{z}/{x}/{y}{r}.png |
https://tiles.stadiamaps.com/tiles/stamen_terrain_labels/{z}/{x}/{y}@2x.png |
Includes only label layers (places, road names, etc.) |
Next Steps¶
Take the next step and follow one of our tutorials to set up a map for your website or app. Just plug in one of the appropriate URLs above!