Advanced Mapbox Vector Tiles

This example uses OpenLayers v4.0.1. The latest is v.

#### Advanced Mapbox Vector Tiles

Example of a Mapbox vector tiles map with custom tile grid.

A vector tiles map which reuses the same tiles for subsequent zoom levels to save bandwith on mobile devices. Note: No map will be visible when the access token has expired.

Related API documentation:

- ol.Map
,
- ol.View
,
- ol.format.MVT
,
- ol.layer.VectorTile
,
- ol.proj
,
- ol.source.VectorTile
,
- ol.style.Fill
,
- ol.style.Icon
,
- ol.style.Stroke
,
- ol.style.Style
,
- ol.style.Text
,
- ol.tilegrid.TileGrid

Copy Edit
Advanced Mapbox Vector Tiles Example of a Mapbox vector tiles map with custom tile grid. /* eslint-disable openlayers-internal/no-unused-requires */ var key = 'Your Mapbox access token from http://mapbox.com/ here'; // For how many zoom levels do we want to use the same vector tiles? // 1 means "use tiles from all zoom levels". 2 means "use the same tiles for 2 // subsequent zoom levels". var reuseZoomLevels = 2; // Offset of loaded tiles from web mercator zoom level 0. // 0 means "At map zoom level 0, use tiles from zoom level 0". 1 means "At map // zoom level 0, use tiles from zoom level 1". var zoomOffset = 1; // Calculation of tile urls var resolutions = []; for (var z = zoomOffset / reuseZoomLevels; z <= 22 / reuseZoomLevels; ++z) { resolutions.push(156543.03392804097 / Math.pow(2, z * reuseZoomLevels)); } function tileUrlFunction(tileCoord) { return ('https://{a-d}.tiles.mapbox.com/v4/mapbox.mapbox-streets-v6/' + '{z}/{x}/{y}.vector.pbf?access_token=' + key) .replace('{z}', String(tileCoord[0] * reuseZoomLevels + zoomOffset)) .replace('{x}', String(tileCoord[1])) .replace('{y}', String(-tileCoord[2] - 1)) .replace('{a-d}', 'abcd'.substr( ((tileCoord[1] << tileCoord[0]) + tileCoord[2]) % 4, 1)); } var map = new ol.Map({ layers: [ new ol.layer.VectorTile({ renderMode: 'vector', preload: Infinity, source: new ol.source.VectorTile({ attributions: '© <a href="https://www.mapbox.com/map-feedback/">Mapbox</a> ' + '© <a href="https://www.openstreetmap.org/copyright">' + 'OpenStreetMap contributors</a>', format: new ol.format.MVT(), tileGrid: new ol.tilegrid.TileGrid({ extent: ol.proj.get('EPSG:3857').getExtent(), resolutions: resolutions }), tilePixelRatio: 16, tileUrlFunction: tileUrlFunction }), style: createMapboxStreetsV6Style() }) ], target: 'map', view: new ol.View({ center: [0, 0], minZoom: 1, zoom: 2 }) }); // ol.style.Fill, ol.style.Icon, ol.style.Stroke, ol.style.Style and // ol.style.Text are required for createMapboxStreetsV6Style() .map { background: #f8f4f0; } <div id="map" class="map"></div>

    <!DOCTYPE html>
    <html>
      <head>
        <title>Advanced Mapbox Vector Tiles</title>
        <link rel="stylesheet" href="https://openlayers.org/en/v4.0.1/css/ol.css" type="text/css">
        <!-- The line below is only needed for old environments like Internet Explorer and Android 4.x -->
        <script src="https://cdn.polyfill.io/v2/polyfill.min.js?features=requestAnimationFrame,Element.prototype.classList,URL"></script>
        <script src="https://openlayers.org/en/v4.0.1/build/ol.js"></script>
        <script src="https://openlayers.org/en/v4.0.1/examples/resources/mapbox-streets-v6-style.js"></script>
        <style>
          .map {
            background: #f8f4f0;
          }
        </style>
      </head>
      <body>
        <div id="map" class="map"></div>
        <script>
          /* eslint-disable openlayers-internal/no-unused-requires */
          var key = 'Your Mapbox access token from http://mapbox.com/ here';

          // For how many zoom levels do we want to use the same vector tiles?
          // 1 means "use tiles from all zoom levels". 2 means "use the same tiles for 2
          // subsequent zoom levels".
          var reuseZoomLevels = 2;

          // Offset of loaded tiles from web mercator zoom level 0.
          // 0 means "At map zoom level 0, use tiles from zoom level 0". 1 means "At map
          // zoom level 0, use tiles from zoom level 1".
          var zoomOffset = 1;

          // Calculation of tile urls
          var resolutions = [];
          for (var z = zoomOffset / reuseZoomLevels; z <= 22 / reuseZoomLevels; ++z) {
            resolutions.push(156543.03392804097 / Math.pow(2, z * reuseZoomLevels));
          }
          function tileUrlFunction(tileCoord) {
            return ('https://{a-d}.tiles.mapbox.com/v4/mapbox.mapbox-streets-v6/' +
                '{z}/{x}/{y}.vector.pbf?access_token=' + key)
                .replace('{z}', String(tileCoord[0] * reuseZoomLevels + zoomOffset))
                .replace('{x}', String(tileCoord[1]))
                .replace('{y}', String(-tileCoord[2] - 1))
                .replace('{a-d}', 'abcd'.substr(
                    ((tileCoord[1] << tileCoord[0]) + tileCoord[2]) % 4, 1));
          }

          var map = new ol.Map({
            layers: [
              new ol.layer.VectorTile({
                renderMode: 'vector',
                preload: Infinity,
                source: new ol.source.VectorTile({
                  attributions: '© <a href="https://www.mapbox.com/map-feedback/">Mapbox</a> ' +
                    '© <a href="https://www.openstreetmap.org/copyright">' +
                    'OpenStreetMap contributors</a>',
                  format: new ol.format.MVT(),
                  tileGrid: new ol.tilegrid.TileGrid({
                    extent: ol.proj.get('EPSG:3857').getExtent(),
                    resolutions: resolutions
                  }),
                  tilePixelRatio: 16,
                  tileUrlFunction: tileUrlFunction
                }),
                style: createMapboxStreetsV6Style()
              })
            ],
            target: 'map',
            view: new ol.View({
              center: [0, 0],
              minZoom: 1,
              zoom: 2
            })
          });

          // ol.style.Fill, ol.style.Icon, ol.style.Stroke, ol.style.Style and
          // ol.style.Text are required for createMapboxStreetsV6Style()
        </script>
      </body>
    </html>