Openlayers API-Map

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:地图容器,为元素的idview:设置地图视图。

Map中的方法如下所示:

addControl:添加控件到地图上。 addInteraction:添加交互事件到地图上。 addLayer:添加图层到地图上,用getLayers()可以获取到已添加的图层。 addOverlay:添加覆盖物到地图上。 changed:计数器更新时触发的事件。 dispatchEvent:用于派发事件。 forEachFeatureAtPixel:针对矢量数据源,通过鼠标点击坐标与map坐标对比,获取选中要素。 forEachLayerAtPixel:通过鼠标点击坐标与map坐标对比,获取选中的图层。 get:根据键名称获取相关值。 getControls:获取添加的控件列表。 getCoordinateFromPixel:获取鼠标所在位置的坐标值信息。 getEventCoordinate:返回浏览器事件的用户投影中的坐标。如:map.getEventCoordinate(e.originalEvent)注意,这里要用originalEventgetEventPixel:根据事件来获取屏幕坐标,如:map.getEventPixel(e.originalEvent)注意,这里要用originalEventgetFeaturesAtPixel:获取鼠标光标处的要素信息,如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:全部渲染完后触发的事件。