3.5 KiB
| Map | View | Layers |
|---|---|---|
A [map](ol.Map.html) is made of [layers](ol.layer.html), a [view](ol.View.html) to visualize them, [interactions](ol.interaction.html) to modify map content and [controls](ol.control.html) with UI components. [Overview](ol.Map.html)[Creation](ol.Map.html#Map) [Events](ol.MapBrowserEvent.html) |
The view manages the visual parameters of the map view, like resolution or rotation. [ol.View](ol.View.html) with center, projection, resolution and rotation |
Layers are lightweight containers that get their data from [sources](ol.source.html). [ol.layer.Tile](ol.layer.Tile.html)[ol.layer.Image](ol.layer.Image.html) [ol.layer.Vector](ol.layer.Vector.html) [ol.layer.VectorTile](ol.layer.VectorTile.html) |
| Controls | Interactions | Sources and formats |
| [Map default controls](ol.control.html#.defaults) [All controls](ol.control.html) |
[Map default interactions](ol.interaction.html#.defaults) Interactions for [vector features](ol.Feature.html)
|
[Tile sources](ol.source.Tile.html) for [ol.layer.Tile](ol.layer.Tile.html)
[Image sources](ol.source.Image.html) for [ol.layer.Image](ol.layer.Image.html) [Vector sources](ol.source.Vector.html) for [ol.layer.Vector](ol.layer.Vector.html) [Vector tile sources](ol.source.VectorTile.html) for [ol.layer.VectorTile](ol.layer.VectorTile.html) [Formats](ol.format.Feature.html) for reading/writing vector data [ol.format.WMSCapabilities](ol.format.WMSCapabilities.html) |
| Projections | Observable objects | Other components |
All coordinates and extents need to be provided in view projection (default: EPSG:3857). To transform, use [ol.proj.transform()](ol.proj.html#.transform) and [ol.proj.transformExtent()](ol.proj.html#.transformExtent). [ol.proj](ol.proj.html) |
Changes to all [ol.Objects](ol.Object.html) can be observed by calling the [object.on('propertychange')](ol.Object.html#on) method. Listeners receive an [ol.Object.Event](ol.Object.Event.html) with information on the changed property and old value. | [ol.DeviceOrientation](ol.DeviceOrientation.html) [ol.Geolocation](ol.Geolocation.html) [ol.Overlay](ol.Overlay.html) |
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.
Note for Closure Compiler users compiling their application code together with OpenLayers:
The names of types other than those in the list above (e.g. ol.Coordinate) are subject to change. It
is therefore recommended to either use the resolved type as listed in the API docs (e.g.
Array.<number> instead of ol.Coordinate), or pay attention to the upgrade notes, which will list
the changes for those types.