Limited Layer Extent

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

#### Limited Layer Extent

Restricting layer rendering to a limited extent.

This example uses the `layer.setExtent()` method to modify the extent of the overlay layer. Use the controls above to limit rendering based on an extent (approximate country bounds).

Related API documentation:

- ol.Map
,
- ol.View
,
- ol.layer.Tile
,
- ol.proj
,
- ol.source.TileJSON

Copy Edit
Limited Layer Extent Restricting layer rendering to a limited extent. function transform(extent) { return ol.proj.transformExtent(extent, 'EPSG:4326', 'EPSG:3857'); } var extents = { India: transform([68.17665, 7.96553, 97.40256, 35.49401]), Argentina: transform([-73.41544, -55.25, -53.62835, -21.83231]), Nigeria: transform([2.6917, 4.24059, 14.57718, 13.86592]), Sweden: transform([11.02737, 55.36174, 23.90338, 69.10625]) }; var base = new ol.layer.Tile({ source: new ol.source.TileJSON({ url: 'https://api.tiles.mapbox.com/v3/mapbox.world-light.json?secure', crossOrigin: 'anonymous' }) }); var overlay = new ol.layer.Tile({ extent: extents.India, source: new ol.source.TileJSON({ url: 'https://api.tiles.mapbox.com/v3/mapbox.world-black.json?secure', crossOrigin: 'anonymous' }) }); var map = new ol.Map({ layers: [base, overlay], target: 'map', view: new ol.View({ center: [0, 0], zoom: 1 }) }); for (var key in extents) { document.getElementById(key).onclick = function(event) { overlay.setExtent(extents[event.target.id]); }; } <div id="map" class="map"></div> <button type="button" class="btn btn-default" id="India">India</button> <button type="button" class="btn btn-default" id="Argentina">Argentina</button> <button type="button" class="btn btn-default" id="Nigeria">Nigeria</button> <button type="button" class="btn btn-default" id="Sweden">Sweden</button>

    <!DOCTYPE html>
    <html>
      <head>
        <title>Limited Layer Extent</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>
      </head>
      <body>
        <div id="map" class="map"></div>
        <button type="button" class="btn btn-default" id="India">India</button>
        <button type="button" class="btn btn-default" id="Argentina">Argentina</button>
        <button type="button" class="btn btn-default" id="Nigeria">Nigeria</button>
        <button type="button" class="btn btn-default" id="Sweden">Sweden</button>
        <script>
          function transform(extent) {
            return ol.proj.transformExtent(extent, 'EPSG:4326', 'EPSG:3857');
          }

          var extents = {
            India: transform([68.17665, 7.96553, 97.40256, 35.49401]),
            Argentina: transform([-73.41544, -55.25, -53.62835, -21.83231]),
            Nigeria: transform([2.6917, 4.24059, 14.57718, 13.86592]),
            Sweden: transform([11.02737, 55.36174, 23.90338, 69.10625])
          };

          var base = new ol.layer.Tile({
            source: new ol.source.TileJSON({
              url: 'https://api.tiles.mapbox.com/v3/mapbox.world-light.json?secure',
              crossOrigin: 'anonymous'
            })
          });

          var overlay = new ol.layer.Tile({
            extent: extents.India,
            source: new ol.source.TileJSON({
              url: 'https://api.tiles.mapbox.com/v3/mapbox.world-black.json?secure',
              crossOrigin: 'anonymous'
            })
          });

          var map = new ol.Map({
            layers: [base, overlay],
            target: 'map',
            view: new ol.View({
              center: [0, 0],
              zoom: 1
            })
          });

          for (var key in extents) {
            document.getElementById(key).onclick = function(event) {
              overlay.setExtent(extents[event.target.id]);
            };
          }
        </script>
      </body>
    </html>