Packagecom.esri.ags.virtualearth
Classpublic class VETiledLayer
InheritanceVETiledLayer Inheritance TiledMapServiceLayer Inheritance Layer Inheritance mx.core.UIComponent
Implements com.esri.ags.virtualearth.IVETiledLayer

Since : ArcGIS API for Flex 1.2

Allows you to use basemaps from Bing Maps (formerly Microsoft Virtual Earth). You can set the mapStyle to switch between "road", "aerial" and "aerialWithLabels". You can set the culture to "en-US", "it-IT" etc to return map labels on the images returned Bing Maps tile servers in the language of the culture.

Note: Bing Maps tiles and geocoding were added in version 1.2.

View the examples

See also

Bing Maps Terms of Use.
Bing Maps Mobile Terms of Use
Esri Terms of use for Bing Maps
Live sample - Bing Maps
Concepts - Using Bing Maps in the ArcGIS API for Flex
Concepts - Getting started with Bing Maps in the ArcGIS API for Flex

Public Properties
 PropertyDefined By
  culture : String
The culture - provides localized strings in the language of the culture for map labels on the Bing Maps tiles.
VETiledLayer
 InheriteddisplayLevels : Array
Levels to display in layer, based on LOD.level.
TiledMapServiceLayer
 InheritedfadeInFrameCount : uint
The number of frames it will take for the tiles to fade in.
TiledMapServiceLayer
 InheritedfullExtent : Extent
[read-only] The full extent of the layer.
TiledMapServiceLayer
 InheritedinitialExtent : Extent
[read-only] Initial extent of the layer.
Layer
 InheritedisInScaleRange : Boolean
[read-only] Returns true if the current scale of the map is between the maximum and minimum scale of the layer [added in version 1.3].
Layer
  key : String
The Bing Maps Key.
VETiledLayer
 Inheritedloaded : Boolean
[read-only] When the layer is loaded, the value becomes "true" and layer properties can be accessed.
Layer
 InheritedloadFault : Fault
[read-only] A reference to the fault that is dispatched when the layer throws a loadError event.
Layer
 Inheritedmap : Map
[read-only] A reference to the Map this layer is in.
Layer
  mapStyle : String
The map style can be set to "road" (default), "aerial" or "aerialWithLabels".
VETiledLayer
 InheritedmaxScale : Number
The maximum scale of the layer [added in version 1.3].
Layer
 InheritedminScale : Number
The minimum scale of the layer [added in version 1.3].
Layer
  spatialReference : SpatialReference
[override] [read-only] Returns a SpatialReference with a wkid value of 102100.
VETiledLayer
 InheritedtileInfo : TileInfo
[read-only] Contains information about the tiling scheme.
TiledMapServiceLayer
  units : String
[override] [read-only] Returns Units.METERS
VETiledLayer
Public Methods
 MethodDefined By
  
VETiledLayer(culture:String = en-US, mapStyle:String = road)
Creates a new VETiledLayer object.
VETiledLayer
 Inherited
refresh():void
Causes the layer to redraw or reload its content.
Layer
Protected Methods
 MethodDefined By
 Inherited
addMapListeners():void
Adds listeners for ExtentEvent.EXTENT_CHANGE, ZoomEvent.ZOOM_START, ZoomEvent.ZOOM_UPDATE and ZoomEvent.ZOOM_END.
Layer
 Inherited
extentChangeHandler(event:ExtentEvent):void
When an EXTENT_CHANGE event occurs, this calls invalidateLayer();
Layer
 Inherited
getTileURL(level:Number, row:Number, col:Number):URLRequest
Subclasses must override this method to cause tiles to be loaded from their own endpoints.
TiledMapServiceLayer
 Inherited
hideHandler(event:FlexEvent):void
When the layer is hidden (visible is set to false), this calls removeMapListeners().
Layer
 Inherited
invalidateLayer():void
Subclasses should call this whenever they would like to have updateLayer() called on them.
Layer
 Inherited
removeAllChildren():void
Removes all the layers children.
Layer
 Inherited
removeMapListeners():void
Removes the four event listeners added by addMapListeners();
Layer
 Inherited
setLoaded(value:Boolean):void
Subclasses must call this when they've loaded all their properties and are ready to load their content.
Layer
 Inherited
showHandler(event:FlexEvent):void
When the layer is shown (visible is set to true), this calls addMapListeners() and invalidateLayer().
Layer
 Inherited
toScreenX(mapX:Number):Number
Converts the x-coordinate of map point to a screen point.
Layer
 Inherited
toScreenY(mapY:Number):Number
Converts the y-coordinate of map point to a screen point.
Layer
 Inherited
updateLayer():void
Subclasses must override this method.
Layer
 Inherited
zoomEndHandler(event:ZoomEvent):void
Finishes the zoom animation.
Layer
 Inherited
zoomStartHandler(event:ZoomEvent):void
Prepares the zoom animation by taking a bitmap of the layer.
Layer
 Inherited
zoomUpdateHandler(event:ZoomEvent):void
Redraws the bitmap of the layer.
Layer
Events
 Event Summary Defined By
 Inherited
isInScaleRangeChange
Fires if the value of isInScaleRange changes.Layer
 Inherited
load
Fires after layer properties for the layer are successfully populated.Layer
 Inherited
loadError
Fires if the layer is unable to load.Layer
 Inherited
updateEnd
Fires when the layer has finished updating its content.Layer
 Inherited
updateStart
Fires when the layer begins to update its content.Layer
Public Constants
 ConstantDefined By
  MAP_STYLE_AERIAL : String = aerial
[static] Bing Maps Aerial is the aerial imagery map style.
VETiledLayer
  MAP_STYLE_AERIAL_WITH_LABELS : String = aerialWithLabels
[static] Bing Maps Aerial with Labels is the aerial imagery map style with a road overlay.
VETiledLayer
  MAP_STYLE_ROAD : String = road
[static] Bing Maps Roads is the road map style.
VETiledLayer
Property Detail
cultureproperty
culture:String

The culture - provides localized strings in the language of the culture for map labels on the Bing Maps tiles.

The default value is en-US.

This property can be used as the source for data binding.


Implementation
    public function get culture():String
    public function set culture(value:String):void

See also

Bing Maps REST documentation - Available Cultures
keyproperty 
key:String

The Bing Maps Key.

This property can be used as the source for data binding.


Implementation
    public function get key():String
    public function set key(value:String):void

See also

http://www.bingmapsportal.com
mapStyleproperty 
mapStyle:String

The map style can be set to "road" (default), "aerial" or "aerialWithLabels".

The default value is road.

This property can be used as the source for data binding.


Implementation
    public function get mapStyle():String
    public function set mapStyle(value:String):void
spatialReferenceproperty 
spatialReference:SpatialReference  [read-only] [override]

Returns a SpatialReference with a wkid value of 102100.


Implementation
    public function get spatialReference():SpatialReference
unitsproperty 
units:String  [read-only] [override]

Returns Units.METERS


Implementation
    public function get units():String
Constructor Detail
VETiledLayer()Constructor
public function VETiledLayer(culture:String = en-US, mapStyle:String = road)

Creates a new VETiledLayer object.

Parameters
culture:String (default = en-US) — The language of the culture for the map labels.
 
mapStyle:String (default = road) — The Bing Map style.
Constant Detail
MAP_STYLE_AERIALConstant
public static const MAP_STYLE_AERIAL:String = aerial

Bing Maps Aerial is the aerial imagery map style.

MAP_STYLE_AERIAL_WITH_LABELSConstant 
public static const MAP_STYLE_AERIAL_WITH_LABELS:String = aerialWithLabels

Bing Maps Aerial with Labels is the aerial imagery map style with a road overlay.

MAP_STYLE_ROADConstant 
public static const MAP_STYLE_ROAD:String = road

Bing Maps Roads is the road map style.

Examples
MXML to use VETiledLayer: 
 <esri:Map>
     <esri:VETiledLayer
         key="_thiscouldbeyourkey_Al0VE-H1tC0tk-eRubZv_EmyM6WZGqAsTyKS8G-WwCGK3"
         mapStyle="road"
     />
 </esri:Map>
ActionScript to use VETiledLayer: 
 var veTiledLayer:VETiledLayer = new VETiledLayer();
 veTiledLayer.key = "_thiscouldbeyourkey_Al0VE-H1tC0tk-eRubZv_EmyM6WZGqAsTyKS8G-WwCGK3";
 veTiledLayer.mapStyle = VETiledLayer.MAP_STYLE_ROAD;
 myMap.addLayer(veTiledLayer);



© 2008-2011 Esri, Inc. All rights reserved.

Wed Nov 30 2011, 04:19 PM -08:00