OpenLayers 比较有用的对象和属性

1.ol.interaction.Pointer

    是管理地图down、move、up事件的基类，也用于管理地图拖拽事件。

    构造函数结构如下：

new ol.interaction.Pointer(opt_options)

options包括的属性有：
    handleDownEvent：处理地图的down事件。如果该事件返回true，drag队列开始执行。

handleDragEvent：处理地图的drag事件。当down事件返回true，鼠标在拖拽过程中该事件一直被触发。

handleEvent：当地图通知浏览器触发交互时调用该函数，通过返回FALSE，可终止其他交互事件的传播。

handleMoveEvent：在拖拽的过程中触发move事件。

handleUpEvent：捕获鼠标up事件。

2.updateWhileAnimating和updateWhileInteracting属性

默认情况下，当在和地图交互或者动画过程中，tile和vector图层会等待这些过程执行完后才会更新。我们可以通过两个属性禁止这样的现象，在vector图层中，必须在layer级别控制。而像tiled图层可以直接通过map级别控制。代码如下：

var map = new ol.Map({
        target: 'map',
        layers: [
            new ol.layer.Tile({
                source: new ol.source.TileWMS({
                    url: 'http://demo.opengeo.org/geoserver/wms',
                    params: {
                        layers: 'ne_50m_land',
                        format: 'image/png'
                    },
                    wrapX: false
                }),
                name: 'Natural Earth Land'
            }),
            new ol.layer.Vector({
                source: new ol.source.Vector({
                    format: new ol.format.GeoJSON({
                        defaultDataProjection: 'EPSG:4326'
                    }),
                    url: '../../res/world_countries.geojson',
                    wrapX: false
                }),
                name: 'World Countries',
                headers: {
                    pop_est: 'integer',
                    gdp_md_est: 'integer'
                },
                type: 'polygon',
                updateWhileAnimating: false,
                updateWhileInteracting: false
            })
        ],
        view: new ol.View({
            center: [0, 0],
            zoom: 2,
            extent: ol.proj.get('EPSG:3857').getExtent()
        }),
        loadTilesWhileAnimating: true,
        loadTilesWhileInteracting: true
    });

3.限制地图大小属性

只要继承至ol.layer.Base对象的图层都可通过wrapX:false限制图层在x轴方向重复；另外也可通过设置view的extend属性。

wrapX限制

var map = new ol.Map({
[…]
new ol.layer.Tile({
source: new ol.source.TileWMS({
[…]
wrapX: false
[…]
new ol.layer.Vector({
source: new ol.source.Vector({
[…]
wrapX: false
}),

extent显示

view: new ol.View({
[…]
extent: ol.proj.get('EPSG:3857').getExtent()
}),

4.分辨率resolution运算

在web地图中，分辨率表示一个像素点表示的单位长度。下面通过一个计算中心点的例如来说明resolution的运算。

map.getView().on('propertychange', function (evt) {
        var projExtent = this.getProjection().getExtent();
        if (projExtent) {
            var currentCenter = this.getCenter();
            var currentResolution = this.getResolution();
            var mapSize = map.getSize();
            var newExtent = [projExtent[0] + currentResolution * mapSize[0] / 2,
                projExtent[1] + currentResolution * mapSize[1] / 2,
                projExtent[2] - currentResolution * mapSize[0] / 2,
                projExtent[3] - currentResolution * mapSize[1] / 2];
            if (!(new ol.geom.Point(currentCenter).intersectsExtent(newExtent))) {
                currentCenter[0] = Math.min(Math.max(currentCenter[0], newExtent[0]), newExtent[2]);
                currentCenter[1] = Math.min(Math.max(currentCenter[1], newExtent[1]), newExtent[3]);
                this.setCenter(currentCenter);
            }
        }
    });

说明：上面是view各个属性发生变化时触发的事件，view.getProjection()获取投影系对象proj，proj.getExtent()获取投影系的边界。view.getResolution()获取当前视图的分辨率,currentResolution*mapSize[0]表示整个视图在经度方向的总长度。geom.intersectsExtent判断geom是否在extent边界总。

5.使用unByKey注销事件

在很多ol.control.Control控件中我们会注册一些事件，但经常忽略注销，下面的方式是比较通用的注销事件方式：

ol.control.NavigationHistory.prototype.setMap = function (map) {
    ol.control.Control.prototype.setMap.call(this, map);
    if (map === null) {
        ol.Observable.unByKey(this.get('eventId'));
    } else {
        this.set('eventId', map.on('moveend', function (evt) {
            if (this.get('shouldSave')) {
                var view = map.getView();
                var viewStatus = {
                    center: view.getCenter(),
                    resolution: view.getResolution(),
                    rotation: view.getRotation()
                };
                var historyArray = this.get('history');
                var currIndex = this.get('index');
                historyArray.splice(currIndex + 1, historyArray.length - currIndex - 1);
                if (historyArray.length === this.get('maxSize')) {
                    historyArray.splice(0, 1);
                } else {
                    currIndex += 1;
                }
                historyArray.push(viewStatus);
                this.set('index', currIndex);
            } else {
                this.set('shouldSave', true);
            }
        }, this));
    }
};

当控件和地图分离时，map会被设置为null，这个时候可调用ol.Observable.unByKey方法取消对事件的监听。

6.如何改变地图的投影系

首先要创建一个新的视图View，设置view的center、zoom、projection、extent属性。然后调用map的setView重新替换地图的视图。

var view = _this.getMap().getView();
        var oldProj = view.getProjection();
        var newProj = ol.proj.get(this.value);
        var newView = new ol.View({
            center: ol.proj.transform(view.getCenter(), oldProj, newProj),
            zoom: view.getZoom(),
            projection: newProj,
            extent: newProj.getExtent()
        });
        _this.getMap().setView(newView);

其次需要替换所有图层的投影系，遍历所有的图层，按照图层的类型采用不同的替换方式。

_this.getMap().getLayers().forEach(function (layer) {
            _this.changeLayerProjection(layer, oldProj, newProj);
        });

这里的changeLayerProjection是自定义的一个函数，用来处理当个图层的坐标系。

ol.control.Projection.prototype.changeLayerProjection = function (layer, oldProj, newProj) {
    if (layer instanceof ol.layer.Group) {
        layer.getLayers().forEach(function (subLayer) {
            this.changeLayerProjection(subLayer, oldProj, newProj);
        });
    } else if (layer instanceof ol.layer.Tile) {
        var tileLoadFunc = layer.getSource().getTileLoadFunction();
        layer.getSource().setTileLoadFunction(tileLoadFunc);
    } else if (layer instanceof ol.layer.Vector) {
        var features = layer.getSource().getFeatures();
        for (var i = 0; i < features.length; i += 1) {
            features[i].getGeometry().transform(oldProj, newProj);
        }
    }
};

layer存在多种类型，所有需要判断类型分别处理。如果是ol.layer.Group类型，则继续遍历分组中的每个图层；如果图层类型为ol.layer.Tile瓦片类型，这需要getTileLoadFunction获取加载函数，重新设置下（由于瓦片图层有缓存，如果不重新设置加载方式，瓦片图层还是会从老的坐标系加载瓦片，通过setTileLoadFunction重新设置下加载函数可清理掉瓦片缓存）；如果图层类型为ol.layer.Vector，需要遍历source中的所有feature,调用feature下geometry的tranform把老坐标系的坐标转换为新坐标系的坐标。

7.openlayers三种渲染方式

DOM渲染
    DOM渲染是一种支持预THML5浏览器的传统渲染方式。主要限制在于不能显示vector图层，因为vector图层是使用canvas渲染的。仅仅tile和image图层能被DOM元素创建。如果必须支持传统的浏览器（不支持canvas），那么openlayers 2是一个不错的选择。
    Canvas渲染
    是openlayers 3默认的渲染方式，每个图层画在单独的canvas元素上。
    WEBGL
    WEBGL是浏览器对OpenGL的一个现实，浏览器有能力使用硬件加速渲染。该技术广泛用在3D客户端应用。

8.导出图层的必备参数

crossOrigin,ol.source.TileWMS的构造函数有一个参数叫做crossOrigin,如果我们想导出地图图片，必须要设置这个参数：

new ol.layer.Tile({
    source: new ol.source.TileWMS({
        url: 'http://demo.opengeo.org/geoserver/wms',
    params: {
        layers: 'nlcd',
    format: 'image/png'
    },
    wrapX: false,
    crossOrigin: 'anonymous'
    }),
    name: 'Land Cover'
})

9.WEBGL

https://webglfundamentals.org/

10.ol.Geolocation

获取地理位置对象，一个HTML5的帮助类，提供HTML5 Geolocation功能。跟踪终端设备的位置。例如：

var geoloc = new ol.Geolocation({
        projection: map.getView().getProjection(),
        tracking: true
    });
    var geoCaching = new ol.layer.Vector({
        source: new ol.source.Vector()
    });
    map.addLayer(geoCaching);
    geoloc.once('change:position', function (evt) {
        var altitude = this.getAltitude() || 100;
        var myPos = this.getPosition();
        map.getView().setCenter(myPos);
        map.getView().setZoom(17);
        for (var i = 0; i < 50; i += 1) {
            geoCaching.getSource().addFeature(new ol.Feature({
                geometry: new ol.geom.Point([myPos[0] - 500 + Math.random() * 1000, myPos[1] - 500 + Math.random() * 1000, altitude - 150 + Math.random() * 300]),
                loot: 'Treasures of the Seven Seas'
            }));
        }
    });

说明：geoloc不需要添加到地图对象上，只需要设置投影系参数。如果想监听实时位置，可注册change: position事件。geoloc的getAltitude方法获取海拔高度。

Geolocation对象除projection、tracking参数外，还有一个trackingOptions参数，可设置如下：

var geoloc = new ol.Geolocation({
projection: map.getView().getProjection(),
tracking: true,
trackingOptions: {
enableHighAccuracy: true,
maximumAge: 2000
}
});

enableHighAccuracy允许高精准定位，maximumAge设置定位间隔时间，单位为毫秒。

11.Openlayers 3 shp插件使用

shp插件支持导入shp文件到openlayers上直接展示。代码如下：

layerTree.prototype.addVectorLayer = function (form) {
    var file = form.file.files[0];
    var currentProj = this.map.getView().getProjection();
    var fr = new FileReader();
    var sourceFormat = new ol.format.GeoJSON();
    var source = new ol.source.Vector();
    fr.onload = function (evt) {
        var vectorData = evt.target.result;
        var dataProjection = form.projection.value || 

        sourceFormat.readProjection(vectorData) || currentProj;
        shp(vectorData).then(function (geojson) {
            source.addFeatures(sourceFormat.readFeatures(geojson, {
            dataProjection: dataProjection,
            featureProjection: currentProj
            }));
        });
    };
    fr.readAsArrayBuffer(file);
    var layer = new ol.layer.Vector({
        source: source,
        name: form.displayname.value
    });
    this.addBufferIcon(layer);
    this.map.addLayer(layer);
    this.messages.textContent = 'Vector layer added successfully.';
    return this;
};

12.ol.style.Icon

如何定位图标，参考下面代码：

style: new ol.style.Style({
                    image: new ol.style.Icon({
                        /*anchor: [0.5, 46],
                        anchorXUnits: 'fraction',
                        anchorYUnits: 'pixels',*/
                        src: '../../res/marker.png'
                    })
                })

13.Cesium使用

openlayers团队封装了ol3cesium js库，ol3cesium包含了ol.js代码，所有我们在使用ol3cesium的时候不用再引用ol.js了。例如：

<script type="text/javascript" src="../../js/ol3-cesium-
1.10.0/Cesium/Cesium.js"></script>
<script type="text/javascript" src="../../js/ol3-cesium-
1.10.0/ol3cesium.js"></script>

如果我们自定义了ol.js，我们可以在ol3cesium.js引用的后面再引用ol.js即可。例如：

<script type="text/javascript" src="../../js/ol3-cesium-1.10.0/ol3cesium.js"></script>
<script type="text/javascript" src="../../ol/ol.js"></script>

Cesium场景的可视化非常智能，我们仅仅需要额外定义一个海拔瓦图源即可。创建代码如下：

setTimeout(function () {
        var ol3d = new olcs.OLCesium({map: _this.getMap()});
        var scene = ol3d.getCesiumScene();
        scene.terrainProvider = new Cesium.CesiumTerrainProvider({
            url: 'http://assets.agi.com/stk-terrain/world'
        });
        _this.set('cesium', ol3d);
    }, 0);

可调用cesium.setEnabled方法设置是否可用，setBlockCesiumRendering方法设置是否在后台渲染。 可通过这两个方法在2D和3D之间切换。

controlButton.addEventListener('click', function (evt) {
        var cesium = _this.get('cesium');
        if (cesium.getEnabled()) {
            cesium.setBlockCesiumRendering(true);
            cesium.setEnabled(false);
        } else {
            cesium.setBlockCesiumRendering(false);
            cesium.setEnabled(true);
        }
    });

14.openlayers 编译环境

phtyon必须是2.*的版本，并且配置PYTHON环境变量