【译】OpenLayers 1. API 总览

469 阅读2分钟

携手创作,共同成长!这是我参与「掘金日新计划 · 8 月更文挑战」的第1天,点击查看活动详情

文档地址

地图(Map)

地图由图层,让它们可视化的视图,修改地图内容的交互以及控制 UI 的组件构成。

概述
创建
事件

视图(View)

视图管理地图的可视化参数,比如分辨率或者是旋转。

具有中心、投影、选择的视图

图层(Layers)

图层是从源获取数据的轻量级容器。

ol/layer/Tile
ol/layer/Image
ol/layer/Vector
ol/layer/VectorImage
ol/layer/VectorTile
ol/layer/WebGLTile

控件(Controls)

映射默认控件
所有控件

交互(Interactions)

地图默认交互

矢量特征的交互

所有交互

来源和格式(Sources and formats)

瓦片资源ol/layer/Tile 或 ol/layer/WebGLTile
图片资源ol/layer/Image
矢量资源: ol/layer/Vector
矢量瓦片资源 :ol/layer/VectorTile
读写矢量数据的格式
ol/format/WMSCapabilities

预测(Projections)

所有的坐标和返回需要提供视图投影(默认: EPSG:3857),要将坐标从地里信息转换为地理坐标,请使用ol/proj#fromLonLat()ol/proj#toLonLat()。对于范围和其他投影,请使用ol/proj#transformExtent() and ol/proj#transform().

ol/proj

可观察对象(Observable objects)

通过调用object.on('propertychange') 方法可以观察到所有 ol/Objects 的变化。 侦听器接受一个ol/Object.ObjectEvent 包含有关更改的属性和旧值的信息。

其他组件(Other components)

ol/Geolocation
ol/Overlay

API变更策略

OpenLayers API 包括

  • 构造函数的名称和签名
  • 实例方法和属性的名称和签名
  • 函数的名称和签名
  • 常量名

在主要版本系列中,API 不会更改。对 API 的任何更改都将伴随着新的主要版本。

注意:API 更改政策不包括用于设置 OpenLayers UI 样式的 CSS 类名称。它也不涵盖任何类型定义和枚举。