Maps

Updated

Overview

Find these under Locations → Settings, in Maps. They turn on maps and choose the map service for location pages and the Location Map and Location Search blocks.

These settings used to be under Appearance → Customize → Dirigible Locations → Mapping. They moved with the same values, and old links to the Customizer open the new page.

Settings

  • Enable Mapping: interactive maps, a map field on each location, and the Location Map and Location Search blocks. The other map settings show once it's on.
  • Map Provider: Google Maps or OpenStreetMap. OpenStreetMap needs no key.
  • Map Tiles: the map style when using OpenStreetMap. Each style shows a small preview.
  • Stadia API Key: shows when you pick a Stadia or Stamen style (marked *), which need it
  • Carto API Key: shows when you pick a Carto style, which need it
  • Google Maps API Key: required for Google Maps
  • Cookie Prompt: shown in place of a Google map until the visitor accepts cookies

Tips

  • Create your Google key in the Google Cloud Console and restrict it to your site's domain.
  • Map keys are visible in your site's page source, so restrict each one to your site's domain in the provider's dashboard. List both example.com and www.example.com if your site answers on both.
  • A Carto or Stadia style without its key shows the standard OpenStreetMap tiles until you add the key.

Settings

Maps

Enable Mapping

Turns on interactive maps, map pins on locations, and the Location Map and Location Search blocks. More map settings appear once it's on.

Map Provider
  • Google Mapsdefault
  • OpenStreetMap
Map Tiles

The look of OpenStreetMap maps. Each style shows a preview. Carto styles need a Carto API key, and styles marked * need a Stadia API key.

  • Standarddefault
  • Carto Light
  • Carto Voyager
  • Carto Dark
  • Carto Positron
  • Stamen Toner Lite *
  • Stadia OSM Bright *
  • Stadia Alidade *
  • Stadia Alidade Dark *
  • Stadia Outdoors *
  • Stamen Terrain *
  • Stamen Watercolor *
  • Esri Light Gray
  • Esri Dark Gray
  • Esri Street
  • Esri Satellite
  • Topographic
  • CyclOSM
  • Stamen Toner *
Stadia API Key

Needed for the Stadia and Stamen map styles. Without one, those styles show standard OpenStreetMap tiles instead.

Carto API Key

Needed for the Carto map styles. Get a free key from carto.com/basemaps/apikey. Without one, Carto styles show standard OpenStreetMap tiles instead.

Google Maps API Key

Needed for Google Maps. Create one in the Google Cloud Console.

Cookie Prompt

Shown in place of a Google map until the visitor accepts cookies.

Built by Dirigible Studio. Get in touch