官术网_书友最值得收藏!

Restricting the map extent

Often, there are situations where you are interested to show data to the user but only for a specific area, which your available data corresponds to (a country, a region, a city, and so on).

In this case, there is no point in allowing the user to explore the whole world, so you need to limit the extent the user can navigate.

In this recipe, we present some ways to limit the area a user can explore.

Restricting the map extent

How to do it...

  1. Create a map instance. Take a look at the couple of properties used in the constructor:
    var map = new OpenLayers.Map("ch1_restricting_view", {
        maxExtent: OpenLayers.Bounds.fromString
            ("-180,-90,180,90"),
        restrictedExtent: OpenLayers.Bounds.fromString
            ("-180,-90,180,90")
    });
    
    
  2. As always, add some layer to see content and center the view:
    var wms = new OpenLayers.Layer.WMS("OpenLayers WMS Basic", "http://vmap0.tiles.osgeo.org/wms/vmap0",
    {
        layers: 'basic'
    });
    map.addLayer(wms);
    map.setCenter(new OpenLayers.LonLat(0, 0), 2);
    
  3. Add the functions that will be executed when buttons are clicked:
    function updateMaxExtent() {
        var left = dijit.byId('left_me').get('value');
        var bottom = dijit.byId('bottom_me').get('value');
        var right = dijit.byId('rigth_me').get('value');
        var top = dijit.byId('top_me').get('value');      
        map.setOptions({
            maxExtent: new OpenLayers.Bounds(left, bottom, 
            right, top)
        });
    }
    function updateRestrictedExtent() {
        var left = dijit.byId('left_re').get('value');
        var bottom = dijit.byId('bottom_re').get('value');
        var right = dijit.byId('rigth_re').get('value');
        var top = dijit.byId('top_re').get('value');
        map.setOptions({
            restrictedExtent: new OpenLayers.Bounds(left, 
            bottom, right, top)
        });
    }
    

How it works...

As you have seen, the map has been instantiated using the two properties maxExtent and restrictedExtent, which are responsible for limiting the area of the map we can explore.

Although similar, these two properties have different meanings. Setting the maxExtent property limits the viewport so its center cannot go outside the specified bounds. By setting the restrictedExtent property the map itself cannot be panned beyond the given bounds.

The functions that react when buttons are clicked get the values from the input fields and apply the new values through the map.setOptions() method:

map.setOptions({
    maxExtent: new OpenLayers.Bounds(left, bottom, right, top)
});

We can pass the same properties we use when creating a new OpenLayers.Map instance to the map.setOptions() method and it will take care to update them.

There's more...

Limiting the map extent is not the only way to limit the information we show to the user. The layers have also similar properties to filter or limit the information they must render.

See also

  • The Moving around the map view recipe
主站蜘蛛池模板: 南平市| 德钦县| 宜兰县| 盱眙县| 沙湾县| 麟游县| 海南省| 湖北省| 葫芦岛市| 唐山市| 诸暨市| 凤山县| 章丘市| 洛隆县| 定南县| 沐川县| 体育| 两当县| 湛江市| 阜新| 深圳市| 潞西市| 东港市| 库尔勒市| 安国市| 西充县| 石泉县| 隆化县| 保德县| 济南市| 蒲城县| 上栗县| 博乐市| 遂平县| 镇坪县| 如东县| 乌鲁木齐市| 衢州市| 盐城市| 卢龙县| 汽车|