Raster Map Tiles¶
We offer PNG raster map tiles in 256x256 px and 512x512 px "retina" sizes. While vector tiles have replaced the classic image grid for many applications, some uses require or benefit from the simplicity of raster tiles. Additionally, OpenLayers has an unparalleled set of advanced features, and Leaflet has an unparalleled ease of use, so we let you decide!
Tile URL Format¶
Most renderers use a format string like the one below and will automatically
replace the placeholders for you. The only thing you'll need to replace yourself in most cases is the <style>
placeholder. You can find the URLs for all our styles in the style gallery.
Max Zoom
For raster styles, we support up to zoom 20.
If your library of choice supports specifying a max zoom, we recommend adding it to prevent visual errors.
Our standard endpoints will serve tiles from the fastest server no matter where your users are, and is backed by our global CDN with multiple layers of redundancy.
https://tiles.stadiamaps.com/tiles/<style>/{z}/{x}/{y}{r}.png
https://tiles.stadiamaps.com/tiles/<style>/{z}/{x}/{y}.png
https://tiles.stadiamaps.com/tiles/<style>/{z}/{x}/{y}@2x.png
Our EU endpoints allow you to explicitly route all requests to our EU servers. See our EU Endpoints page for more details.
https://tiles-eu.stadiamaps.com/tiles/<style>/{z}/{x}/{y}{r}.png
https://tiles-eu.stadiamaps.com/tiles/<style>/{z}/{x}/{y}.png
https://tiles-eu.stadiamaps.com/tiles/<style>/{z}/{x}/{y}@2x.png
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.
Authentication¶
Our tile endpoints are authenticated. Most use cases will require either domain-based authentication or an API key. For details on how this works, refer to our authentication guide.
Tutorials¶
We have an extensive tutorial library to help you get started with the most popular libraries/frameworks. If your library/framework isn't listed, let us know! Our tiles can be used with any raster map renderer capable of loading PNG tiles.