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 fromLonLat() and toLonLat(). For extents and other projections, use transformExtent() and transform().

Find these functions and more in the ol/proj module.

Observable objects

Changes to all Objects can be observed by calling the object.on('propertychange') method. Listeners receive an 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.