Skip to content

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 most raster styles, we support up to zoom 20 (Stamen Watercolor is an exception and may have missing tiles at zoom greater than 16).

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.

URL format with retina placeholder
https://tiles.stadiamaps.com/tiles/<style>/{z}/{x}/{y}{r}.png
URL format 256x256 px
https://tiles.stadiamaps.com/tiles/<style>/{z}/{x}/{y}.png
URL format 512x515 px (for OpenLayers, QGIS, MapLibre, and other renderers without retina placeholder support)
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.

URL format with retina placeholder
https://tiles-eu.stadiamaps.com/tiles/<style>/{z}/{x}/{y}{r}.png
URL format 256x256 px
https://tiles-eu.stadiamaps.com/tiles/<style>/{z}/{x}/{y}.png
URL format 512x515 px (for OpenLayers, QGIS, MapLibre, and other renderers without retina placeholder support)
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

For local development on a web server at localhost or 127.0.0.1, you can get started without any special setup! For mobile, server, and non-local web development, sign up for a free account to configure domain auth or an API key. Our authentication guide has all the gritty details.

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.

JavaScript

WordPress

Mobile