Style Library

Stadia Maps has multiple map styles available. You can browse our house styles below, or create your own. The {r} placeholder should be understood by most tile renderers. If yours does not understand this, you can either leave it blank to get raw 256x256 PNGs, or manually replace it with @2x or @3x for retina 2x or 3x scale. In the case of a request made outside a web browser, make sure to add the API key via query string or HTTP header as described here.

Alidade Smooth

Our custom Alidade Smooth style is designed for maps that use a lot of markers or overlays. It features a muted color scheme and fewer points of interest to allow your added data to shine.

URLs

  • Vector: https://tiles.stadiamaps.com/styles/alidade_smooth.json
  • Raster (XYZ PNGs): https://tiles.stadiamaps.com/tiles/alidade_smooth/{z}/{x}/{y}{r}.png
  • Raster (TileJSON): https://tiles.stadiamaps.com/styles/alidade_smooth/rendered.json
  • Static maps style name: alidade_smooth

Previews

Berlin Berlin @ zoom 11 New York City New York City @ zoom 11 San Francisco San Francisco @ zoom 10

Alidade Smooth Dark

Our custom Alidade Smooth Dark style is designed for maps that use a lot of markers or overlays, but need a little extra darkness. It features a muted dark color scheme and fewer points of interest to allow your added data to shine.

URLs

  • Vector: https://tiles.stadiamaps.com/styles/alidade_smooth_dark.json
  • Raster (XYZ PNGs): https://tiles.stadiamaps.com/tiles/alidade_smooth_dark/{z}/{x}/{y}{r}.png
  • Raster (TileJSON): https://tiles.stadiamaps.com/styles/alidade_smooth_dark/rendered.json
  • Static maps style name: alidade_smooth_dark

Previews

Berlin Berlin @ zoom 11 New York City New York City @ zoom 11 San Francisco San Francisco @ zoom 10

Outdoors

The Stadia Outdoors style is very close to the well known OSM Bright. It highlights a moderate number of features, and we've made some changes of our own to highlight natural features such as mountians. We recommend using this style where you provide directions, have minimal overlays or other data that might clash with the styling, or want POI data. While the name says "outdoors," we try to keep this style applicable to a wide range of uses.

URLs

  • Vector: https://tiles.stadiamaps.com/styles/outdoors.json
  • Raster (XYZ PNGs): https://tiles.stadiamaps.com/tiles/outdoors/{z}/{x}/{y}{r}.png
  • Raster (TileJSON): https://tiles.stadiamaps.com/styles/outdoors/rendered.json
  • Static maps style name: outdoors

Previews

Berlin Berlin @ zoom 11 New York City New York City @ zoom 11 San Francisco San Francisco @ zoom 11

OSM Bright

The OSM Bright style was developed as a sensible starting point for quickly making beautiful maps based on the OpenStreetMap database. It highlights the content in the map itself. We recommend using OSM bright where you provide directions, have minimal overlays or other data that might clash with the styling, or want POI data, and are not satisfied with our outdoors style for some reason.

URLs

  • Vector: https://tiles.stadiamaps.com/styles/osm_bright.json
  • Raster (XYZ PNGs): https://tiles.stadiamaps.com/tiles/osm_bright/{z}/{x}/{y}{r}.png
  • Raster (TileJSON): https://tiles.stadiamaps.com/styles/osm_bright/rendered.json
  • Static maps style name: osm_bright

Previews

Berlin Berlin @ zoom 11 New York City New York City @ zoom 11 San Francisco San Francisco @ zoom 11

Custom Styles

If you are using vector map tiles, you can design and host your own style. We recommend using Maputnik, an open-source style editor for editing GL JSON styles. You can get started by selecting "Open" from the Maputnik menu bar and pasting in one of our vector style URLs and customizing it to your liking.

If you need raster tiles with a custom style, or want to use your own sprites or fonts, contact us for enterprise pricing.