new ol.View(opt_options)
| Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
View options.
|
||||||||||||||||||||||||||||||||||||||||||||||
Fires:
-
changeexperimental - Triggered when the revision counter is increased. -
change:center(ol.ObjectEvent) -
change:resolution(ol.ObjectEvent) -
change:rotation(ol.ObjectEvent) -
propertychange(ol.ObjectEvent) - Triggered when a property is changed.
Extends
Observable Properties
| Name | Type | Settable | ol.ObjectEvent type | Description |
|---|---|---|---|---|
center |
ol.Coordinate | undefined | yes | change:center |
The center of the view. |
resolution |
number | undefined | yes | change:resolution |
The resolution of the view. |
rotation |
number | yes | change:rotation |
The rotation of the view in radians. |
Methods
-
calculateExtent(size){ol.Extent}
src/ol/view.js, line 275 -
Calculate the extent for the current view state and the passed size. The size is the pixel dimensions of the box into which the calculated extent should fit. In most cases you want to get the extent of the entire map, that is
map.getSize().Name Type Description sizeol.Size Box pixel size.
Returns:
Extent.
-
centerOn(coordinate, size, position) experimental
src/ol/view.js, line 529 -
Center on coordinate and view position.
Name Type Description coordinateol.Coordinate Coordinate.
sizeol.Size Box pixel size.
positionol.Pixel Position on the view to center on.
-
changed() inherited experimental
src/ol/observable.js, line 50 -
Increases the revision counter and dispatches a 'change' event.
-
constrainCenter(center){ol.Coordinate|undefined} experimental
src/ol/view.js, line 212 -
Get the constrained center of this view.
Name Type Description centerol.Coordinate | undefined Center.
Returns:
Constrained center.
-
constrainResolution(resolution, opt_delta, opt_direction){number|undefined} experimental
src/ol/view.js, line 225 -
Get the constrained resolution of this view.
Name Type Description resolutionnumber | undefined Resolution.
deltanumber Delta. Default is
0.directionnumber Direction. Default is
0.Returns:
Constrained resolution.
-
constrainRotation(rotation, opt_delta){number|undefined} experimental
src/ol/view.js, line 240 -
Get the constrained rotation of this view.
Name Type Description rotationnumber | undefined Rotation.
deltanumber Delta. Default is
0.Returns:
Constrained rotation.
-
dispatchEvent(event) inherited experimental
src/ol/observable.js, line 72 -
Dispatches an event and calls all listeners listening for events of this type. The event parameter can either be a string or an Object with a
typeproperty.Name Type Description eventgoog.events.EventLike Event object.
-
fit(geometry, size, opt_options) experimental
src/ol/view.js, line 448 -
Fit the given geometry or extent based on the given map size and border. The size is pixel dimensions of the box to fit the extent into. In most cases you will want to use the map size, that is
map.getSize(). Takes care of the map angle.Name Type Description geometryol.geom.SimpleGeometry | ol.Extent Geometry.
sizeol.Size Box pixel size.
optionsOptions.
Name Type Description paddingArray.<number> experimental Padding (in pixels) to be cleared inside the view. Values in the array are top, right, bottom and left padding. Default is
[0, 0, 0, 0]. Required.constrainResolutionboolean | undefined experimental Constrain the resolution. Default is
true.nearestboolean | undefined experimental Get the nearest extent. Default is
false.minResolutionnumber | undefined experimental Minimum resolution that we zoom to. Default is
0.maxZoomnumber | undefined experimental Maximum zoom level that we zoom to. If
minResolutionis given, this property is ignored. -
get(key){*} inherited
src/ol/object.js, line 147 -
Gets a value.
Name Type Description keystring Key name.
Returns:
Value.
-
getCenter(){ol.Coordinate|undefined}
src/ol/view.js, line 252 -
Get the view center.
Returns:
The center of the view.
-
getKeys(){Array.<string>} inherited
src/ol/object.js, line 161 -
Get a list of object property names.
Returns:
List of property names.
-
getProjection(){ol.proj.Projection}
src/ol/view.js, line 294 -
Get the view projection.
Returns:
The projection of the view.
-
getProperties(){Object.<string, *>} inherited
src/ol/object.js, line 171 -
Get an object of all property names and values.
Returns:
Object.
-
getResolution(){number|undefined}
src/ol/view.js, line 305 -
Get the view resolution.
Returns:
The resolution of the view.
-
getRevision(){number} inherited experimental
src/ol/observable.js, line 81 -
Get the version number for this object. Each time the object is modified, its version number will be incremented.
Returns:
Revision.
-
getRotation(){number}
src/ol/view.js, line 358 -
Get the view rotation.
Returns:
The rotation of the view in radians.
-
getZoom(){number|undefined}
src/ol/view.js, line 418 -
Get the current zoom level. Return undefined if the current resolution is undefined or not a "constrained resolution".
Returns:
Zoom.
-
on(type, listener, opt_this){goog.events.Key} inherited
src/ol/observable.js, line 94 -
Listen for a certain type of event.
Name Type Description typestring | Array.<string> The event type or array of event types.
listenerfunction The listener function.
thisObject The object to use as
thisinlistener.Returns:
Unique key for the listener.
-
once(type, listener, opt_this){goog.events.Key} inherited
src/ol/observable.js, line 107 -
Listen once for a certain type of event.
Name Type Description typestring | Array.<string> The event type or array of event types.
listenerfunction The listener function.
thisObject The object to use as
thisinlistener.Returns:
Unique key for the listener.
-
rotate(rotation, opt_anchor)
src/ol/view.js, line 563 -
Rotate the view around a given coordinate.
Name Type Description rotationnumber New rotation value for the view.
anchorol.Coordinate The rotation center.
-
set(key, value, opt_silent) inherited
src/ol/object.js, line 201 -
Sets a value.
Name Type Description keystring Key name.
value* Value.
silentboolean Update without triggering an event.
-
setCenter(center)
src/ol/view.js, line 578 -
Set the center of the current view.
Name Type Description centerol.Coordinate | undefined The center of the view.
-
setProperties(values, opt_silent) inherited
src/ol/object.js, line 221 -
Sets a collection of key-value pairs. Note that this changes any existing properties and adds new ones (it does not remove any existing properties).
Name Type Description valuesObject.<string, *> Values.
silentboolean Update without triggering an event.
-
setResolution(resolution)
src/ol/view.js, line 604 -
Set the resolution for this view.
Name Type Description resolutionnumber | undefined The resolution of the view.
-
setRotation(rotation)
src/ol/view.js, line 615 -
Set the rotation for this view.
Name Type Description rotationnumber The rotation of the view in radians.
-
setZoom(zoom)
src/ol/view.js, line 625 -
Zoom to a specific zoom level.
Name Type Description zoomnumber Zoom level.
-
un(type, listener, opt_this) inherited
src/ol/observable.js, line 120 -
Unlisten for a certain type of event.
Name Type Description typestring | Array.<string> The event type or array of event types.
listenerfunction The listener function.
thisObject The object which was used as
thisby thelistener. -
unByKey(key) inherited
src/ol/observable.js, line 133 -
Removes an event listener using the key returned by
on()oronce(). Note that using theol.Observable.unByKeystatic function is to be preferred.Name Type Description keygoog.events.Key The key returned by
on()oronce(). -
unset(key, opt_silent) inherited
src/ol/object.js, line 235 -
Unsets a property.
Name Type Description keystring Key name.
silentboolean Unset without triggering an event.
OpenLayers 3