Openlayers API-Map

2020-02-14  本文已影响0人  写前端的大叔

MapOpenLayers的核心组件,使用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毫秒,以确保它不是双击。
    个人博客
上一篇 下一篇

猜你喜欢

热点阅读