包 com.supermap.web.mapping
类 public class Map
继承 Map Inheritance mx.core.Container

地图组件.

Map 用于装载各类图层，它有自己的比例尺、分辨率、地理坐标等属性，虽然图层也有这些属性，但是当图层加载到地图中进行显示时就会以地图的属性值来显示。
该类中声明了一些与地图相关的事件，这样做可以在标签中直接注册事件的侦听器函数。例如 <iClient:Map load="onLoad(event)"/>，onLoad(event) 函数即为事件 load 的侦听器函数。侦听器函数也称为事件的响应函数，当触发某一事件时，则执行侦听器函数中的操作。

默认 MXML 属性layers


公共属性
  属性 定义方
    action : MapAction
获取或设置与 Map 关联的地图操作。如平移、缩放、绘制点/线/面等。
 Map
    bounds : Rectangle2D
[read-only] 获取地图的地理范围。该属性等于 Map 中加载的所有图层的地理范围的并集。
 Map
    center : Point2D
[read-only] 获取地图的中心点坐标。
 Map
    CRS : CoordinateReferenceSystem
[read-only] 获取地图的坐标参考系（ CoordinateReferenceSystem ）.
 Map
    disabledKeys : Array
获取或设置要屏蔽的键盘快捷键。.
 Map
    doubleClickZoomEnabled : Boolean
获取或设置双击时地图是否可以缩放。默认值为 true。在双击 Map 时放大地图，按 Shift 键并双击 Map 则缩小地图。
 Map
    infoWindow : InfoWindow
[read-only] 与 Map 绑定的信息提示窗口 Infowindow，该窗口只能由 Map 来调用，不能创建。
 Map
    keyboardNavigationEnabled : Boolean
获取或设置是否可以通过键盘操作地图。.
 Map
    layerIds : Array
[read-only] 获取地图控件所包含的图层 ID 号...
 Map
    layers : Object
获取或设置当前地图中的所有图层.
 Map
    level : Number
[read-only] 获取地图的缩放级别.
 Map
    loaded : Boolean
[read-only] 判断地图控件当前是否已加载第一个图层。默认值为 false，即未加载。
 Map
    marginFactor : Number
获取或设置由 restrictedBounds 定义的地图浏览范围以外的缓冲比例。0<=marginFactor<1，默认值0.382..
 Map
    maxResolution : Number
获取或设置地图的最大分辨率.
 Map
    maxScale : Number
获取或设置地图的最大比例尺.
 Map
    minResolution : Number
获取或设置地图的最小分辨率.
 Map
    minScale : Number
获取或设置地图的最小比例尺.
 Map
    multiTouchEnabled : Boolean
该接口用于实现在触摸屏中通过触屏操作对地图进行缩放...
 Map
    panDuration : Number
获取或设置地图从一个指定点平移到下一指定点的持续时间。默认值为 300 毫秒（ 0.3 秒），最小取值为 1 毫秒.
 Map
    panEasingFactor : Number
获取或设置地图随鼠标移动的速度。取值范围在 0~1 之间，默认值为 0.2，值越大，平移速度越快。该属性仅对鼠标平移有效。
 Map
    panFactor : Number
获取或设置利用键盘上下左右键平移地图时的平移距离。取值范围在 0~1 之间，默认值为 0.2。例如当按下“<-”键时，地图向左平移整个屏幕显示范围宽度的 0.2 倍距离。
 Map
    panHandCursorVisible : Boolean
获取或设置地图在平移过程中鼠标是否可见。默认值为 false，即不可见。
 Map
    resolution : Number
[read-only] 获取地图当前分辨率。
 Map
    resolutions : Array
获取或设置地图的分辨率数组。默认值为 null，该属性与比例尺数组 scales 属性只需设置其一即可，系统内部会自动进行转换.
 Map
    restrictedBounds : Rectangle2D
获取或设置地图的浏览范围..
 Map
    scale : Number
[read-only] 获取地图当前比例尺。
 Map
    scales : Array
获取或设置地图比例尺数组。该属性与分辨率数组 resolutions 属性只需设置其一即可.
 Map
    screenContainer : ScreenContainer
[read-only] 获取与地图相关的，但不随地图缩放、平移等操作变化的控件、标签等。返回类型为 Group。
 Map
    scrollRectX : Number
[read-only] 获取地图控件滚动矩形范围的 X 值。
 Map
    scrollRectY : Number
[read-only] 获取地图控件滚动矩形范围的 Y 值。
 Map
    scrollWheelZoomEnabled : Boolean
获取或设置当鼠标滚轮滚动时地图是否可以缩放。默认值为 true，即向前滚动时地图放大；反之，则缩小。
 Map
    theme : Theme
[static] 静态变量，要素主题风格。
 Map
    viewBounds : Rectangle2D
获取或设置地图的地理可视范围。例如现有一幅世界地图的 Bounds 为 （-180，-90，180，90），在初始化地图时设置 viewBounds 为 （0，0，180，90），则这时地图上将显示东经0-180度、北纬0-90度的地理范围。
 Map
    zoomDuration : Number
获取或设置地图缩放的速度。默认值为 250 毫秒（ 0.25 秒），最小取值为 1 毫秒.
 Map
    zoomEffectEnabled : Boolean
是否为地图添加缩放动画，默认为 true。.
 Map
    zoomFactor : Number
地图缩放因子。默认值为2，当分辨率数组不为空时，每次放大或缩小时地图的 level 加 1 或减 1。若分辨率数组为空，则表示地图比例尺放大 1 倍或缩小 1 倍。
 Map
公共方法
  方法 定义方
   
Map()
初始化 Map 类的新实例。
 Map
   
addChild(child:DisplayObject):DisplayObject
[Override] 向 Map 容器中添加一个 DisplayObject 子项.
 Map
   
addChildAt(child:DisplayObject, index:int):DisplayObject
[Override] 向 Map 容器中的指定位置添加一个 DisplayObject 子项。.
 Map
   
addLayer(layer:Layer, index:int = -1):String
在指定位置添加图层。.
 Map
   
getLayer(layerId:String):Layer
根据图层 ID 号获取图层。
 Map
   
mapToScreen(mapPoint:Point2D):Point
与 screenToMap() 方法的功能相反，将地图中指定点的地图坐标转换为 Map 本地坐标。有关本地像素坐标说明可参见 screenToMap() 方法。
 Map
   
mapToStage(mapPoint:Point2D):Point
与 stageToMap() 方法的功能相反，将地图中指定点的地图坐标转换为舞台（全局）坐标。有关舞台（全局）坐标说明可参见 stageToMap() 方法。
 Map
   
moveLayer(layerId:String, index:int):void
移动图层，即将指定的图层移动到指定的位置。
 Map
   
pan(offsetX:Number, offsetY:Number):void
根据给定的平移距离进行平移操作。
 Map
   
panByPixel(offsetX:Number, offsetY:Number):void
根据指定的像素大小平移地图。
 Map
   
panTo(pnt2D:Point2D):void
以地图中心点为基准，将地图平移到指定的点。
 Map
   
refresh():void
刷新地图。
 Map
   
removeAllLayers():void
删除所有图层。
 Map
   
removeLayer(layer:Layer):void
删除指指定的图层。
 Map
   
screenToMap(screenPoint:Point):Point2D
将指定的 Map 本地坐标转换为地图坐标（地理单位）...
 Map
   
stageToMap(stage:Point):Point2D
将舞台（全局）坐标转换为地图坐标（地理单位）...
 Map
   
viewEntire():void
全幅显示。
 Map
   
zoomIn(factor:Number = 1):void
地图放大
 Map
   
zoomOut(factor:Number = 1):void
地图缩小.
 Map
   
zoomToLevel(level:int, point:Point2D = null):void
按给定的缩放级别及目标中心点进行对地图进行缩放。即以目标中心点为中心点，将地图缩放至目标缩放级别.
 Map
   
zoomToResolution(resolution:Number, point:Point2D = null):void
按给定的目标分辨率及目标中心点进行缩放。即以目标中心点为中心点，将地图缩放至目标分辨率。当地图中设置了分辨率数组 Resolutions 时，则以数组中与设置的目标分辨率最接近的值为目标分辨率来进行地图缩放。
 Map
   
zoomToScale(scale:Number, point:Point2D = null):void
按给定的目标比例尺及目标中心点进行缩放。即以目标中心点为中心点，将地图缩放至目标比例尺。当地图中设置了比例尺数组 Sclaes 时，则以数组中与设置的目标比例尺最接近的值为目标比例尺来进行地图缩放。使用该方法必须已知地图 DPI。Map 会默认取第一个图层的 DPI。即：如果 Map 中封装的所有图层均没有 DPI 值，则无法使用该方法。
 Map
受保护的方法
  方法 定义方
   
collectionChangeHandler(event:CollectionEvent):void
CollectionEvent.COLLECTION_CHANGE 类型事件的回调函数。
 Map
事件
  事件 Summary 定义方
   
CRSChange
 当地图控件坐标参考系 CRS 发生变化时触发该事件。 Map
   
layerAdd
 添加图层时触发该事件。 Map
   
layerMove
 更改图层顺序时触发该事件。 Map
   
layerRemove
 删除图层时触发该事件。 Map
   
layerRemoveAll
 删除所有图层时触发该事件。 Map
   
load
 当地图控件载入第一个图层完成时触发该事件。 Map
   
mapClick
 单击地图时触发该事件。 Map
   
maxResolutionChange
 地图最大分辨率改变时触发该事件。 Map
   
maxScaleChange
 地图最大比例尺改变时触发该事件。 Map
   
minResolutionChange
 地图最小分辨率改变时触发该事件。 Map
   
minScaleChange
 地图最小比例尺改变时触发该事件。 Map
   
panEnd
 平移结束时触发该事件。 Map
   
panStart
 开始平移时触发该事件。 Map
   
panUpdate
 平移更新时触发该事件。 Map
   
resolutionsChange
 地图分辨率数组改变时触发该事件。 Map
   
viewBoundsChange
 地图可视范围改变时触发该事件。 Map
   
viewBoundsUpdate
 更新地图可视范围时触发该事件。 Map
   
zoomEnd
 地图缩放结束时触发该事件。 Map
   
zoomStart
 地图缩放时触发该事件。 Map
   
zoomUpdate
 地图缩放更新时触发该事件。 Map
Styles
  Style 描述 定义方
   
backgroundImage
 Type: Object CSS Inheritance: no
地图背景图片，优先级高于背景颜色，同时设置时采用背景图片填充。		 Map
   
backgroundImageRepeat
 Type: Boolean CSS Inheritance: no
地图背景图片填充方式，默认为 true，表示重复填充；如果设置为 false，则将背景图片拉伸以填充地图容器。		 Map
属性详细信息
action 属性
action:MapAction

获取或设置与 Map 关联的地图操作。如平移、缩放、绘制点/线/面等。


Implementation
    public function get action():MapAction
    public function set action(value:MapAction):void
bounds 属性  
bounds:Rectangle2D  [read-only]

获取地图的地理范围。该属性等于 Map 中加载的所有图层的地理范围的并集。


Implementation
    public function get bounds():Rectangle2D
center 属性  
center:Point2D  [read-only]

获取地图的中心点坐标。


Implementation
    public function get center():Point2D
CRS 属性  
CRS:CoordinateReferenceSystem  [read-only]

获取地图的坐标参考系（ CoordinateReferenceSystem ）.

坐标参考系使用 EPSG 发布的代表特定椭球体、单位、地理坐标系或投影坐标系的 Well Konwn ID 值（简称 WKID）。该属性为只读，封装于 Map 的第一个 Layer 的 CRS 属性作为 Map 的 CRS。该属性遵循以下两个规则：
1）如果 MAP 的 CRS 为空或者 CRS 的 wkid 属性值为0，则任何 Layer 都可以加载到 Map 中，且加入以后 Map 的 CRS 等于第一个加载的、CRS不为空、或者 CRS 的 wkid 属性值不为 0 的 Layer 的 CRS。
2）如果 Map 上的 CRS 不为空，且 CRS 的 wkid 属性值不为 0，则只有待加入的 Layer 的 CRS 为空、或者 CRS 的 wkid 属性值为 0、或者与 Map 的 CRS 保持一致，则该图层才能被加载到 Map 中。


Implementation
    public function get CRS():CoordinateReferenceSystem
disabledKeys 属性  
disabledKeys:Array

获取或设置要屏蔽的键盘快捷键。.

地图默认可以使用键盘操作地图，此属性用于屏蔽键盘上部分地图操作按键。如：设置此属性的值为 [Keyboard.F] 或 [70],可以取消键盘上f键全幅地图显示功能。

默认值为： null.


Implementation
    public function get disabledKeys():Array
    public function set disabledKeys(value:Array):void
doubleClickZoomEnabled 属性  
doubleClickZoomEnabled:Boolean

获取或设置双击时地图是否可以缩放。默认值为 true。在双击 Map 时放大地图，按 Shift 键并双击 Map 则缩小地图。


Implementation
    public function get doubleClickZoomEnabled():Boolean
    public function set doubleClickZoomEnabled(value:Boolean):void
infoWindow 属性  
infoWindow:InfoWindow  [read-only]

与 Map 绑定的信息提示窗口 Infowindow，该窗口只能由 Map 来调用，不能创建。


Implementation
    public function get infoWindow():InfoWindow
keyboardNavigationEnabled 属性  
keyboardNavigationEnabled:Boolean

获取或设置是否可以通过键盘操作地图。.

当点击上下左右键时地图在垂直或水平方向平移；点击 “+” 号或 “-” 号时进行地图缩放；f 键为全幅显示；home、end、pageup、pagedown分别为右下、右上、左下、左上四个方向的平移。

默认值为： true.


Implementation
    public function get keyboardNavigationEnabled():Boolean
    public function set keyboardNavigationEnabled(value:Boolean):void
layerIds 属性  
layerIds:Array  [read-only]

获取地图控件所包含的图层 ID 号...

若用户添加图层至地图控件时，未设置图层 id，则系统内部会自动生成 id。


Implementation
    public function get layerIds():Array
layers 属性  
layers:Object

获取或设置当前地图中的所有图层. 此处获取的 layers 是一个 layer 数组对象—— ArrayCollection。当设置该属性时可使用三种类型的变量：Layer、Array、ArrayCollection。


Implementation
    public function get layers():Object
    public function set layers(value:Object):void
level 属性  
level:Number  [read-only]

获取地图的缩放级别. 该值等于当前地图控件 Map 的 Resolution 在 Resolutions 数组中的索引值。如果 Resolutions 为空，则该属性为默认值-1，即无限制缩放。


Implementation
    public function get level():Number
loaded 属性  
loaded:Boolean  [read-only]

判断地图控件当前是否已加载第一个图层。默认值为 false，即未加载。


Implementation
    public function get loaded():Boolean
marginFactor 属性  
marginFactor:Number

获取或设置由 restrictedBounds 定义的地图浏览范围以外的缓冲比例。0<=marginFactor<1，默认值0.382..

如下图所示：控制范围（红色矩形框，由 restrictedExtend 定义）右侧与上侧的缓冲长度分别由 marginFactor*map.width 和 marginFactor*map.height 控制。


Implementation
    public function get marginFactor():Number
    public function set marginFactor(value:Number):void

另请参见

restrictedBounds
maxResolution 属性  
maxResolution:Number

获取或设置地图的最大分辨率. Map 的 maxResolution 与 Layer 的 maxResolution 之间的区别：Map_maxResolution 用于控制地图的最大放大级别，即当地图放大至 Map_maxResolution时， 则无法再放大；而 Layer_maxResolution 是用于控制地图的最大显示级别，即当地图放大至 Layer_maxResolution 时，地图可以再进行放大，但无法显示。


Implementation
    public function get maxResolution():Number
    public function set maxResolution(value:Number):void
maxScale 属性  
maxScale:Number

获取或设置地图的最大比例尺. 若该属性未设置，且比例尺数组 Scales 不为空，则该值为比例尺数组 Scales 的最大值；若比例尺数组 Scales 为空，则该值自动由分辨率数组 resolutions 中的最小值转换得来（有关分辨率与比例尺之间的转换请参见“分辨率和比例尺”专题）；若 Scales、resolutions 均为空，则该值默认为 0。


Implementation
    public function get maxScale():Number
    public function set maxScale(value:Number):void
minResolution 属性  
minResolution:Number

获取或设置地图的最小分辨率. Map 的 minResolution 与 Layer 的 minResolution 之间的区别：Map_minResolution 用于控制地图的最小缩小级别，即当地图缩小至 Map_minResolution时， 则无法再缩小；而 Layer_minResolution 是用于控制地图的最小显示级别，即当地图缩小至 Layer_minResolution 时，地图可以再进行缩小，但无法显示。


Implementation
    public function get minResolution():Number
    public function set minResolution(value:Number):void
minScale 属性  
minScale:Number

获取或设置地图的最小比例尺. 若该属性未设置，且比例尺数组 Scales 不为空，则该值为比例尺数组 Scales 的最小值；若比例尺数组 Scales 为空，则该值自动由分辨率数组 resolutions 中的最大值转换得来（有关分辨率与比例尺之间的转换请参见“分辨率和比例尺”专题）；若 Scales、resolutions 均为空，则该值默认为 0。


Implementation
    public function get minScale():Number
    public function set minScale(value:Number):void
multiTouchEnabled 属性  
multiTouchEnabled:Boolean

该接口用于实现在触摸屏中通过触屏操作对地图进行缩放...

支持屏幕双击缩小、双指划动放大两种地图浏览功能。该功能作用于地图 Map，对于封装于 Map 中的所有图层 Layer 均有效。true 表示开启触屏缩放功能，false 反之。默认为：false。
注意事项：
该接口封装于[SuperMap iClient Flex 6R(2012) for Flex产品包]/libs/SuperMap.Web.swc库中，需要Adobe Flex SDK 4.5.0或以上版本的支持；若不使用该接口，Adobe Flex 4 SDK即可。


Implementation
    public function get multiTouchEnabled():Boolean
    public function set multiTouchEnabled(value:Boolean):void
panDuration 属性  
panDuration:Number

获取或设置地图从一个指定点平移到下一指定点的持续时间。默认值为 300 毫秒（ 0.3 秒），最小取值为 1 毫秒.

该属性其实质是用于设置地图平移过程中的动画时间，当平移的距离超出当前地图可视范围的宽或高时，则动画不起作用。
注意：对于使用鼠标进行平移该属性不起作用。


Implementation
    public function get panDuration():Number
    public function set panDuration(value:Number):void
panEasingFactor 属性  
panEasingFactor:Number

获取或设置地图随鼠标移动的速度。取值范围在 0~1 之间，默认值为 0.2，值越大，平移速度越快。该属性仅对鼠标平移有效。


Implementation
    public function get panEasingFactor():Number
    public function set panEasingFactor(value:Number):void
panFactor 属性  
panFactor:Number

获取或设置利用键盘上下左右键平移地图时的平移距离。取值范围在 0~1 之间，默认值为 0.2。例如当按下“<-”键时，地图向左平移整个屏幕显示范围宽度的 0.2 倍距离。

默认值为： 0.2.


Implementation
    public function get panFactor():Number
    public function set panFactor(value:Number):void
panHandCursorVisible 属性  
panHandCursorVisible:Boolean

获取或设置地图在平移过程中鼠标是否可见。默认值为 false，即不可见。

默认值为： false.


Implementation
    public function get panHandCursorVisible():Boolean
    public function set panHandCursorVisible(value:Boolean):void
resolution 属性  
resolution:Number  [read-only]

获取地图当前分辨率。


Implementation
    public function get resolution():Number
resolutions 属性  
resolutions:Array

获取或设置地图的分辨率数组。默认值为 null，该属性与比例尺数组 scales 属性只需设置其一即可，系统内部会自动进行转换. 若未设置该属性，但 scales 不为空，则系统内部会根据 scales 自动计算出分辨率数组。对于不同类型的图层遵循以下规则：
1.对于分块缓存图层也拥有 resolutions 属性，它们之间的关系是：当分块缓存图层与 Map 的 resolutions 属性均不为空时，则取两者的并集做为 Map 的 resolutions 进行出图显示; 当没有设置 Map 的 resolutions 时，则取图层的 resolutions 作为 Map 的 resolutions 显示出图。注意：对于分块缓存图层，图层与 Map 的 resolutions 必须选择其一进行设置，否则不出图。
2.对于动态图层，图层中没有 resolutions 属性，当不设置 Map 的 resolutions 时，地图为无极缩放。若已设置，则按照 Map 的 resolutions 出图显示。
注意：对于 SuperMap iserver 的服务地图，Resolutions 与 scales 两个系列的属性都可进行设置，且只需设置一个即可，内部会自行将 scales 转换为 Resolutions，最终以 Resolutions 出图；而对于 BingMap 等其他服务地图，则只能设置 Resolutions 属性。


Implementation
    public function get resolutions():Array
    public function set resolutions(value:Array):void
restrictedBounds 属性  
restrictedBounds:Rectangle2D

获取或设置地图的浏览范围..

设置有效的浏览范围，配合 marginFactor 可以阻止用户在地图平移浏览过程查看到范围以外的地图信息。默认为 null，表示不作控制。如果设置了此属性，请设置比例尺数组和分辨率数组中的任意一个。


Implementation
    public function get restrictedBounds():Rectangle2D
    public function set restrictedBounds(value:Rectangle2D):void

另请参见

marginFactor
scale 属性  
scale:Number  [read-only]

获取地图当前比例尺。


Implementation
    public function get scale():Number
scales 属性  
scales:Array

获取或设置地图比例尺数组。该属性与分辨率数组 resolutions 属性只需设置其一即可. 系统内部会自动将 scales 转换为 resolutions，最终以 resolutions 为基准显示出图。有关 resolutions 与 Layer、Map 之间的关系，详情请参见 resolutions 属性。


Implementation
    public function get scales():Array
    public function set scales(value:Array):void
screenContainer 属性  
screenContainer:ScreenContainer  [read-only]

获取与地图相关的，但不随地图缩放、平移等操作变化的控件、标签等。返回类型为 Group。


Implementation
    public function get screenContainer():ScreenContainer
scrollRectX 属性  
scrollRectX:Number  [read-only]

获取地图控件滚动矩形范围的 X 值。


Implementation
    public function get scrollRectX():Number
scrollRectY 属性  
scrollRectY:Number  [read-only]

获取地图控件滚动矩形范围的 Y 值。


Implementation
    public function get scrollRectY():Number
scrollWheelZoomEnabled 属性  
scrollWheelZoomEnabled:Boolean

获取或设置当鼠标滚轮滚动时地图是否可以缩放。默认值为 true，即向前滚动时地图放大；反之，则缩小。


Implementation
    public function get scrollWheelZoomEnabled():Boolean
    public function set scrollWheelZoomEnabled(value:Boolean):void
theme 属性  
theme:Theme

静态变量，要素主题风格。


Implementation
    public static function get theme():Theme
    public static function set theme(value:Theme):void
viewBounds 属性  
viewBounds:Rectangle2D

获取或设置地图的地理可视范围。例如现有一幅世界地图的 Bounds 为 （-180，-90，180，90），在初始化地图时设置 viewBounds 为 （0，0，180，90），则这时地图上将显示东经0-180度、北纬0-90度的地理范围。


Implementation
    public function get viewBounds():Rectangle2D
    public function set viewBounds(value:Rectangle2D):void
zoomDuration 属性  
zoomDuration:Number

获取或设置地图缩放的速度。默认值为 250 毫秒（ 0.25 秒），最小取值为 1 毫秒.


Implementation
    public function get zoomDuration():Number
    public function set zoomDuration(value:Number):void
zoomEffectEnabled 属性  
zoomEffectEnabled:Boolean

是否为地图添加缩放动画，默认为 true。.

当该值为 true 时表示地图在缩放时，会有四个箭头指示当前的缩放状态，如下图为放大状态：


Implementation
    public function get zoomEffectEnabled():Boolean
    public function set zoomEffectEnabled(value:Boolean):void
zoomFactor 属性  
zoomFactor:Number

地图缩放因子。默认值为2，当分辨率数组不为空时，每次放大或缩小时地图的 level 加 1 或减 1。若分辨率数组为空，则表示地图比例尺放大 1 倍或缩小 1 倍。


Implementation
    public function get zoomFactor():Number
    public function set zoomFactor(value:Number):void
构造函数详细信息
Map () 构造函数
public function Map()

初始化 Map 类的新实例。

方法详细描述
addChild () 方法
override public function addChild(child:DisplayObject):DisplayObject

向 Map 容器中添加一个 DisplayObject 子项.

若该子项为 Layer 则将其添加至 Map 的 Layers 数组中。

参数

child:DisplayObject — 要添加至 Map 的 DisplayObject 子项。

返回
DisplayObject — 添加的子项将作为 DisplayObject 类型的对象返回。
addChildAt () 方法  
override public function addChildAt(child:DisplayObject, index:int):DisplayObject

向 Map 容器中的指定位置添加一个 DisplayObject 子项。.

若该子项为 Layer 则将其添加至 Map 的 Layers 数组中。

参数

child:DisplayObject — 要添加至 Map 的 DisplayObject 子项。
 
index:int — 指定的位置索引。

返回
DisplayObject — 添加的子项将作为 DisplayObject 类型的对象返回。
addLayer () 方法  
public function addLayer(layer:Layer, index:int = -1):String

在指定位置添加图层。.

如果 layer 的 id 属性为 null，则会给 layer 默认生成一个唯一的 id 值。如果 index 小于0，则默认加载到最顶层，即图层数组的最末端。

参数

layer:Layer — 所要添加的图层。
 
index:int (default = -1) — 指定的位置。

返回
String — 返回图层 ID 号。
collectionChangeHandler () 方法  
protected function collectionChangeHandler(event:CollectionEvent):void

CollectionEvent.COLLECTION_CHANGE 类型事件的回调函数。

参数

event:CollectionEvent — CollectionEvent 事件。

getLayer () 方法  
public function getLayer(layerId:String):Layer

根据图层 ID 号获取图层。

参数

layerId:String — 图层 ID 号。

返回
Layer — 返回与 ID 号对应的图层 Layer。
mapToScreen () 方法  
public function mapToScreen(mapPoint:Point2D):Point

与 screenToMap() 方法的功能相反，将地图中指定点的地图坐标转换为 Map 本地坐标。有关本地像素坐标说明可参见 screenToMap() 方法。

参数

mapPoint:Point2D — 要转换的地图坐标点。

返回
Point — 返回本地坐标。

另请参见

screenToMap()
mapToStage () 方法  
public function mapToStage(mapPoint:Point2D):Point

与 stageToMap() 方法的功能相反，将地图中指定点的地图坐标转换为舞台（全局）坐标。有关舞台（全局）坐标说明可参见 stageToMap() 方法。

参数

mapPoint:Point2D — 要转换的地图坐标点。

返回
Point — 返回舞台（全局）坐标。
moveLayer () 方法  
public function moveLayer(layerId:String, index:int):void

移动图层，即将指定的图层移动到指定的位置。

参数

layerId:String — 指定的图层 ID 号。
 
index:int — 指定的索引位置。即图层将被移动到的位置。

pan () 方法  
public function pan(offsetX:Number, offsetY:Number):void

根据给定的平移距离进行平移操作。

参数

offsetX:Number — X 方向上平移的距离，单位与地图坐标系单位相同，如 WGS_84 坐标单位为经纬度。
 
offsetY:Number — Y 方向上平移的距离，单位与地图坐标系单位相同，如 WGS_84 坐标单位为经纬度。

panByPixel () 方法  
public function panByPixel(offsetX:Number, offsetY:Number):void

根据指定的像素大小平移地图。

参数

offsetX:Number — 指定地图在 X 方向的移动距离，单位：像素。
 
offsetY:Number — 指定地图在 Y 方向的移动距离，单位：像素。

panTo () 方法  
public function panTo(pnt2D:Point2D):void

以地图中心点为基准，将地图平移到指定的点。

参数

pnt2D:Point2D — 指定的二维点坐标。坐标单位为经纬度。

refresh () 方法  
public function refresh():void

刷新地图。

removeAllLayers () 方法  
public function removeAllLayers():void

删除所有图层。

removeLayer () 方法  
public function removeLayer(layer:Layer):void

删除指指定的图层。

参数

layer:Layer — 指定的图层 Layer。

screenToMap () 方法  
public function screenToMap(screenPoint:Point):Point2D

将指定的 Map 本地坐标转换为地图坐标（地理单位）...

screenToMap()方法与 stageToMap() 方法之间的区别：
screenToMap 方法要求传入的点坐标为相对于 Map 容器原点的本地坐标，如下图中鼠标点击位置的本地坐标为（9,12），是相对于 Map 原点（橙色区域左上角点）的坐标。
stageToMap 方法要求传入的点坐标为舞台（全局）坐标，如下图中鼠标点击位置的舞台坐标为（59,60），是相对于Application 原点（蓝色区域左上角点）的坐标。

参数

screenPoint:Point — Map 本地坐标。即鼠标相对于 Map 容器原点（0,0）的坐标。如果通过鼠标事件 MouseEvent 获取本地坐标，则该坐标应由（MouseEvent.localX,MouseEvent.localY）组成。

返回
Point2D — 返回地图坐标。

另请参见

stageToMap()
stageToMap () 方法  
public function stageToMap(stage:Point):Point2D

将舞台（全局）坐标转换为地图坐标（地理单位）...

screenToMap()方法与 stageToMap() 方法之间的区别：
screenToMap 方法要求传入的点坐标为相对于 Map 容器原点的本地坐标，如下图中鼠标点击位置的本地坐标为（9,12），是相对于 Map 原点（橙色区域左上角点）的坐标。
stageToMap 方法要求传入的点坐标为舞台（全局）坐标，如下图中鼠标点击位置的舞台坐标为（59,60），是相对于Application 原点（蓝色区域左上角点）的坐标。

参数

stage:Point — 舞台（全局）坐标。如果通过鼠标事件 MouseEvent 获取舞台（全局）坐标，则该坐标应由（MouseEvent.stageX, MouseEvent.stageY）组成。

返回
Point2D — 返回地图坐标。

另请参见

screenToMap()
viewEntire () 方法  
public function viewEntire():void

全幅显示。

zoomIn () 方法  
public function zoomIn(factor:Number = 1):void

地图放大

参数

factor:Number (default = 1) — 地图放大因子，该属性必须大于 0，默认值为 1，表示地图缩大一倍，若 level 值不为 -1，则 level 加 1。

zoomOut () 方法  
public function zoomOut(factor:Number = 1):void

地图缩小.

地图缩小因子，该属性必须大于 0，默认值为 1，表示地图缩小一倍，若 level 值不为 -1，则 level 减 1。

参数

factor:Number (default = 1)

zoomToLevel () 方法  
public function zoomToLevel(level:int, point:Point2D = null):void

按给定的缩放级别及目标中心点进行对地图进行缩放。即以目标中心点为中心点，将地图缩放至目标缩放级别. 仅当 Map 的 resolutions 属性不为空时，方可使用该方法。

参数

level:int — 目标缩放级别。即目标分辨率在 resolutions 中的索引值。
 
point:Point2D (default = null) — 目标中心点地图坐标。默认值为 null，即默认为 Map 的中心点。

另请参见

level
zoomToResolution () 方法  
public function zoomToResolution(resolution:Number, point:Point2D = null):void

按给定的目标分辨率及目标中心点进行缩放。即以目标中心点为中心点，将地图缩放至目标分辨率。当地图中设置了分辨率数组 Resolutions 时，则以数组中与设置的目标分辨率最接近的值为目标分辨率来进行地图缩放。

参数

resolution:Number — 目标分辨率。
 
point:Point2D (default = null) — 目标中心点地图坐标。默认值为 null，即默认为 Map 的中心点。

zoomToScale () 方法  
public function zoomToScale(scale:Number, point:Point2D = null):void

按给定的目标比例尺及目标中心点进行缩放。即以目标中心点为中心点，将地图缩放至目标比例尺。当地图中设置了比例尺数组 Sclaes 时，则以数组中与设置的目标比例尺最接近的值为目标比例尺来进行地图缩放。使用该方法必须已知地图 DPI。Map 会默认取第一个图层的 DPI。即：如果 Map 中封装的所有图层均没有 DPI 值，则无法使用该方法。

参数

scale:Number — 目标比例尺。
 
point:Point2D (default = null) — 目标中心点地图坐标。默认值为 null，即默认为 Map 的中心点。

另请参见

Layer.dpi
事件详细信息
CRSChange 事件
Event Object Type: flash.events.event

当地图控件坐标参考系 CRS 发生变化时触发该事件。

layerAdd 事件  
Event Object Type: com.supermap.web.events.MapEvent
MapEvent.type 属性 = com.supermap.web.events.MapEvent.LAYER_ADD

添加图层时触发该事件。

定义 layerAdd 事件的 type 属性值。
layerMove 事件  
Event Object Type: com.supermap.web.events.MapEvent
MapEvent.type 属性 = com.supermap.web.events.MapEvent.LAYER_REORDER

更改图层顺序时触发该事件。

layerRemove 事件  
Event Object Type: com.supermap.web.events.MapEvent
MapEvent.type 属性 = com.supermap.web.events.MapEvent.LAYER_REMOVE

删除图层时触发该事件。

定义 layerRemove 事件的 type 属性值。
layerRemoveAll 事件  
Event Object Type: com.supermap.web.events.MapEvent
MapEvent.type 属性 = com.supermap.web.events.MapEvent.LAYER_REMOVE_ALL

删除所有图层时触发该事件。

定义 layerRemoveAll 事件的 type 属性值。
load 事件  
Event Object Type: com.supermap.web.events.MapEvent
MapEvent.type 属性 = com.supermap.web.events.MapEvent.LOAD

当地图控件载入第一个图层完成时触发该事件。

定义 load 事件的 type 属性值。
mapClick 事件  
Event Object Type: com.supermap.web.events.MapMouseEvent
MapMouseEvent.type 属性 = com.supermap.web.events.MapMouseEvent.MAP_CLICK

单击地图时触发该事件。

定义 mapClick 事件的 type 属性值。
maxResolutionChange 事件  
Event Object Type: flash.events.Event

地图最大分辨率改变时触发该事件。

maxScaleChange 事件  
Event Object Type: flash.events.Event

地图最大比例尺改变时触发该事件。

minResolutionChange 事件  
Event Object Type: flash.events.Event

地图最小分辨率改变时触发该事件。

minScaleChange 事件  
Event Object Type: flash.events.Event

地图最小比例尺改变时触发该事件。

panEnd 事件  
Event Object Type: com.supermap.web.events.PanEvent
PanEvent.type 属性 = com.supermap.web.events.PanEvent.PAN_END

平移结束时触发该事件。

定义 panEnd 事件的 type 属性值。
panStart 事件  
Event Object Type: com.supermap.web.events.PanEvent
PanEvent.type 属性 = com.supermap.web.events.PanEvent.PAN_START

开始平移时触发该事件。

定义 panStart 事件的 type 属性值。
panUpdate 事件  
Event Object Type: com.supermap.web.events.PanEvent
PanEvent.type 属性 = com.supermap.web.events.PanEvent.PAN_UPDATE

平移更新时触发该事件。

定义 panUpdate 事件的 type 属性值。
resolutionsChange 事件  
Event Object Type: flash.events.Event

地图分辨率数组改变时触发该事件。

viewBoundsChange 事件  
Event Object Type: com.supermap.web.events.ViewBoundsEvent
ViewBoundsEvent.type 属性 = com.supermap.web.events.ViewBoundsEvent.VIEWBOUNDS_CHANGE

地图可视范围改变时触发该事件。

viewBoundsUpdate 事件  
Event Object Type: com.supermap.web.events.ViewBoundsEvent
ViewBoundsEvent.type 属性 = com.supermap.web.events.ViewBoundsEvent.VIEWBOUNDS_UPDATE

更新地图可视范围时触发该事件。

zoomEnd 事件  
Event Object Type: com.supermap.web.events.ZoomEvent
ZoomEvent.type 属性 = com.supermap.web.events.ZoomEvent.ZOOM_END

地图缩放结束时触发该事件。

定义 zoomEnd 事件的 type 属性值。
zoomStart 事件  
Event Object Type: com.supermap.web.events.ZoomEvent
ZoomEvent.type 属性 = com.supermap.web.events.ZoomEvent.ZOOM_START

地图缩放时触发该事件。

定义 zoomStart 事件的 type 属性值。
zoomUpdate 事件  
Event Object Type: com.supermap.web.events.ZoomEvent
ZoomEvent.type 属性 = com.supermap.web.events.ZoomEvent.ZOOM_UPDATE

地图缩放更新时触发该事件。

定义 zoomUpdate 事件的 type 属性值。




Wed Dec 23 2015, 12:01 AM +08:00