Map是OpenLayers的核心组件，使用Map的构造函数可以创建一个地图对对象，用于添加在网页中的div容器中。Map的功能主要用于渲染地图，添加图层，添加UI控件元素等信息，初始化地图对象的时候，可以传递一个对象，传递一些属性值。如下代码为一个创建地图的实例：
import Map from 'ol/Map';
import View from 'ol/View';
import TileLayer from 'ol/layer/Tile';
import OSM from 'ol/source/OSM';
var map = new Map({
view: new View({
center: [0, 0],
zoom: 1
}),
layers: [
new TileLayer({
source: new OSM()
})
],
target: 'map'
});
属性
创建地图的时候，可以在构造函数中传递如下属性信息：
- controls： 与地图相关的控件列表，它有默认添加了一些控件，可进行修改。
- pixelRatio：设备上物理像素和设备独立像素（DIP）的比率。
- interactions：指定地图上的交互对象。
- keyboardEventTarget：用于侦听键盘事件的元素。
- layers：用于添加图层，初始化的时候最好指定一个图层。
- maxTilesLoading：加载瓦片的最大数量。
- moveTolerance：可以扩大地图点击的范围
- overlays：初始化时添加到地图上的覆盖物。
- target：地图容器，为元素的
id。- view：设置地图视图。
方法
Map中的方法如下所示：
- addControl：添加控件到地图上。
- addInteraction：添加交互事件到地图上。
- addLayer：添加图层到地图上，用
getLayers()可以获取到已添加的图层。- addOverlay：添加覆盖物到地图上。
- changed：计数器更新时触发的事件。
- dispatchEvent：用于派发事件。
- forEachFeatureAtPixel：针对矢量数据源，通过鼠标点击坐标与map坐标对比，获取选中要素。
- forEachLayerAtPixel：通过鼠标点击坐标与map坐标对比，获取选中的图层。
- get：根据
键名称获取相关值。- getControls：获取添加的控件列表。
- getCoordinateFromPixel：获取鼠标所在位置的坐标值信息。
- getEventCoordinate：返回浏览器事件的用户投影中的坐标。如：
map.getEventCoordinate(e.originalEvent)，注意，这里要用originalEvent。- getEventPixel：根据事件来获取屏幕坐标，如：
map.getEventPixel(e.originalEvent)，注意，这里要用originalEvent。- getFeaturesAtPixel：获取鼠标光标处的要素信息，如
map.getFeaturesAtPixel(e.pixel);- getInteractions：获取交互事件的列表。
- getKeys：获取添加的键列表。
- getLayerGroup：获取地图的图层组。
- getLayers：获取添加在地图上的所有图层。
- getOverlayById：根据id来获取地图覆盖物。
- getOverlays：获取添加的所有覆盖物。
- getPixelFromCoordinate：将坐标值转成屏幕坐标。
- getProperties：获取地图对象的属性和对应的值。
- getRevision：获取地图对象的版本号，当地图对象更改时，版本号将递增。
- getSize：获取地图的尺寸。
- getTarget：获取地图容器元素的
ID值。- getTargetElement：获取地图容器元素对象。
- getView：获取地图视图对象。
- getViewport：获取地图的视口元素。
- hasFeatureAtPixel：获取鼠标光标处是否有要素信息。
- on：用于给地图添加事件。
- once：添加只需执行一次的事件。
- removeControl：删除控件。
- removeInteraction：删除交互事件。
- removeLayer：删除指定图层。
- removeOverlay：删除指定的覆盖物。
- render：地图渲染函数。
- renderSync：返回同步渲染器。
- set：设置键值对。
- setLayerGroup：设置图层组。
- setProperties：设置属性。
- setSize：修改地图尺寸。
- setTarget：设置地图容器的元素ID。
- setView：设置地图视图。
- un：删除事件。
- unset：删除设置的键值对属性。
- updateSize：更新地图的尺寸。
事件
开发的时候可以为地图添加事件来增强交互性，如下为相关的事件信息：
- change：对象版本号变化的时候触发。
- click：地图单击事件。
- dbclick：地图双击事件。
- error：发生错误时触发的事件。
- moveend：地图移动事件。
- movestart：地图开始移动的事件。
- pointerdrag：点击拖动时的事件。
- pointermove：鼠标移动到地图上的事件。
- postcompose：所有图层渲染完后触发的事件。
- postrender：地图渲染完后触发的事件。
- precompose：所有图层渲染完前触发的事件。
- propertychange：属性更改完后触发的事件。
- rendercomplete：全部渲染完后触发的事件。
- singleclick：无需拖动也无需双击的单击。注意，该事件将延迟250毫秒，以确保它不是双击。
个人博客
