what is openlayer
openlayers是一个高性能、功能全面的地图库。有以下特性：
- 支持各种格式的tiled layers数据
- 使用canvas的高性能vector layer
- 细粒度丰富的交互操作
- 支持commanjs风格
- 开源免费
why use it
一般来说google map api就满足需求了，但是当需要在地图上绘制大量节点时，使用svg来显示部件就会出现很严重的性能问题，一般情况下google maps等的编辑操作也不够流畅。而openlayers使用canvas作为矢量层，大量的点线面信息对于canvas的影响是较小的，而且canvas的交互也更加流畅。
why write this article
- 与高德地图、google maps、百度地图等国内常用地图没有很方便的接口
- 大版本更新后官方文档不全面而且不够清晰，没有guild
- 而且网上简明详细的教程很少
针对以上几点，觉得自己的小经验会对大家有所帮助，可以少走些弯路，也是对自己这几天工作的一个总结。
a simple example(step by step)
下面通过一个简单地小例子介绍openlayers的一些基本用法，以及我觉得重要的地方。
需求
需要使用google map或者高德地图作为底图，在地图上绘制一个矩形，实现矩形的编辑并且能够得到矩形被修改之后的回调函数。大概会涉及到这些技术点：
- 如何与google map等地图组合使用
- 知道坐标数组或者某格式的geo数据，如何在地图上添加feature
- 完成feature的修改
- 得到feature修改后的回调方法
附上简单截图
初始化地图
我们希望openlayer能和google map等组合使用，但是由于google等地图厂商不愿意向openlayer“妥协”，因此现在无法直接使用Tiled Layers，但我们可以将openlayer与地图api组合起来使用。
只使用地图的底图，在底图上覆盖一层 openlayer 的 canvas 层来显示数据并拦截与底图之间的交互，通过地图的 api 来重设状态。
此方案还有以下优点：
- 解决了页面节点过多之后的性能问题
- 底图可以被抽象出去，能够在不影响交互逻辑的基础上更换底图。
代码如下：
Snap interaction example
有了这段代码应该就有了一个可以拖动缩放的地图了。
添加feature
当然光有一个地图是不行的，如果需要往地图上面添加feature怎么办呢？大致有以下两种场景：
- 提供整个地图的信息描述数据，比如geoJson，WKT或者自定义的数据结构等，需要解析整个数据并批量显示在地图上。
- 拿到某个feature的坐标数据，需要添加到地图上，并实现特异化的控制。
批量添加数据
先上代码
/**
* 将geoJson字符串解析后添加到地图中
* @param vectorSource {ol.source.Vector} 需要添加feature的矢量层数据对象
* @param data {string} geoJson字符串
*/
function addFeatures(vectorSource, data){
vectorSource.addFeatures(ol.format.GeoJSON.readFeatures(data, {
// 数据的坐标code
dataProjection: 'EPSG:3857',
// 地图view使用的坐标code
featureProjection: 'EPSG:4326'
}));
}
ol.format下有很多种数据类型，选择匹配的数据格式。
比如WKT使用ol.format.WKT.readFeature
readFeature返回的是ol.Feature的数组，可以通过遍历其来获得feature对象，从而按需求修改或者挂载监听事件。
添加单个feature
如果现有的数据是geoJson等标准格式的数据，可以通过ol.format中的类进行转换。如果有需求则使用ol.proj.transform进行坐标系转换。
// 返回单个feature对象
var feature = ol.format.GeoJSON.readFeature(data)
// 添加到source
vectorSource.addFeature(feature);
如果拿到的是经纬度信息，添加一个polygon
// data 是一个coordinates的二维数组 需要注意
var feature = new ol.feature(new ol.geom.Polygon(data));
修改feature
介绍如何修改feature以及挂载监听事件。
初始化修改添加、修改交互
// 声明选择交互
var select = new ol.interaction.Select({
// 根据 feature editable 选项来判断是否可以选中
filter: function(feature) {
if (_this._featureMap[feature.getId()].editable) {
return true;
}
}
});
// 得到被选中元件的对象
var selected = select.getFeatures();
// 声明修改交互，可以修改被选中的feature
var modify = new ol.interaction.Modify({
features: selected
});
// 当新元件被选中时触发
selected.on('add', event => {
var feature = event.element
})
// 当元件被取消选中时触发，一般把元件的修改回调放在这
selected.on('remove', evt => {
var feature = evt.element;
var fid = feature.getId();
// 判断元件是否被修改还是需要feature的change事件
console.log(fid);
});
// 在interactions中添加
this._map = new ol.Map({
layers: [vector],
interactions: ol.interaction.defaults({
altShiftDragRotate: false,
dragPan: false,
rotate: false
}).extend([new ol.interaction.DragPan({kinetic: null}), select, modify]),
target: $olMapDiv,
view: this._view
});
一般来说如果需要后续对feature进行操作，可以使用getId方法拿到feature的id，可以通过setId来设置自己想要的id，否则会自动生成。 将id存在常驻的对象中供以后使用。
假设拿到ol.Feature对象 feature
feature.on('change:geometry', function(e){
var feature = e.element;
// do what you want 比如标记元件已被修改
})
需要注意的是这个onChange事件在修改的过程中会不断地触发，如果需要的是修改完成之后的回调，需要使用select的remove事件。
select.getFeatures().on('remove', function(e){})
修改feature对象
设置id
feature.setId(id)
得到geometry对象
var geometry = feature.getGeometry();
// 通过调用geometry类的方法修改元件坐标
feature to string
var format = new ol.format.GeoJSON();
format.writeFeature(feature);
需要注意的地方
- openlayers默认的坐标系是
'EPSG:3857'，标准经纬度坐标系是'EPSG:4326' - 看openlayer文档最重要的技巧是注意类型
- geometry接受的coordinates其实是一个三维数组，一定要注意
常用操作
坐标系转换
根据当前坐标系与目标坐标系进行转换。
ol.proj.transform(coordinate, source, destination)
coordinate 在文档中得类型是 Coordinate其实就是一个有横纵坐标组成的数组，因此一定要注意官方文档中得数据类型。
source 当前坐标编码 string类型
destination 目标坐标编码 string类型
从经纬度转化到指定坐标系
ol.proj.fromLonLat(coordinate, opt_projection)
opt_projection 目标坐标编码 string类型
从某坐标转经纬度
ol.proj.toLonLat(coordinate, opt_projection)
数据格式化
ol.format