new ol.View(opt_options)
Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
View options.
|
Fires:
-
change:center
(ol.ObjectEvent) -
change:resolution
(ol.ObjectEvent) -
change:rotation
(ol.ObjectEvent) -
propertychange
(ol.ObjectEvent) - Triggered when a property is changed.
Subclasses
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}
-
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 size
ol.Size Box pixel size.
Returns:
Extent.
-
centerOn(coordinate, size, position) experimental
-
Center on coordinate and view position.
Name Type Description coordinate
ol.Coordinate Coordinate.
size
ol.Size Box pixel size.
position
ol.Pixel Position on the view to center on.
-
changed() inherited experimental
-
Increases the revision counter and dispatches a 'change' event.
Fires:
-
change
experimental
-
-
constrainCenter(center){ol.Coordinate|undefined} experimental
-
Get the constrained center of this view.
Name Type Description center
ol.Coordinate | undefined Center.
Returns:
Constrained center.
-
constrainResolution(resolution, opt_delta, opt_direction){number|undefined} experimental
-
Get the constrained resolution of this view.
Name Type Description resolution
number | undefined Resolution.
delta
number Delta. Default is
0
.direction
number Direction. Default is
0
.Returns:
Constrained resolution.
-
constrainRotation(rotation, opt_delta){number|undefined} experimental
-
Get the constrained rotation of this view.
Name Type Description rotation
number | undefined Rotation.
delta
number Delta. Default is
0
.Returns:
Constrained rotation.
-
fitExtent(extent, size) experimental
-
Fit the map view to the passed extent and size. 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()
.Name Type Description extent
ol.Extent Extent.
size
ol.Size Box pixel size.
-
fitGeometry(geometry, size, opt_options) experimental
-
Fit the given geometry into the view based on the given map size and border.
Name Type Description geometry
ol.geom.SimpleGeometry Geometry.
size
ol.Size Box pixel size.
options
Options.
Name Type Description padding
Array.<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]
.constrainResolution
boolean | undefined experimental Constrain the resolution. Default is
true
.nearest
boolean | undefined experimental Get the nearest extent. Default is
false
.minResolution
number | undefined experimental Minimum resolution that we zoom to. Default is
0
.maxZoom
number | undefined experimental Maximum zoom level that we zoom to. If
minResolution
is given, this property is ignored. -
get(key){*} inherited
-
Gets a value.
Name Type Description key
string Key name.
Returns:
Value.
-
getCenter(){ol.Coordinate|undefined}
-
Get the view center.
Returns:
The center of the view.
-
getKeys(){Array.<string>} inherited
-
Get a list of object property names.
Returns:
List of property names.
-
getProjection(){ol.proj.Projection}
-
Get the view projection.
Returns:
The projection of the view.
-
getProperties(){Object.<string, *>} inherited
-
Get an object of all property names and values.
Returns:
Object.
-
getResolution(){number|undefined}
-
Get the view resolution.
Returns:
The resolution of the view.
-
getRevision(){number} inherited experimental
-
Returns:
Revision.
-
getRotation(){number}
-
Get the view rotation.
Returns:
The rotation of the view in radians.
-
getZoom(){number|undefined}
-
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
-
Listen for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
this
Object The object to use as
this
inlistener
.Returns:
Unique key for the listener.
-
once(type, listener, opt_this){goog.events.Key} inherited
-
Listen once for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
this
Object The object to use as
this
inlistener
.Returns:
Unique key for the listener.
-
rotate(rotation, opt_anchor)
-
Rotate the view around a given coordinate.
Name Type Description rotation
number New rotation value for the view.
anchor
ol.Coordinate The rotation center.
-
set(key, value) inherited
-
Sets a value.
Name Type Description key
string Key name.
value
* Value.
-
setCenter(center)
-
Set the center of the current view.
Name Type Description center
ol.Coordinate | undefined The center of the view.
-
setProperties(values) inherited
-
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 values
Object.<string, *> Values.
-
setResolution(resolution)
-
Set the resolution for this view.
Name Type Description resolution
number | undefined The resolution of the view.
-
setRotation(rotation)
-
Set the rotation for this view.
Name Type Description rotation
number The rotation of the view in radians.
-
setZoom(zoom)
-
Zoom to a specific zoom level.
Name Type Description zoom
number Zoom level.
-
un(type, listener, opt_this) inherited
-
Unlisten for a certain type of event.
Name Type Description type
string | Array.<string> The event type or array of event types.
listener
function The listener function.
this
Object The object which was used as
this
by thelistener
. -
unByKey(key) inherited
-
Removes an event listener using the key returned by
on()
oronce()
. Note that using theol.Observable.unByKey
static function is to be preferred.Name Type Description key
goog.events.Key The key returned by
on()
oronce()
. -
unset(key) inherited
-
Unsets a property.
Name Type Description key
string Key name.