Telogis.GeoBase.Widgets.Map

Print this page
Learn more about Verizon Connect GeoBase.
Get information about the latest release

Widgets.Map inherits from Widgets.AbstractWidget.

Represents a displayed map on the page -- the main component of the GeoStream mapping framework. A MapLayers.TileLayer is implicitly created with the map; other layers can be constructed later. All layers belonging to the map can be accessed by subscripting the map variable with their IDs, like so:

JavaScript

Copy

var Map         = Telogis.GeoBase.Widgets.Map;
var ObjectLayer = Telogis.GeoBase.MapLayers.ObjectLayer;

var map = new Map ({id: 'main_map'});
new ObjectLayer ({id: 'pin_layer', map: map});

var layer = map ['pin_layer'];

Constructor

Name

Description

Widgets.Map(config)

Arguments

config (Object) - Configuration options for the Widgets.Map.

Properties

Name	Type	Description
backgroundColor	Color	The background color to use for the map's frame element, which should ideally match the tile scheme. This may be represented as a Color object, or as a valid CSS color expression. Defaults to '#ffffff'.
center	LatLon	The location to center the map at initially. Defaults to new LatLon (34.0, -118.0).
createTiles	Boolean	A manual override for specifying whether an implicit MapLayers.TileLayer should be created with the map. Defaults to true.
dragBehavior	Number	The behavior for the map to use when the mouse is dragged on it. By default, the map is panned with the mouse. Alternatively, a bounding box can be constructed and the map zoomed to it (Widgets.Map.DRAG_ZOOM). Defaults to Widgets.Map.DRAG_PAN. This property may also be referenced by the name: dragBehaviour or dragMode.
limitLatitudeRange	boolean	Whether or not to restrict latitude panning to within the map bounds. Defaults to false.
maxZoomIndex	Number	A maximum index to constrain this map's zooming to. This can be set later by calling Widgets.Map.setMaxZoomIndex. Defaults to this.getMaxZoomIndex().
minZoomIndex	Number	A minimum index to constrain this map's zooming to. This can be set later by calling Widgets.Map.setMinZoomIndex. Defaults to 0.
rightDragBehavior	Number	The behavior for the map to use when the mouse is dragged on it using the right button. By default, the map is unchanged. Alternatively, the map can be panned or a bounding box can be constructed and the map zoomed to it (Widgets.Map.DRAG_ZOOM). Defaults to Widgets.Map.DRAG_NONE. This property may also be referenced by the name: rightDragMode.
size	Size	The dimensions to create the Widgets.Map with. These default to the dimensions of the parent element, or, if none are available, 240x240.
tileLayerConfig	Object	Additional configuration properties for the implicit MapLayers.TileLayer created with the map. Defaults to {}.
uiEnabled	Boolean	Whether the map should be interactive. Defaults to true.
wheelBehavior	Number	The behavior for the map to use when the mouse wheel is scrolled over it. By default, the map is zoomed in or out, preserving the location of the cursor. Alternatively, it can be zoomed about its center (Widgets.Map.WHEEL_ZOOM_TO_CENTER). Defaults to Widgets.Map.WHEEL_ZOOM_TO_CURSOR. This property may also be referenced by the name: wheelBehaviour or wheelMode.
zoomIndex	Number	The zoom-index to initialize the map with. Defaults to 8.
zoomIndicator	MapLayers.ZoomIndicator	A MapLayers.ZoomIndicator object to be displayed when the user performs a mouse-wheel zoom on the map, clarifying where the map is zooming to. Defaults to null.

Functions

Name

Description

_getBaseMaxZoomLevel ()

Returns the highest max zoom level that this map supports.

Returns

Number - the highest max zoom level that this map supports.

_getZoomAtIndex (Number index)

Finds the zoom level (magnification factor) associated with the given zoom index.

Arguments

index (Number) - The index to use to find the zoom level.

Returns

Number - The zoom corresponding to the given zoom index.

_getZoomLevels ()

Gets all the different zoom levels (magnification factors) supported by the Widgets.Map.

Returns

Array - The current zoom levels supported by the Widgets.Map

addListener (Object listener)

Registers an object with the Widgets.Map so that it is notified whenever the map is updated. Typically, the listener will be either a MapLayers.AbstractLayer or Widgets.MapControl, but user-defined classes may also be used.

Arguments

listener (Object) - The object to notify when the map is updated.

Properties

Name	Type	Description
id	String	A string used to refer to the listener. If this is present, the listener will be able to be accessed from the map object by keying it with this value, in the manner of a hash-table. Defaults to undefined.

bind (Widgets.Map other, Number zoomDifference)

Binds the map to another so that both pan and zoom synchronously. The calling map is designated the "control" map: calling Widgets.Map.bind on the other map as well allows both to control each other.

Arguments

other (Widgets.Map) - The other map to bind the caller to.
(Optional) zoomDifference (Number) - The difference in zoomlevels between the two maps. A negative value represents how many zoom levels further in Widgets.Map.bind.other should be; a positive value represents how many zoom levels further out Widgets.Map.bind.other should be. Defaults to 0.

changeSize (Size dsize)

Changes the size of the map by specified amounts in the horizontal and vertical directions.

Arguments

dsize (Size) - An object containing the width and height values to increase (or decrease) the size of the map by, in pixels.

destroy ()

Frees resources used by the map. While one will typically not have cause to deallocate maps during the lifetime of the page, this is called automatically when the page unloads to prevent leaks in some lesser browsers.

disableUI ()

Disables the map's user interface so that it will not respond to interactive gestures such as dragging and mouse scrolling.

enableUI ()

Enables the map's user interface so that it will respond to interactive gestures such as dragging and mouse scrolling.

findZoomIndexWhichFits ()

returns the zoom index required to fit the BoundingBox, fully on the screen. returns the minimum zoom level if it can't fit on the screen

findZoomIndexWhichFits ()

returns the zoom index required to fit the BoundingBox, fully on the screen. returns the minimum zoom level if it can't fit on the screen

followPosition ()

If the browser supports GeoLocation, calling this function will cause the map to recenter on the current location as it changes. Call stopFollowingPosition() to stop the map updating when the position changes.

getBoundingBox ()

Returns a bounding box in latitude/longitude units that represents the current viewport.

Returns

BoundingBox - A bounding box in latitude/longitude units that represents the current viewport.

getBoxingCursor ()

Finds the CSS cursor attribute used by Widgets.Map elements when a bounding box is being constructed on them.

Returns

String - The boxing cursor style.

getCenter ()

Finds the latitude-longitude coordinates of the map's center.

Returns

LatLon - The center of the calling map.

getCenterXY ()

Finds the x-y coordinates of the map's center.

Returns

Point - The center of the calling map.

getColCount ()

Finds the maximum number of tile columns needed to span the map.

Returns

Number - The map's tile-column count.

getCopyrightStyle ()

Allows changes to the style of the copyright DIV elements style.

Returns

Object - A reference to the style of the DIV element that contains the copyright.

getDefaultCursor ()

Finds the CSS cursor attribute used as default by Widgets.Map elements.

Returns

String - The default cursor style.

getGesturePoint ()

Gets the center point of the current gesture.

Returns

Point - A point calculated to be central and equidistant from all current touches.

getHeight ()

Finds the vertical size of the Widgets.Map.

Returns

Number - The height of the map, in pixels.

getLastZoom ()

Finds the previous zoom (magnification) of the map.

Returns

Number - The zoom of the map before the most recent zoom event.

getLastZoomIndex ()

Finds the last zoom index of the map.

Returns

Number - The zoom index of the map before the most recent zoom event.

getLastZoomLevel ()

This function has been deprecated, use Widgets.Map.getLastZoom

getLatLon (Point point)

Finds the latitude-longitude coordinates of some pixel point on the map, specified relative to the viewport origin.

Arguments

point (Point) - The pixel point to find the location of, relative to the top-left corner of the map.

Returns

LatLon - The latitude-longitude location of Widgets.Map.getLatLon.point.

getMaxZoomIndex ()

Finds the maximum zoom index to which the map may be zoomed.

Returns

Number - The maximum zoom index. If this has not been restricted, it will be the index of the largest of the map's zoom levels.

getMinZoomIndex ()

Finds the minimum zoom index to which the map may be zoomed.

Returns

Number - The minimum zoom index. Default is 0.

getOrigin ()

Finds the pixel-origin of the map's projection.

Returns

Point - The x- and y- coordinates of the origin of the map's projection.

getPan ()

Finds the pan offset of the map since it was set up or zoomed.

Returns

Point - The map's pan offset.

getPanCursor ()

Finds the CSS cursor attribute used by Widgets.Map elements when a pan can potentially be initiated on them.

Returns

String - The pan cursor style.

getPanningCursor ()

Finds the CSS cursor attribute used by Widgets.Map elements when they are currently being panned.

Returns

String - The panning cursor style.

getRelativeZoom ()

returns the relative level of zoom between two zoom indexes - zoom1/zoom2

getResizeAnchor ()

Finds the relative screen coordinates, which correspond to the actual point on the map that will stay static on a resize.

Returns

Point - The resize anchor point on the object that aligns with its designated map location.

getRotation ()

Finds the pan offset of the map since it was set up or zoomed.

Returns

Point - The map's pan offset.

getRowCount ()

Finds the maximum number of tile rows needed to span the map vertically.

Returns

Number - The map's tile-row count.

getScale ()

Gets the amount by which the maps appearance has been scaled.

Returns

Number - The scale of the map such that 1 is 100%, 2 = 200%, .5 = 50%, etc

getSize ()

Finds the dimensions of the Widgets.Map.

Returns

Size - The size of the map, in pixels.

getStartCol ()

Finds the index of the first visible column of the map's projection.

Returns

Number - Which column of the entire set of tiles serves as the start for the map's projection.

getStartRow ()

Finds the index of the first visible row of the map's projection.

Returns

Number - Which row of the entire set of tiles serves as the start for the map's projection.

getTileCoords (Number row, Number col)

Finds the global tile-grid coordinates of the tile that should be drawn at a specified row and column on the map.

Arguments

row (Number) - The row of the map's tile grid to query.
col (Number) - The column of the tile map's grid to query.

Returns

Point - The coordinates of the top-left corner of the tile.

getTileLayer ()

Gets the first MapLayers.TileLayer that was added to the Widgets.Map.

Returns

MapLayers.TileLayer - The map's first tile-layer.

getTileLayers ()

Gets an array of all the MapLayers.TileLayers that have been added to the Widgets.Map.

Returns

Array - An array of the map's tile-layers.

getTileOffset ()

Finds the offset of a tile in the projection.

Returns

Point - The pixel offset of each tile from its actual location. The returned offset of a tile this will always be >= 0.

getTileSize ()

Finds the size (in pixels) of the (square) tiles the projection represents.

Returns

Number - The tile width corresponding to the projection.

getTilesPerSuperTile ()

Finds the number of tiles that compose each super-tile in the map's projection.

Returns

Number - The number of tiles per super-tile.

getWidth ()

Finds the horizontal size of the Widgets.Map.

Returns

Number - The width of the map, in pixels.

getWorldWidthPixels ()

Returns the dimension of the (square) global map, in pixels, at the current zoom level and tile setup.

Returns

Number - The width (and height) of the map in pixels.

getXY (LatLon loc)

Finds the pixel position of a latitude-longitude coordinate pair on the map, relative to the viewport origin.

Arguments

loc (LatLon) - The LatLon location of the point.

Returns

Point - The pixel position of the point, from the map's top-left corner.

getZoom ()

Finds the zoom level (magnification factor) associated with the Widgets.Map's current zoom level.

Returns

Number - The zoom corresponding to the current zoom index.

getZoomIndex ()

Finds the Widgets.Map's current zoom index.

Returns

Number - The index that the Widgets.Map is currently zoomed to.

getZoomLevel ()

This function has been deprecated, use Widgets.Map.getZoom

hideCopyright ()

Makes the copyright text in the lower-right corner of the map invisible.

hideLayers (Function check)

Hides all of the layers of the map, but not the map container itself. Additionally, a checking callback may be provided that determines whether the hide action should be carried out on a per-layer basis.

Arguments

(Optional) check (Function) - An optional callback function that determines whether the given layer should be hidden. Defaults to null.
Arguments
- layer (MapLayers.AbstractLayer) - The layer to potentially hide.
Returns
Boolean - True if the layer should be hidden; false if no action should be carried out.

isDragging ()

Checks whether the map is currently in the midst of a UI drag. This can be useful for determining whether a layer update method should handle an Widgets.Map.UPDATE_PAN, or wait for an Widgets.Map.UPDATE_END_PAN update.

isGesturing ()

Returns true if there are two or more touches and they have moved past the threshold amount defined by Constants.GESTURE_THRESHOLD.

isUIEnabled ()

Finds whether the map is set to respond to user interface events, such as dragging and mouse scrolling.

Returns

Boolean - True if the UI is enabled; false if is disabled.

mouseLatLon (Object e)

Finds the latitude-longitude location of the mouse cursor on the map.

Arguments

e (Object) - A mousemove event.

Returns

LatLon - The position of the cursor.

mouseXY (Object e)

Finds the x-y location of the mouse cursor on the map, relative to its top left corner.

Arguments

e (Object) - A mousemove event.

Returns

Point - The position of the cursor.

pan (LatLon point, Boolean noUpdate)

Pans the map such that the given point is in the center. Note that this does not regenerate the map projection; rather, it adjusts the projection and positioning of the map container as appropriate to the new position.

Arguments

point (LatLon or Point) - A set of x,y-coordinates to orient the map to. Alternatively, a LatLon coordinate pair may be used.
noUpdate (Boolean) - an optional parameter that can be set to true to prevent the map layers from being updated.

panBy (Point delta, Boolean noUpdate)

Pans the map by a set offset. Note that this does not regenerate the map projection; rather, it adjusts the projection and positioning of the map container as appropriate to the new position.

Arguments

delta (Point) - The pixel distances to pan by in the x- and y-directions.
noUpdate (Boolean) - An optional parameter that can be set to true to prevent the map layers from being updated.

panToCorner (Point point, Boolean noUpdate)

Pans the map such that the given (x, y) point is in the top left corner. Note that this does not regenerate the map projection; rather, it adjusts the projection and positioning of the map container as appropriate to the new position.

Arguments

point (Point) - A set of (x, y) coordinates to orient the map to.
noUpdate (Boolean) - an optional parameter that can be set to true to prevent the map layers from being updated.

panToCurrentPosition ()

If the browser supports GeoLocation, calling this function will cause the map to recenter on the current location reported by the browser.

removeListener (Object listener)

Unregisters a listener from the Widgets.Map so that it is no longer notified whenever the map is updated. Typically, the listener will be either a MapLayers.AbstractLayer or Widgets.MapControl, but user-defined classes may also be used.

Arguments

listener (Object) - The object to stop notifying when the map is updated.

Properties

Name	Type	Description
id	String	A string used to refer to the listener. If this is present, the listener will be able to be accessed from the map object by keying it with this value, in the manner of a hash-table. Defaults to undefined.

resetOrigin ()

Resets the origin of the page to (0, 0).

setBackColor (String bgColor)

Sets the background color for the map to display while tiles are loading.

Arguments

bgColor (String) - A color specified in the HTML #rrggbb form.

setBoxingCursor (String css)

Sets the CSS cursor attribute used by Widgets.Map elements when a bounding box is being constructed on them.

Arguments

(Optional) css (String) - The CSS string to set the cursor attribute to. Defaults to 'crosshair'.

setCenter (LatLon point, Boolean noUpdate)

See pan.

Arguments

point (LatLon or Point) - A set of x,y-coordinates to orient the map to. Alternatively, a LatLon coordinate pair may be used.
noUpdate (Boolean) - an optional parameter that can be set to true to prevent the map layers from being updated.

setCopyrightOffset (Point offset)

Sets the offset of the copyright watermark from the map's lower-right corner.

Arguments

(Optional) offset (Point) - The offset, in pixels. If not supplied, the current offset is used. Defaults to null.

setCursor (String cursorCSS)

Sets the CSS cursor attribute currently being used by the Widgets.Map. This will be overridden when an action with a specific cursor (for example, panning or constructing a zoom-box) is performed on the map.

Arguments

cursorCSS (String) - The CSS string to set the map's cursor attribute to.

Returns

String - The CSS cursor string that was being used before the Widgets.Map.setCursor call was made.

setDefaultCursor (String css)

Sets the CSS cursor attribute used as default by Widgets.Map elements.

Arguments

(Optional) css (String) - The CSS string to set the cursor attribute to. Defaults to 'default'.

setDragBehavior (Number behavior)

Sets the behavior for the map to use when the mouse is dragged on it.

Arguments

(Optional) behavior (Number) - The enumerated value associated with the desired drag behavior. Set this to Widgets.Map.DRAG_PAN to pan the map with mouse dragging, or to Widgets.Map.DRAG_ZOOM to zoom the map to a bounding box. Defaults to Widgets.Map.DRAG_PAN.

setHeight (Number height)

Changes the height of the map, without affecting its width.

Arguments

height (Number) - The new height of the map, in pixels.

setMaxZoomIndex (Number value)

Clamps the maximum zoom index of the map to a certain value which cannot be exceeded.

Arguments

value (Number) - The new maximum zoom index.

setMinZoomIndex (Number value)

Clamps the minimum zoom index of the map to a certain value which cannot be exceeded. Defaults to 0.

Arguments

value (Number) - The new minimum zoom index. Must be greater than or equal to 0.

setPanCursor (String css)

Sets the CSS cursor attribute used by Widgets.Map elements when a pan can potentially be initiated on them.

Arguments

(Optional) css (String) - The CSS string to set the cursor attribute to. Defaults to 'pointer'.

setPanningCursor (String css)

Sets the CSS cursor attribute used by Widgets.Map elements when they are currently being panned.

Arguments

(Optional) css (String) - The CSS string to set the cursor attribute to. Defaults to 'pointer'.

setResizeAnchor (Point resizeAnchor)

Changes the relative screen coordinates, which correspond to the actual point on the map that will stay static on a resize.

Arguments

resizeAnchor (Point) - The relative coordinates that align with their designated map location. These coordinates are proportions of the width and height of the object, relative to its top-left corner.

setRightDragBehavior (Number behavior)

Sets the behavior for the map to use when the mouse is dragged on it.

Arguments

(Optional) behavior (Number) - The enumerated value associated with the desired drag behavior. Set this to Widgets.Map.DRAG_PAN to pan the map with mouse dragging, or to Widgets.Map.DRAG_ZOOM to zoom the map to a bounding box. Defaults to Widgets.Map.DRAG_NONE.

setSize (Size s, Boolean force)

Resizes the map to the size specified. Resizing is done with respect to the resize anchor if it has values that are different from the default values (0.5, 0.5).

Arguments

s (Size) - An object containing the new width and height values.
force (Boolean) - Whether to perform the resize regardless of whether the dimensions are unchanged. False by default.

setUIEnabled (Boolean enabled)

Sets whether the map's user interface is enabled, i.e. whether it will respond to interactive gestures such as dragging and mouse scrolling.

Arguments

enabled (Boolean) - True to enable the UI; false to disable it.

setWheelBehavior (Number behavior)

Sets the behavior for the map to use when the mouse-wheel is scrolled over it.

Arguments

(Optional) behavior (Number) - The enumerated value associated with the desired wheel behavior. Set this to Widgets.Map.WHEEL_ZOOM_TO_CURSOR to zoom to the cursor position, or to Widgets.Map.WHEEL_ZOOM_TO_CENTER to zoom about the center of the map. Defaults to Widgets.Map.WHEEL_ZOOM_TO_CURSOR.

setWidth (Number width)

Changes the width of the map, without affecting its height.

Arguments

width (Number) - The new width of the map, in pixels.

setZoomIndex (Number index, Boolean noUpdate)

Sets the zoom index. Valid values are by default from 0 to 19 inclusive but if modified using Widgets.Map.setMinZoomIndex or Widgets.Map.setMaxZoomIndex will be Widgets.Map.getMinZoomIndex to Widgets.Map.getMaxZoomIndex inclusive. 0 is the most zoomed out and shows the greatest area; 19 is the most zoomed in and shows the least area but the greatest detail.

Arguments

index (Number) - The new zoom index from Widgets.Map.getMinZoomIndex to Widgets.Map.getMaxZoomIndex.
noUpdate (Boolean) - an optional parameter that can be set to true to prevent the map layers from being updated.

setZoomIndicator (MapLayers.ZoomIndicator zoomIndicator)

Changes the zoom-indicator being used by the map to indicator the focal point of mouse-wheel zooms.

Arguments

(Optional) zoomIndicator (MapLayers.ZoomIndicator) - A reference to the MapLayers.ZoomIndicator that should be used by the map. If this is null, no indicator will be displayed. Defaults to null.

shade (Widgets.Map other, Object config)

Sets up a MapLayers.ViewportReferenceLayer on another map that represents the calling map's viewport.

Arguments

other (Widgets.Map) - The map to place a shaded region on.
(Optional) config (Object) - Configuration options for the MapLayers.ViewportReferenceLayer. Defaults to {}.

showCopyright ()

Makes the copyright text in the lower-right corner of the map visible.

showLayers (Function check)

Shows all of the layers of the map, but not the map container itself. Additionally, a checking callback may be provided that determines whether the show action should be carried out on a per-layer basis.

Arguments

(Optional) check (Function) - An optional callback function that determines whether the given layer should be shown. Defaults to null.
Arguments
- layer (MapLayers.AbstractLayer) - The layer to potentially show.
Returns
Boolean - True if the layer should be shown; false if no action should be carried out.

slowPan (Object e, Boolean noUpdate)

Animates the panning of the map to a specified center in a sinusoidal motion. Generally, this is called on a double mouse click.

Arguments

e (Object) - The mouse click event arguments.
noUpdate (Boolean) - An optional parameter that can be set to true to prevent the map layers from being updated.

stopFollowingPosition ()

If the browser supports GeoLocation and followPosition() was previously called, calling this function will stop the map from recentering when the position changes.

touchLatLon (Object e)

Finds the latitude-longitude location of the touch on the map.

Arguments

e (Object) - A touchmove event.

Returns

LatLon - The position of the touch.

touchXY (Object e)

Finds the x-y location of the touch on the map, relative to its top left corner.

Arguments

e (Object) - A touchmove event.

Returns

Point - The position of the touch.

update (Number updateType)

Updates the map's layers and controls with a given combination of flags to specify the type of update that has occurred.

Arguments

updateType (Number) - The type of update to apply. May be any combination of the Map.UPDATE* flags.

zoomIn ()

Increases the zoom index by 1, if possible.

zoomOut ()

Decreases the zoom index by 1.

zoomTo (BoundingBox boundingBox)

Centers the map and zooms in on the specified BoundingBox. Applies an automatic pixel buffer around the BoundingBox to ensure it's fully visible in the viewport.

Arguments

boundingBox (BoundingBox) - A BoundingBox to center and zoom to.

Properties

Name	Type	Description
_hasServerInfo	bool	Whether or not the map has received the GeoStream server info or not. If the map has the server info, it will automatically update any listeners attached to it. If the map doesn't have the server info, it will suspend its listeners.
AddListener	EventHandler	An event that is triggered after a listener has been added to the map with a call to Widgets.Map.addListener.
container	Element	The parent DOM element to which layers are added. This is clipped to Widgets.Map.frame, and is moved when the map is panned to smoothly adjust all layers appropriately.
Drag	EventHandler	An event triggered when the map is dragged (also triggers Widgets.Map.Pan). A superevent of AbstractDOMEntity.MouseMove.
DRAG_PAN	Number	An enumeration code for the map's drag-to-pan interface mode.
DRAG_ZOOM	Number	An enumeration code for the map's zoom-to-rect interface mode.
frame	Element	The HTML div element that describes the viewport of the map. Note that this is anchored to the page, unlike Widgets.Map.container, which is moved when the map is panned.
Pan	EventHandler	An event triggered once the map has been panned.
PrePan	EventHandler	An event triggered immediately before the map is panned.
PreRotate	EventHandler	An event triggered immediately before the map is rotated.
PreZoom	EventHandler	An event triggered immediately before the map is zoomed. This is passed the Pointorigin that the map will zoom about: that is, the point that will remain static during the zoom.
RemoveListener	EventHandler	An event that is triggered after a listener has been removed from the map with a call to Widgets.Map.removeListener.
Resize	EventHandler	An event triggered when the map is resized.
Rotate	EventHandler	An event triggered once the map has been rotated.
Update	EventHandler	An event triggered when the map's layers are updated.
UPDATE_CANVAS	Number	An enumeration code for map updates triggered when the contents of the canvas change.
UPDATE_CLEAR_CACHE	Number	An enumeration code for map updates that clears any cached layer data.
UPDATE_END_PAN	Number	An enumeration code for map updates triggered when a dragging pan finishes.
UPDATE_FULL	Number	An enumeration code combining all types of map update.
UPDATE_PAN	Number	An enumeration code for map updates triggered when the location of the map center changes.
UPDATE_REDRAW	Number	An enumeration code for map updates that force a redraw of each layer.
UPDATE_ROTATION	Number	An enumeration code for map updates triggered when the map rotates.
UPDATE_SIZE	Number	An enumeration code for map updates triggered when the map changes size.
UPDATE_SIZE	Number	An enumeration code for map updates triggered when the map changes scale.
UPDATE_SOURCE	Number	An enumeration code for map updates triggered when a layer changes its source data (such as a new tile, or adding a new object) with no change in geometry.
UPDATE_ZOOM	Number	An enumeration code for map updates triggered when the map changes zoom level.
WHEEL_ZOOM_TO_CENTER	Number	An enumeration code for the map's zoom-to-center wheel mode.
WHEEL_ZOOM_TO_CURSOR	Number	An enumeration code for the map's zoom-to-cursor wheel mode.
Zoom	EventHandler	An event triggered once the map has been zoomed. This is passed the Pointorigin of the map when it is zoomed: that is, the point that remains static during the zoom.