Index

Map

A map is made of layers, a view to visualize them, interactions to modify map content and controls with UI components.

Overview
Creation
Events

View

The view manages the visual parameters of the map view, like resolution or rotation.

View with center, projection, resolution and rotation

Layers

Layers are lightweight containers that get their data from sources.

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

Projections

All coordinates and extents need to be provided in view projection (default: EPSG:3857). To transform coordinates from and to geographic, use ol/proj#fromLonLat() and ol/proj#toLonLat(). For extents and other projections, use ol/proj#transformExtent() and ol/proj#transform().

ol/proj

Observable objects

Changes to all ol/Objects can be observed by calling the object.on('propertychange') method. Listeners receive an ol/Object.ObjectEvent with information on the changed property and old value.

Other components

ol/Geolocation
ol/Overlay

API change policy

The OpenLayers API consists of
  • names and signatures of constructors
  • names and signatures of instance methods and properties
  • names and signatures of functions
  • names of constants

Within a major release series, the API will not be changed. Any changes to the API will be accompanied by a new major release.

Note: The API change policy does not cover CSS class names that are used to style the OpenLayers UI. It also does not cover any typedefs and enums.