你现在的位置:首页 > PHP网站建设知识库 > google api > 正文

Google Maps API ActionScript 参考

Alpha 类

Alpha(不透明度)常数。这些常数的主要作用是使用能直接反映所选不透明值所具效果的名称提高代码的可读性。

字段概述

  • OPAQUE
  • PERCENT_0
  • PERCENT_10
  • PERCENT_100
  • PERCENT_20
  • PERCENT_30
  • PERCENT_40
  • PERCENT_50
  • PERCENT_60
  • PERCENT_70
  • PERCENT_80
  • PERCENT_90
  • UNSEEN

常数

名称 说明
OPAQUE 1.00  
PERCENT_0 0  
PERCENT_10 0.10  
PERCENT_100 1.00  
PERCENT_20 0.20  
PERCENT_30 0.30  
PERCENT_40 0.40  
PERCENT_50 0.50  
PERCENT_60 0.60  
PERCENT_70 0.70  
PERCENT_80 0.80  
PERCENT_90 0.90  
UNSEEN 0  

返回页首

Color 类

Color 类用于存储颜色,并提供在不同的颜色文本表示和颜色数值表示之间进行转换的方法。

字段概述

  • BLACK
  • BLUE
  • CYAN
  • DEFAULTLINK
  • GRAY1
  • GRAY10
  • GRAY11
  • GRAY12
  • GRAY13
  • GRAY14
  • GRAY15
  • GRAY2
  • GRAY3
  • GRAY4
  • GRAY5
  • GRAY6
  • GRAY7
  • GRAY8
  • GRAY9
  • GREEN
  • MAGENTA
  • RED
  • WHITE
  • YELLOW
  • b
  • g
  • r
  • rgb

构造函数概述

  • Color

方法概述

  • incRGB
  • setRGB
  • toHtml
  • toString

常数

名称 说明
BLACK 0x000000  
BLUE 0x0000ff  
CYAN 0x00ffff  
DEFAULTLINK 0x7777cc

用于“使用条款”链接的颜色。

GRAY1 0x101010  
GRAY10 0xa0a0a0  
GRAY11 0xb0b0b0  
GRAY12 0xc0c0c0  
GRAY13 0xd0d0d0  
GRAY14 0xe0e0e0  
GRAY15 0xf0f0f0  
GRAY2 0x202020  
GRAY3 0x303030  
GRAY4 0x404040  
GRAY5 0x505050  
GRAY6 0x606060  
GRAY7 0x707070  
GRAY8 0x808080  
GRAY9 0x909090  
GREEN 0x00ff00  
MAGENTA 0xff00ff  
RED 0xff0000  
WHITE 0xffffff  
YELLOW 0xffff00  

属性

名称 类型 说明
b Number

蓝色分量,范围为 [0,255]。

g Number

绿色分量,范围为 [0,255]。

r Number

红色分量,范围为 [0,255]。

rgb Number

以数值表示的颜色,例如 0x804020。

构造函数

Color(clr:Number)

通过数值构造颜色。

var col:Color = new Color(0x0000ff);  // blue
参数 类型 说明
clr Number  

静态方法

toHtml(color:Number): String

用于传回以 HTML 格式表示的颜色,例如“#321fba”。将数值限定在 [0x000000,0xffffff] 范围内。如果输入值是一个无效数值,则会传回用于黑色的编码。

var col:Color = new Color(0xff8020);
trace(col.toHtml());  // outputs "#ff8020"
参数 类型 说明
color Number

以 HTML 格式表示的颜色。

实例方法

incRGB(deltaR:Number, deltaG:Number, deltaB:Number): void

用于通过单独的增量值来增加此颜色的 R、G 和 B 分量。每种颜色分量均限定在有效范围内,即 [0,255]。

var col:Color = new Color(0xff0000);  // color is red
col.incRGB(0, 255, 0);  // color is now yellow
参数 类型 说明
deltaR Number

R 分量增量。

deltaG Number

G 分量增量。

deltaB Number

G 分量增量。

setRGB(compR:Number, compG:Number, compB:Number): void

用于通过 R、G 和 B 分量设置此颜色,这些分量都在 [0,255] 的范围内。

var col:Color = new Color(0);
col.setRGB(128, 64, 255);  // lilac
参数 类型 说明
compR Number

新 R 分量。

compG Number

新 G 分量。

compB Number

新 B 分量。

toString(): String

用于传回此颜色的字符串表示,例如“R:64/G:32/B:255”。

var col:Color = new Color(0xff8020);
trace(col.toString());  // outputs "R:255/G:128/B:32"

返回页首

Copyright 类

该类包含与以下信息:哪条版权消息适用于在缩放级别的指定范围内通过矩形指定的地图区域。只有在实现自定义地图类型或图块层时,才需要此对象。

构造函数概述

  • Copyright

方法概述

  • getBounds
  • getId
  • getMaxZoom
  • getMinZoom
  • getText
  • isSupplemental

构造函数

 

Copyright(id:String, bounds:LatLngBounds, minZoom:Number, text:String, opt_maxZoom?:Number, opt_isSupplemental?:Boolean)

用于构造涵盖地理范围以及缩放级别范围的 Copyright 实例,并指定要为此实例显示的 ID 和文本。

// Create two Copyright instances. Company A's data is used
// throughout all zoom levels over a region spanning 10 degrees of latitude
// and 40 degrees of longitude. Company B's data supplements this over a
// much smaller region at zoom levels 14 and higher.
var regionCopyright:Copyright = new Copyright(
    'my_tileset_0',
    new LatLngBounds(new LatLng(10, 20), new LatLng(20, 60)),
    'Company A',
    0);
var cityCopyright:Copyright = new Copyright(
    'my_tileset_1',
    new LatLngBounds(new LatLng(12, 20), new LatLng(13, 21)),
    'Company B',
    14,
    true);
参数 类型 说明
id String

唯一的 ID。

bounds LatLngBounds

此 Copyright 适用的地理范围。

minZoom Number

显示所用的最小缩放级别。

text String

Copyright 文本。

opt_maxZoom? Number

显示所用的最大缩放级别。

opt_isSupplemental? Boolean

表示此版权是否是对较为粗略的缩放级别中的版权的补充。您可以在粗略缩放级别上指定一个涵盖扩展区域的常规版权,然后将此标记设置为 true,以在较为精确的缩放级别上将更加详细的版权文本添加至此区域部分。或者,您可以将此标记保留为 false,然后在较为精确的缩放级别上指定整个文本即可。

实例方法

getBounds(): LatLngBounds

用于检索版权的空间范围。

var regionCopyright:Copyright = new Copyright(
    'my_tileset_0',
    new LatLngBounds(new LatLng(10, 20), new LatLng(20, 60)),
    'Company A',
    0);
trace(regionCopyright.getBounds());  // outputs "((10, 20), (20, 60))"

getId(): String

用于检索版权 ID。

getMaxZoom(): Number

用于检索适用于该版权的最大缩放级别。

getMinZoom(): Number

用于检索适用于该版权的最小缩放级别。

getText(): String

用于检索版权文本。

isSupplemental(): Boolean

如果此版权是对较为粗略的缩放级别中的版权信息的补充,则传回 true。如果此版权属于补充内容,则会将其添加至较为粗略的缩放级别中的版权信息。如果此版权不是补充内容,则此版权信息只包含自身。

返回页首

CopyrightCollection 类

CopyrightCollection 用于管理在自定义地图上显示的版权消息。如果您不实现自定义地图类型,则无需使用此类。版权模型集包含以下信息:在哪个缩放级别的地图上为哪一区域显示哪一版权。这对于显示异类数据的地图类型(如卫星地图类型)非常重要。

实现

  • ICopyrightCollection
  • flash.events.IEventDispatcher

构造函数概述

  • CopyrightCollection

方法概述

  • addCopyright
  • getCopyrightNotice
  • getCopyrights
  • getCopyrightsAtLatLng

构造函数

CopyrightCollection(opt_prefix?:String)

用于创建指定地图类型/规格的版权集合。

参数 类型 说明
opt_prefix? String

版权前缀(可选)。

实例方法

addCopyright(copyright:Copyright): Boolean

用于将指定的版权添加到集合中;如果该版权为新内容并且已添加,则传回 true,如果该版权为重复内容并被忽略,则传回 false。

参数 类型 说明
copyright Copyright

要添加的新版权。

getCopyrightNotice(bounds:LatLngBounds, zoom:Number): CopyrightNotice

传回指定可视区域的 CopyrightNotice 实例。

参数 类型 说明
bounds LatLngBounds

查询范围。

zoom Number

缩放级别。

getCopyrights(bounds:LatLngBounds, zoom:Number): Array

用于检索类型为 String 的元素数组,该数组构成了我们应为指定可视区域显示的版权文本。

参数 类型 说明
bounds LatLngBounds

查询范围。

zoom Number

缩放级别。

getCopyrightsAtLatLng(latLng:LatLng): Array

用于传回类型为 Copyright 的元素数组,该数组是与指定位置相关的版权。

参数 类型 说明
latLng LatLng

我们要获取其版权的点。

返回页首

CopyrightNotice 类

CopyrightNotice 用于存储代表要在地图上显示的版权文本的字符串数组,但也可以用于存储单一文本字符串。多个数据提供商的版权信息可能适用于地图上的某个区域:维护数组可提取单个提供商的文本。如果只希望获取一个复合文本字符串,请使用 toString 方法。您可能不需要亲自构造 CopyrightNotice,因为 ICopyrightCollection 提供了 getCopyrightNotice() 方法,该方法可传回此类的一个实例。

构造函数概述

  • CopyrightNotice

方法概述

  • getPrefix
  • getTexts
  • toString

构造函数

CopyrightNotice(prefix:String, copyrightTexts:Array)

通过文本前缀以及表示各个版权声明且类型为 String 的元素数组构造 CopyrightNotice。请注意,此类存储的是对此数组的引用,而不复制元素。

参数 类型 说明
prefix String

版权前缀。

copyrightTexts Array

每个版权的文本。

实例方法

getPrefix(): String

用于检索版权前缀。

getTexts(): Array

用于检索版权文本的数组。此数组中的每个元素类型均为 String。

toString(): String

传回一个字符串,此字符串由前缀后跟一系列文本数组元素组成。

var notice:CopyrightNotice = new CopyrightNotice(
    "Copyright",
    [ "Company A", "Company B" ]);
trace(notice.toString());  // outputs "Copyright Company A, CompanyB"

返回页首

InfoWindowOptions 类

InfoWindowOptions 类用于为信息窗口指定一组呈现参数。

字段概述

  • ALIGN_CENTER
  • ALIGN_LEFT
  • ALIGN_RIGHT
  • content
  • contentFormat
  • contentHTML
  • contentStyleSheet
  • cornerRadius
  • customCloseRect
  • customContent
  • customOffset
  • drawDefaultFrame
  • fillStyle
  • hasCloseButton
  • hasShadow
  • hasTail
  • height
  • padding
  • pointOffset
  • strokeStyle
  • tailAlign
  • tailHeight
  • tailOffset
  • tailWidth
  • title
  • titleFormat
  • titleHTML
  • titleStyleSheet
  • width

构造函数概述

  • InfoWindowOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

常数

名称 说明
ALIGN_CENTER 1  
ALIGN_LEFT 0  
ALIGN_RIGHT 2  

属性

名称 类型 说明
content String

信息窗口的纯文本内容。

contentFormat TextFormat

信息窗口的内容格式。

contentHTML String

信息窗口的 HTML 内容。

contentStyleSheet StyleSheet

信息窗口的内容样式表。

cornerRadius Object

一个数值,用于表示信息窗口圆角半径。

customCloseRect Rectangle

自定义封闭矩形。如果此属性不为 Null,则此参数会指定一个矩形区域,在此区域中点击鼠标可以关闭信息窗口。如果 customContent 属性也不为 Null,则此区域将不可见,但仍为活动区域。使用自定义内容时,您可以随意将鼠标侦听器附加到您自己的内容中,并可以使用其中一个侦听器关闭信息窗口;此属性提供了另一种方法。如果 customContent 属性为 Null,则 customCloseRect 属性可用于将关闭按钮从默认位置移动至其他位置。

customContent DisplayObject

显示用作信息窗口自定义内容的对象。如果此字段不为 Null,则 Google Maps API for Flash 库不会绘制任何内容,而是相对于信息窗口的锚点来定位自定义内容。

customOffset Point

自定义内容偏移。使用自定义内容时,此参数用于指定信息窗口的目标位置相对于 customContent 的对齐点的偏移。如果未指定 customContent 或 drawDefaultFrame 设置为 true,则此属性无效。

drawDefaultFrame Object

一个布尔值,用于表示是否应当在通过 customContent 属性指定的自定义内容四周绘制默认的信息窗口轮廓(包括默认的关闭按钮)。如果未指定自定义内容,则始终会绘制默认的信息窗口轮廓。

fillStyle FillStyle

信息窗口的填充样式。

hasCloseButton Object

一个布尔值,用于表示信息窗口是否具有关闭按钮。

hasShadow Object

一个布尔值,用于表示信息窗口是否具有阴影。

hasTail Object

一个布尔值,用于表示信息窗口是否具有弧尾。

height Object

一个数值,用于表示信息窗口的高度。

padding Object

一个数值,用于表示信息窗口的标题和内容四周所应用的填充。

pointOffset Point

弧尾点相对于信息窗口锚点的偏移。可使用此参数来制造信息窗口“浮动于底面之上”(pointOffset.y 的值为负)而不是触及它在地图上的 latLng 位置的效果。

strokeStyle StrokeStyle

信息窗口的笔触样式。

tailAlign Object

一个数值,用于指定弧尾对齐。将此值设置为以下任一常数:InfoWindowOptions.ALIGN_LEFT、InfoWindowOptions.ALIGN_CENTER 或 InfoWindowOptions.ALIGN_RIGHT。

tailHeight Object

一个数值,用于表示弧尾的高度。

tailOffset Object

一个数值,用于表示弧尾末端相对于信息窗口中点的水平偏移。

tailWidth Object

一个数值,用于表示弧尾的宽度。

title String

信息窗口的纯文本标题。

titleFormat TextFormat

信息窗口的标题格式。

titleHTML String

信息窗口的 HTML 标题。

titleStyleSheet StyleSheet

信息窗口的标题样式表。

width Object

一个数值,用于表示信息窗口的宽度。

构造函数

InfoWindowOptions(param?:Object)

用于构造 InfoWindowOptions 对象,可以选择通过一个对象对其进行初始化。

// Specifying all InfoWindowOptions properties.
var titleFormat:TextFormat = new TextFormat();
titleFormat.bold = true;
var titleStyleSheet:StyleSheet = new StyleSheet();
var h1:Object = {
  color: "#FFFF80",
  fontWeight: "bold" };
titleStyleSheet.setStyle("h1", h1);
var contentStyleSheet:StyleSheet = new StyleSheet();
var body:Object = {
  color: "#FF0080",
  fontStyle: "italic" };
contentStyleSheet.setStyle("body", body);
var contentFormat:TextFormat = new TextFormat("Arial", 10);
var options:InfoWindowOptions = new InfoWindowOptions({
  strokeStyle: {
    color: 0x987654
  },
  fillStyle: {
    color: 0x223344,
    alpha: 0.8
  },
  titleFormat: titleFormat,
  titleStyleSheet: titleStyleSheet,
  contentFormat: contentFormat,
  contentStyleSheet: contentStyleSheet,
  width: 200,
  cornerRadius: 12,
  padding: 10,
  hasCloseButton: true,
  hasTail: true,
  tailWidth: 20,
  tailHeight: 30,
  tailOffset: -12,
  tailAlign: InfoWindowOptions.ALIGN_LEFT,
  pointOffset: new Point(3, 8),
  hasShadow: true
});
参数 类型 说明
param? Object

包含用于新 InfoWindowOptions 对象的一组初始值的对象。这些字段为:strokeStyle:StrokeStyle fillStyle:FillStyle title:String titleHTML:String titleFormat:TextFormat titleStyleSheet:StyleSheet content:String contentHTML:String contentFormat:TextFormat contentStyleSheet:StyleSheet width:Object height:Object cornerRadius:Object padding:Object hasCloseButton:Object hasTail:Object tailWidth:Object tailHeight:Object tailOffset:Object tailAlign:Object pointOffset:Point hasShadow:Object

静态方法

getDefaultOptions(): InfoWindowOptions

检索代表适用于所有信息窗口的默认选项集的 InfoWindowOptions 实例。

// Initialization object corresponding to the initial defaults.
var titleStyleSheet:StyleSheet = new StyleSheet();
titleStyleSheet.setStyle("p", { fontFamily: "_sans" });
var contentStyleSheet:StyleSheet = new StyleSheet();
contentStyleSheet.setStyle("p", { fontFamily: "_sans" });
var initObject:Object = {
  strokeStyle: {
    thickness: 2,
    alpha: 1.0,
    color:Color.BLACK
  },
  fillStyle: {
    color: 0xffffff,
    alpha: 1.0
  },
  title: null,
  titleHTML: null,
  titleFormat: new TextFormat("_sans"),
  titleStyleSheet: titleStyleSheet,
  content: null,
  contentHTML: null,
  contentFormat: new TextFormat("_sans"),
  contentStyleSheet: contentStyleSheet,
  width: 200,
  height: null,
  cornerRadius: 5,
  padding: 0,
  hasCloseButton: true,
  hasTail: true,
  tailWidth: 20,
  tailHeight: 20,
  tailOffset: 0,
  tailAlign: InfoWindowOptions.ALIGN_LEFT,
  pointOffset: new Point(0, 0),
  hasShadow: true,
  customContent: null,
  customOffset: null,
  customCloseRect: null
}

setDefaultOptions(defaults:InfoWindowOptions): void

设置适用于所有信息窗口的默认选项集。也可通过调用 openInfoWindow 为信息窗口单独设置选项。这样的话,通过该调用指定的选项比默认选项的优先级要高。defaults 参数可指定信息窗口选项的完整集合或部分集合。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults InfoWindowOptions

信息窗口选项新的默认完整集合或部分集合。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

LatLng 类

LatLng 是以纬度和经度表示的地理坐标点。

请注意,尽管进行地图投影时通常将经度与地图的 x 坐标相关联,将纬度与 y 坐标相关联,但总是先写入纬度坐标,再写入经度坐标,这是制图的一种习惯。

另请注意,您不能修改 LatLng 的坐标。如果您想要计算另一个点,则必须创建一个新点。

字段概述

  • EARTH_RADIUS

构造函数概述

  • LatLng

方法概述

  • angleFrom
  • clone
  • distanceFrom
  • equals
  • fromRadians
  • fromUrlValue
  • lat
  • latRadians
  • lng
  • lngRadians
  • toString
  • toUrlValue
  • wrapLatLng

常数

名称 说明
EARTH_RADIUS 6378137

地球的赤道半径(以米为单位)。假设地球是一个完美的球体,只是近似。实际上,两极处的地球半径为 6357 公里,而赤道处为 6378 公里 - 之间有 0.3% 的差值。

构造函数

LatLng(lat:Number, lng:Number, opt_noCorrect?:Boolean)

用于构造 LatLng。如果 opt_noCorrect 为 false,则我们可以在国际日期变更线两侧适当地分布经度并在两极处固定纬度,以确保经度和纬度都有效。

经度的有效值范围是 [-180,180]。纬度的有效值范围是 [-90,90]。

// Construct three LatLng instances.
var sydney:LatLng = new LatLng(-33.8581, 151.2149);
var bound:LatLng = new LatLng(10, 190);  // longitude set to -170
var unbound:LatLng = new LatLng(10, 190, true);  // longitude set to 190
参数 类型 说明
lat Number

纬度。

lng Number

经度。

opt_noCorrect? Boolean

标记:请勿更正到有效范围内。

静态方法

fromRadians(lat:Number, lng:Number, opt_noCorrect?:Boolean): LatLng

通过弧度值来创建 latlng。

参数 类型 说明
lat Number

纬度(以弧度为单位)。

lng Number

经度(以弧度为单位)。

opt_noCorrect? Boolean

防止更正到有效范围内的标记。

fromUrlValue(value:String): LatLng

解析 "lat,lng" 形式的字符串并返回具有相应值的点,如果字符串无法成功解析,则返回 null

// Create a LatLng from a text string.
var location:LatLng = LatLng.fromUrlValue("-34,151");
参数 类型 说明
value String

要解析的“纬度,经度”字符串。

wrapLatLng(latLng:LatLng): LatLng

返回指定 LatLng 的副本 LatLng,但需将纬度值限定在 [-90, 90] 范围内,并将经度值限定在 [-180, 180] 范围内。

参数 类型 说明
latLng LatLng

未绑定的 LatLng 对象。

实例方法

angleFrom(other:LatLng): Number

用于传回此点与指定点之间的角度(弧度)。这也是单位球体上两点之间的距离。

// Calculate angle in radians between London and Paris.
var london:LatLng = new LatLng(51.53, -0.08);
var paris:LatLng = new LatLng(48.8, 2.33);
trace("angle: " + paris.angleFrom(london));
参数 类型 说明
other LatLng

其他 LatLng

clone(): LatLng

返回一个新 LatLng 对象,它是此对象的副本。

distanceFrom(other:LatLng, opt_radius?:Number): Number

传回从此点到指定点的距离值(以米为单位)。由于假设地球是一个球体,该距离的误差大约为 0.3%。

// Calculate distance in km between London and Sydney.
var london:LatLng = new LatLng(51.53, -0.08);
var sydney:LatLng = new LatLng(-34.0, 151.0);
trace("km: " + sydney.distanceFrom(london) / 1000);
参数 类型 说明
other LatLng

其他 LatLng

opt_radius? Number

行星的半径(默认为 EARTH_RADIUS)。

equals(other:LatLng): Boolean

测试此 LatLng 是否与其他指定的 LatLng 一致(允许数值有四舍五入误差)。

参数 类型 说明
other LatLng

要与之比较的 LatLng。

lat(): Number

用于传回纬度值(以度为单位)。

latRadians(): Number

用于传回纬度值(以弧度为单位)。

lng(): Number

用于传回经度值(以度为单位)。

lngRadians(): Number

用于传回经度值(以弧度为单位)。

toString(): String

返回此 LatLng 的字符串表示,例如“巴黎”的结果为 "48.8584, 2.2944"

toUrlValue(opt_precision?:Number): String

为此 LatLng 返回 "lat,lng" 形式的字符串。默认情况下,我们会将纬度/经度值四舍五入到小数点后 6 位。

精确度 近似误差
-1 1000 千米/700 英里
0 100 千米/70 英里
1 10 千米/7 英里
2 1 千米/0.7 英里
3 100 米/300 英尺
4 10 米/30 英尺
5 1 米/3 英尺
6 10 厘米/4 英寸
7 1 厘米(相当于 5 美分硬币的半径)

 

参数 类型 说明
opt_precision? Number

小数点之后的数位。

返回页首

LatLngBounds 类

在 Google 地球上用矩形划出的范围。即使从东北到西南(环绕地球的另一方式)的经度间隔会变得越来越小,该二维间隔也是定向的,即,从西南角一直延伸到东北角。可以使用 extend() 方法延伸这些范围以包含新点。

构造函数概述

  • LatLngBounds

方法概述

  • clone
  • containsBounds
  • containsLatLng
  • equals
  • extend
  • getCenter
  • getEast
  • getNorth
  • getNorthEast
  • getNorthWest
  • getSouth
  • getSouthEast
  • getSouthWest
  • getWest
  • intersects
  • isEmpty
  • isFullLat
  • isFullLng
  • isLargerThan
  • toSpan
  • toString
  • union

构造函数

LatLngBounds(opt_sw?:LatLng, opt_ne?:LatLng)

用于从两个 LatLng 实例(分别包含西南范围和东北范围)构造一个 LatLngBounds。LatLngBounds 实例代表以地理坐标表示的矩形,其中包含一个与 180 度子午线相交的矩形。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(10, 50),   // spans 1 degree latitude
    new LatLng(11, 52));  // and 2 degrees longitude
参数 类型 说明
opt_sw? LatLng

西南角(可选)。

opt_ne? LatLng

东北角(可选)。

实例方法

clone(): LatLngBounds

创建此实例的一个副本。

containsBounds(other:LatLngBounds): Boolean

如果此范围完全包含指定的范围,则传回 true。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(10, 50), new LatLng(20, 70));
trace(bounds.containsBounds(
    new LatLngBounds(
        new LatLng(11, 12), new LatLng(52, 68)));  // outputs true
参数 类型 说明
other LatLngBounds

包含的 LatLngBounds。

containsLatLng(point:LatLng): Boolean

如果此范围包含指定的纬度/经度,则传回 true。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(10, 50),
    new LatLng(20, 70));
trace(bounds.containsLatLng(new LatLng(15, 51)));  // outputs true
trace(bounds.containsLatLng(new LatLng(29, 51)));  // outputs false
参数 类型 说明
point LatLng

测试点。

equals(other:LatLngBounds): Boolean

如果此范围与指定的范围大小相同(允许数值有四舍五入误差),则传回 true。

参数 类型 说明
other LatLngBounds

要与之比较的 LatLngBounds。

extend(point:LatLng): void

延伸此范围以包含指定点。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(1, 5), new LatLng(2, 7));
bounds.extend(new LatLng(0, 9));
trace(bounds.toString());  // outputs "((0, 5), (2, 9))"
参数 类型 说明
point LatLng

要添加的点。

getCenter(): LatLng

计算该 LatLngBounds 的中心。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(10, 50),
    new LatLng(20, 70));
trace(bounds.getCenter());  // outputs "(15, 60)"

getEast(): Number

用于传回此范围的东经。

getNorth(): Number

用于传回此范围的北纬。

getNorthEast(): LatLng

用于传回此范围的东北角。

getNorthWest(): LatLng

用于传回此范围的西北角。

getSouth(): Number

用于传回此范围的南纬。

getSouthEast(): LatLng

用于传回此范围的东南角。

getSouthWest(): LatLng

用于传回此范围的西南角。

getWest(): Number

用于传回此范围的西经。

intersects(other:LatLngBounds): Boolean

如果此范围与另一范围共享任何点,则传回 true。

参数 类型 说明
other LatLngBounds

测试 LatLngBounds。

isEmpty(): Boolean

如果此范围为空,则传回 true。

isFullLat(): Boolean

如果此范围覆盖所有纬度,则传回 true。

isFullLng(): Boolean

如果此范围覆盖所有经度,则传回 true。

isLargerThan(other:LatLngBounds): Boolean

如果此范围大于(可以包含)另一范围,则传回 true。

参数 类型 说明
other LatLngBounds  

toSpan(): LatLng

将指定的地图范围转换为纬度/经度跨度。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(10, 50), new LatLng(20, 70));
trace(bounds.toSpan());  // outputs "(10, 20)"

toString(): String

将此 LatLngBounds 转换为字符串。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(1, 5),
    new LatLng(2, 7));
trace(bounds.toString());  // outputs "((1, 5), (2, 7))"

union(other:LatLngBounds): void

延伸此范围以包含此范围和指定范围的并集。

var bounds:LatLngBounds = new LatLngBounds(
    new LatLng(0, 0), new LatLng(1, 1));
bounds.union(
    new LatLngBounds(
        new LatLng(10, 20), new LatLng(15, 22)));
trace(bounds.toString());  // outputs "((0, 0), (15, 22))"
参数 类型 说明
other LatLngBounds

要合并的 LatLngBounds。

返回页首

Map 类

这是 Google Maps API for Flash 的主类。将 Map 实例化以创建一幅地图。

Map 包含许多用于全局配置的属性。需要特别注意的是,这些值仅在初始化期间使用。虽然日后可以将这些属性设置为不同的值,但这样做并不会对地图产生任何影响。

在将地图作为另一个显示对象的子对象进行添加之前,应当确保已将这些属性设置为正确的值。

此类别的属性包括:

  • countryCode
  • key
  • language
  • languages(仅限 AIR)
  • url(仅限 AIR)
  • version

实现

  • IMap

字段概述

  • MERCATOR_PROJECTION
  • countryCode
  • key
  • language
  • languages
  • overlayRaising
  • sensor
  • url
  • version

构造函数概述

  • Map

方法概述

  • addControl
  • addMapType
  • addOverlay
  • callLater
  • clearControls
  • clearOverlays
  • closeInfoWindow
  • continuousZoomEnabled
  • controlByKeyboardEnabled
  • crosshairsEnabled
  • delayCall
  • disableContinuousZoom
  • disableControlByKeyboard
  • disableCrosshairs
  • disableDragging
  • disableScrollWheelZoom
  • draggingEnabled
  • enableContinuousZoom
  • enableControlByKeyboard
  • enableCrosshairs
  • enableDragging
  • enableScrollWheelZoom
  • fromLatLngToPoint
  • fromLatLngToViewport
  • fromPointToLatLng
  • fromViewportToLatLng
  • getBoundsZoomLevel
  • getCenter
  • getCurrentMapType
  • getDisplayObject
  • getDoubleClickMode
  • getImplementationVersion
  • getInterfaceVersion
  • getLatLngBounds
  • getMapTypes
  • getMaxZoomLevel
  • getMinZoomLevel
  • getOptions
  • getPaneManager
  • getPrintableBitmap
  • getProjection
  • getSize
  • getZoom
  • isLoaded
  • openInfoWindow
  • panBy
  • panTo
  • removeControl
  • removeMapType
  • removeOverlay
  • returnToSavedPosition
  • savePosition
  • scrollWheelZoomEnabled
  • setCenter
  • setDoubleClickMode
  • setInitOptions
  • setMapType
  • setSize
  • setZoom
  • unload
  • zoomIn
  • zoomOut

属性

名称 类型 说明
MERCATOR_PROJECTION IProjection

用于检索墨卡托投影。

countryCode String

所需的地图国家/地区代码。如果设置此属性,则会提供默认用于地址解析和路线查询的国家/地区代码。然而在两个实例中,默认代码均可能会在单独查询时被覆盖。

key String

地图密钥。

language String

所需的地图语言。请注意,我们通常不建议您设置此属性。如果将其保留为 null,则地图将会从用户的浏览器设置中选择要使用的语言。在设置此属性之前,您可以先尝试更改浏览器的语言偏好设置,查看您的地图对不同国家/地区的用户将会怎样显示。只有在您确定所有用户都将使用某一种语言与您的地图进行交互时,您才能显式地设置此属性。这将覆盖按钮标签、地址解析和路线查询所使用的语言。

languages String

(仅限 AIR)设置用户的首选语言。

overlayRaising Boolean

将此属性设置为 true 时,可在鼠标悬停时提升叠加层。如果启用了此属性,那么将鼠标悬停在支持鼠标悬停事件的叠加层上(目前只有标记支持)会将此叠加层置于顶层。默认情况下已启用提升叠加层功能。

sensor String

地图传感器属性,可能的值为 "false" 或 "true"

现在要使用 Google Maps API,您需要指明自己的应用程序是否是使用传感器(如 GPS 定位器)来确定用户所处位置的。

url String

在 AIR 应用程序中使用的网址参数。

version String

所需的地图库版本。

构造函数

Map()

构造函数。在运行此构造函数时,尚未初始化任何可绑定的变量。直到被添加至此阶段后,我们才会执行基于这些变量的操作。

实例方法

addControl(control:IControl): void

注册一个新控件。在收到 MAP_READY 事件之前可调用此控件。

public class MyMap extends Map {
  public function MyMap() {
    super();
    addEventListener(MapEvent.MAP_READY, onMapReady);
    addControl(new MapTypeControl());
  }
}
参数 类型 说明
control IControl

要注册的新控件。

addMapType(newMapType:IMapType): void

注册一个新的地图类型。

参数 类型 说明
newMapType IMapType

要注册的新地图类型。

addOverlay(overlay:IOverlay): void

向地图添加叠加层。

var marker:Marker = new Marker(
    new LatLng(48.858842, 2.346997),
    new MarkerOptions({ fillRGB: 0x004000,
                        name: "Paris, France",
                        description: "City on the Seine" }));
map.addOverlay(marker);
参数 类型 说明
overlay IOverlay

要添加到地图中的叠加层。

callLater(call:Function): void

参数 类型 说明
call Function  

clearControls(): void

从地图中删除所有控件。

clearOverlays(): void

从地图中删除所有叠加层。

closeInfoWindow(): Boolean

关闭信息窗口。

continuousZoomEnabled(): Boolean

检查是否启用了连续缩放。

controlByKeyboardEnabled(): Boolean

检查是否启用了键盘控制。

crosshairsEnabled(): Boolean

检查是否启用了中心十字准线。

delayCall(call:Function): void

将方法调用推迟到下一帧。

参数 类型 说明
call Function

要在下一帧中调用的方法。

disableContinuousZoom(): void

禁用连续平滑缩放。

disableControlByKeyboard(): void

禁用键盘控制。

disableCrosshairs(): void

禁用中心十字准线。

disableDragging(): void

禁用地图拖动。

disableScrollWheelZoom(): void

禁用使用鼠标滚轮缩放。

draggingEnabled(): Boolean

检查是否启用了地图拖动。

enableContinuousZoom(): void

启用连续平滑缩放。

enableControlByKeyboard(): void

启用键盘控制。

enableCrosshairs(): void

启用中心十字准线。

enableDragging(): void

启用地图拖动。

enableScrollWheelZoom(): void

启用使用鼠标滚轮缩放。

fromLatLngToPoint(latLng:LatLng, opt_zoom?:Number): Point

传回指定的纬度、经度和缩放的 x、y 坐标,该坐标是相对于地图投影的原点而言(该原点位于指定缩放级别的地图左上方图块的左上角)。

参数 类型 说明
latLng LatLng

地图上的 latLng 位置。

opt_zoom? Number

目标缩放级别(默认为当前缩放级别)

fromLatLngToViewport(latLng:LatLng, opt_disablewrap?:Boolean): Point

传回地图可视区域坐标系中指定的 latLng 位置的像素坐标([0,0] 位于地图对象的左上角)。

参数 类型 说明
latLng LatLng

地图上该点的 LatLng 坐标。

opt_disablewrap? Boolean

是否禁用了“将地图经度限制在 +180/-180 度的范围内”。

对于此参数的两个值,该调用会返回两个相同的还是不同的像素坐标,则取决于地图的当前中心与目标位置之间的最短路径是否穿过 +180/-180 度的经度范围。

例如,当前地图中心位于澳大利亚悉尼 [LatLng(-33.857, 151.215)],而传递给此调用的位置为美国旧金山 [LatLng(37.779, -122.420)],则该调用会对 opt_disablewrap 参数的两个值返回两个不同的像素坐标。

默认情况下(将 opt_disablewrap 设置为 false),地图经度会限制在 +180/-180 度的范围内,从而返回的像素坐标将会位于地图当前中心的右侧(选择从悉尼到旧金山之间穿越太平洋的较短路径)。

如果禁用了处理地图经度功能(将 opt_disablewrap 设置为 true),则由调用返回的像素坐标将会位于当前中心的左侧(选择从悉尼到旧金山之间穿越印度洋和大西洋的较长路径)。

如果从地图的当前中心到目标位置之间的较短路径不穿过 +180/-180 度经线(例如,如果地图的当前中心在澳大利亚悉尼,而目标位置在日本东京),则该调用对于 opt_disablewrap 参数的两个值所返回的值是相同的。

fromPointToLatLng(pos:Point, opt_zoom?:Number, opt_nowrap?:Boolean): LatLng

传回指定的 x、y 和缩放的“纬度,经度”坐标。这些坐标相对于地图投影的原点(位于指定缩放级别的地图的左上图块的左上角)。

参数 类型 说明
pos Point

点的 x、y 坐标

opt_zoom? Number

目标缩放级别(默认为当前缩放级别)

opt_nowrap? Boolean

不处理 [-180, 180] 范围以外的经度

fromViewportToLatLng(pos:Point, opt_nowrap?:Boolean): LatLng

传回地图可视区域(位于地图对象的左上角)中指定的坐标点的纬度和经度。

参数 类型 说明
pos Point

地图可视区域中的坐标。

opt_nowrap? Boolean

不处理 [-180, 180] 范围以外的经度

getBoundsZoomLevel(bounds:LatLngBounds): Number

传回指定矩形区域在地图视图中适合的最高分辨率缩放级别。缩放级别要按当前选中的地图类型计算。

参数 类型 说明
bounds LatLngBounds

要显示的范围。

getCenter(): LatLng

用于检索地图视图控件中心的坐标。

getCurrentMapType(): IMapType

用于检索当前地图类型。

getDisplayObject(): DisplayObject

用于检索代表地图的显示对象。

getDoubleClickMode(): Number

用于进入鼠标双击模式。

getImplementationVersion(): String

用于获取实现库 SWF 的版本。

getInterfaceVersion(): String

用于检索客户端接口的版本。

getLatLngBounds(): LatLngBounds

用于传回地图视图的可视矩形区域(以地理坐标表示)。

getMapTypes(): Array

用于检索该位置可用的地图类型列表。

getMaxZoomLevel(opt_mapType?:IMapType, opt_point?:LatLng): Number

用于检索最大的缩放级别。

参数 类型 说明
opt_mapType? IMapType

用于确定最大分辨率的地图类型。

opt_point? LatLng

要获取其最大缩放级别的点。

getMinZoomLevel(opt_mapType?:IMapType, opt_point?:LatLng): Number

用于检索最小缩放级别。

参数 类型 说明
opt_mapType? IMapType

用于确定最小分辨率的地图类型。

opt_point? LatLng

要获取其最小缩放级别的点。

getOptions(): MapOptions

用于检索地图使用的完整选项集。请注意,由于 MapOptions 仅在地图初始化时使用,因此该方法仅允许检索原始设置,而不支持重新配置地图。

getPaneManager(): IPaneManager

用于检索地图的窗格管理器。

getPrintableBitmap(): Bitmap

用于返回 Bitmap 实例,其中包含待打印地图的快照图像。

地图本身可能包含从多个域载入的内容。此方法要求通过 crossdomain.xml 文件授予域 maps.googleapis.com 访问地图上所有显示内容的权限。例如,如果地图使用的某个自定义图块层包含从 http://www.thirdpartymap.com/path/tile_x_y_z.png 形式的网址载入的图块,请在 http://www.thirdpartymap.com/path/crossdomain.xml 处放置一个 crossdomain.xml 文件。使用 Security.loadPolicyFile() 加载此文件,并且在加载图块图像时,确保使用 checkPolicyFile 属性为 true 的 LoaderContext 实例。

请注意,通过在上述网址中使用 path/,仅能授予 maps.googleapis.com 访问 http://www.thirdpartymap.com/path/ 下内容的特许权限,而非访问www.thirdpartymap.com 上所有内容的权限。

getProjection(): IProjection

用于传回应用于地图的投影。

getSize(): Point

用于检索地图视图大小。

getZoom(): Number

用于检索地图缩放级别。

isLoaded(): Boolean

检查是否已初始化地图。

openInfoWindow(latlng:LatLng, options?:InfoWindowOptions): IInfoWindow

在指定点处打开一个简单的信息窗口。

参数 类型 说明
latlng LatLng

用于打开信息窗口的点。

options? InfoWindowOptions

信息窗口选项。

panBy(distance:Point, animate?:Boolean): void

以动画方式平移指定的距离(以像素为单位)。

参数 类型 说明
distance Point

距离(以像素为单位)

animate? Boolean

是否能以动画方式显示更改。

panTo(latLng:LatLng): void

将地图的中心位置更改为指定的位置。如果该位置已经在当前的地图视图中显示,则会以平滑动画的方式移动到中心点。

参数 类型 说明
latLng LatLng

新中心点的坐标。

removeControl(control:IControl): void

从地图中删除控件。如果未将控件添加至地图,则此操作无效。

参数 类型 说明
control IControl

要删除的控件。

removeMapType(oldMapType:IMapType): void

要取消注册的地图类型。

参数 类型 说明
oldMapType IMapType

要取消注册的地图类型。

removeOverlay(overlay:IOverlay): void

从地图中删除一个叠加层。

参数 类型 说明
overlay IOverlay

要从地图中删除的叠加层。

returnToSavedPosition(): void

将地图传回至保存位置。

savePosition(): void

存储当前的地图位置和缩放级别,以便日后通过 returnToSavedPosition 重新调用。

scrollWheelZoomEnabled(): Boolean

检查是否启用了滚轮缩放。

setCenter(latLng:LatLng, opt_zoom?:Number, opt_mapType?:IMapType): void

更改地图的中心位置。

参数 类型 说明
latLng LatLng

新中心点的坐标。

opt_zoom? Number

新的缩放级别。

opt_mapType? IMapType

新的地图类型。

setDoubleClickMode(val:Number): void

用于设置鼠标双击模式。

参数 类型 说明
val Number

鼠标双击模式(MapAction 常数之一)。

setInitOptions(options:MapOptions): void

设置用于初始化地图的选项。应仅在处理 MapEvent.MAP_PREINITIALIZE 事件时才调用此方法。在此事件之前,要用于 MapOptions 属性的值可能未经过配置。在此事件之后,地图初始化将会越过使用了 MapOptions 属性的点。

参数 类型 说明
options MapOptions

覆盖了默认值的 MapOptions 实例,用于初始化地图;或者如果值为 null,则只能使用默认选项。

setMapType(mapType:IMapType): void

用于更改地图的地图类型。

参数 类型 说明
mapType IMapType

地图类型。

setSize(newSize:Point): void

用于设置地图视图的大小。

参数 类型 说明
newSize Point

地图的新视图大小。

setZoom(level:Number, opt_doContinuousZoom?:Boolean): void

用于更改地图视图控件的缩放级别。

参数 类型 说明
level Number

新的缩放级别。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

unload(): void

从地图的父项中删除地图,并尝试卸载该地图来释放与其相关联的内存空间。调用此方法后,便不能再使用该地图对象。

zoomIn(opt_latlng?:LatLng, opt_doCenter?:Boolean, opt_doContinuousZoom?:Boolean): void

如果可以,将地图放大一个缩放级别。

参数 类型 说明
opt_latlng? LatLng

如果设置了此参数,我们将围绕此点进行缩放。否则,我们将围绕地图的中心进行放大。

opt_doCenter? Boolean

如果此参数为 true,那么我们还希望以 opt_latlng 为中心。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

zoomOut(opt_latlng?:LatLng, opt_doContinuousZoom?:Boolean): void

如果可以,将地图缩小一个缩放级别。

参数 类型 说明
opt_latlng? LatLng

如果设置了此参数,我们将围绕此点进行缩放。否则,我们将围绕地图的中心进行缩小。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

返回页首

Map 类3D

这是支持 3D 地图的 Maps API(Flash 版)的主类。如果您要使用地图及其内容的透视视图或正交视图,则应使地图基于此类,而非 com.google.maps.Map

Map 包含许多用于全局配置的属性。需要特别注意的是,这些值仅在初始化期间使用。虽然日后可以将这些属性设置为不同的值,但这样做并不会对地图产生任何影响。

在将地图作为另一个显示对象的子对象进行添加之前,应当确保已将这些属性设置为正确的值。

此类别的属性包括:

  • countryCode
  • key
  • language
  • languages(仅限 AIR)
  • url(仅限 AIR)
  • version

实现

  • IMap3D

字段概述

  • camera
  • dragMode
  • viewMode

构造函数概述

  • Map3D

方法概述

  • cancelFlyTo
  • flyTo
  • getAttitude
  • setAttitude
  • setInitOptions

属性

名称 类型 说明
camera ICamera

该镜头提供了多种方法,用于在三维查看模式下转换坐标。

dragMode int

在地图上使用的拖动模式。此属性的可接受值为 MapAction.DRAGMODE_LATLNGMapAction.DRAGMODE_PITCH 和 MapAction.DRAGMODE_YAW

默认情况下,在分派 MapMouseEvent.DRAG_START 和 MapMouseEvent.DRAG_STEP 事件之前,系统会根据 CTRL 和 SHIFT 键盘组合键的状态立即自动更新拖动模式。如果按下 SHIFT 键,则系统会将拖动模式设置为 MapAction.DRAGMODE_MAP_YAW_PITCH,如果按下 CTRL 键,则将其设置为MapAction.DRAGMODE_CAMERA_YAW_PITCH;如果两键都未按下,则将其设置为 MapAction.DRAGMODE_LATLNG

我们建议您保留此行为。这与 Google 地球中的行为一致。但是,如果要进行更改,则应当同时向 MapMouseEvent.DRAG_START 和MapMouseEvent.DRAG_STEP 附加监听器。然后,您就可以在自己的处理程序中根据相关参数(包括鼠标位置和键盘组合键状态)来设置相应的地图拖动模式了。

请注意,由于拖动模式可以在处理 MapMouseEvent.DRAG_STEP 之前和处理过程中立即更改,因此用户无需释放鼠标按钮即可开始使用新的拖动模式。如果在拖动操作过程中更改拖动模式,则在该操作以新的拖动模式继续进行前,您将会收到 DRAG_STOP 和 DRAG_START 事件。

viewMode int

应用到地图的查看模式。此属性的可接受值为 View.VIEWMODE_2DView.VIEWMODE_PERSPECTIVE 和 View.VIEWMODE_ORTHOGONAL

构造函数

Map3D()

构建 Map3D 实例。在运行此构造函数时,尚未初始化任何可绑定的变量。直到被添加至此阶段后,我们才会执行基于这些变量的操作。

实例方法

cancelFlyTo(): void

取消任何通过调用 flyTo() 而启动的地图动作,并触发对 MapEvent.FLY_TO_CANCELED 和 MapEvent.FLY_TO_DONE 的分派。

如果没有进行飞行,则调用此方法不会产生任何效果。

flyTo(center:LatLng, zoom?:Number, attitude?:Attitude, duration?:Number): void

在指定的时间段内,更改地图的中心位置、缩放比例和空间方位角。如果希望更改立即生效,可将时间段设置为 0。

如果飞行路线比较复杂,您可以在上一次调用 flyTo() 的动画完成之前对其重复调用。每个飞行段都将加入队列,并依次执行。如果队列中存在多个飞行段,则系统会使用三次样条函数对镜头位置和空间方位角进行插值处理。

默认情况下,用户可以在飞行过程中与地图进行交互,此操作不会终止飞行(在用户释放控件之后,飞行将会沿剩余的飞行段继续飞行)。不过,如果您希望取消剩余的飞行部分,则可使用 cancelFlyTo() 方法。

飞行终止时(不管是否由于被取消而终止)将会分派 MapEvent.FLY_TO_DONE

参数 类型 说明
center LatLng

新地图中心的坐标。

zoom? Number

新的地图缩放比例。

attitude? Attitude

新的地图空间方位角。

duration? Number

更改发生之前的持续时间,以秒为单位。

getAttitude(): Attitude

获取地图空间方位角。在三维模式下,它将会控制用户查看地图的方位。

setAttitude(value:Attitude): void

设置地图空间方位角。在三维模式下,它将会控制用户查看地图的方位。

参数 类型 说明
value Attitude

新的地图空间方位角。

setInitOptions(options:MapOptions): void

设置用于初始化地图的选项。默认情况下,系统会将 3D 地图的 controlByKeyboard 设置为 true(开发人员可根据需要覆盖该值)。此处的实现是将新的默认值与传入的选项合并,此操作是必须的,因为 Map.options 属性是私有属性,无法直接进行访问。

参数 类型 说明
options MapOptions

覆盖了默认值的 MapOptions 实例,用于初始化地图;或者如果值为 null,则只能使用默认选项。

返回页首

MapAction 类

这是用于标识地图操作的常数。

字段概述

  • ACTION_NOTHING
  • ACTION_PAN
  • ACTION_PAN_ZOOM_IN
  • ACTION_ZOOM_IN
  • DRAGMODE_CAMERA_YAW_PITCH
  • DRAGMODE_LATLNG
  • DRAGMODE_MAP_YAW_PITCH
  • DRAGMODE_PITCH
  • DRAGMODE_YAW

常数

名称 说明
ACTION_NOTHING 3

无操作。

ACTION_PAN 0

平移操作。

ACTION_PAN_ZOOM_IN 2

平移和放大操作。

ACTION_ZOOM_IN 1

放大操作。

DRAGMODE_CAMERA_YAW_PITCH 4

鼠标拖动更改三维地图上镜头偏角和倾斜度。

DRAGMODE_LATLNG 0

鼠标拖动更改地图纬度和经度(地图中心)。

DRAGMODE_MAP_YAW_PITCH 3

鼠标拖动更改三维地图的偏角和倾斜度。

DRAGMODE_PITCH 1

鼠标拖动更改三维地图倾斜度。

DRAGMODE_YAW 2

鼠标拖动更改三维地图偏角。

返回页首

MapAttitudeEvent 类

每当地图空间方位角发生变化时,都会将 MapAttitudeEvent 对象分派到事件流之中。

字段概述

  • ATTITUDE_CHANGE_END
  • ATTITUDE_CHANGE_START
  • ATTITUDE_CHANGE_STEP
  • attitude

构造函数概述

  • MapAttitudeEvent

常数

名称 说明
ATTITUDE_CHANGE_END mapevent_attitudechangeend

当地图视图变化结束时会触发此事件。

ATTITUDE_CHANGE_START mapevent_attitudechangestart

地图空间方位角开始更改时会触发此事件。

ATTITUDE_CHANGE_STEP mapevent_attitudechangestep

更改地图空间方位角的过程中会反复触发此事件。

属性

名称 类型 说明
attitude Attitude

地图的空间方位角。

构造函数

MapAttitudeEvent(type:String, attitude:Attitude, bubbles?:Boolean, cancellable?:Boolean)

用于创建 MapMoveEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapMoveEvent.type 进行访问。

attitude Attitude

地图的 latLng。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

MapEvent 类

每当特定于地图的事件发生时,都会将 MapEvent 对象分派到事件流之中。地图事件可能由地图对象本身或其元素(即 overlays/infowindows 等)来分派。

字段概述

  • CONTROL_ADDED
  • CONTROL_REMOVED
  • COPYRIGHTS_UPDATED
  • FLY_TO_CANCELED
  • FLY_TO_DONE
  • INFOWINDOW_CLOSED
  • INFOWINDOW_CLOSING
  • INFOWINDOW_OPENED
  • MAPTYPE_ADDED
  • MAPTYPE_CHANGED
  • MAPTYPE_REMOVED
  • MAPTYPE_STYLE_CHANGED
  • MAP_PREINITIALIZE
  • MAP_READY
  • OVERLAY_BEFORE_REMOVED
  • OVERLAY_MOVED
  • OVERLAY_REMOVED
  • SIZE_CHANGED
  • TILES_LOADED
  • TILES_LOADED_PENDING
  • VIEW_CHANGED
  • VISIBILITY_CHANGED
  • feature

构造函数概述

  • MapEvent

常数

名称 说明
CONTROL_ADDED mapevent_controladded

当控件添加到地图中时,会在地图上触发此事件。

CONTROL_REMOVED mapevent_controlremoved

当控件从地图中删除时,会在地图上触发此事件。

COPYRIGHTS_UPDATED mapevent_copyrightsupdated

当更新应该显示在地图上的版权时,会触发此事件。此事件由 MapType 和 CopyrightCollection 对象进行分派。

FLY_TO_CANCELED mapevent_flytocanceled

通过调用 Map3D.cancelFlyTo() 取消因调用 Map3D.flyTo() 而生成的地图动作时,会触发此事件。只有三维地图才支持 flyyTo() 和 flyToCancel() 方法。

FLY_TO_DONE mapevent_flytodone

通过调用 Map3D.flyTo() 而生成的地图动作完成时,会触发此事件。目前只有三维地图才支持flyTo() 方法。

INFOWINDOW_CLOSED mapevent_infowindowclosed

当关闭信息窗口时会触发此事件。在此事件之前会触发 INFOWINDOW_CLOSING 事件。如果再次调用 openInfoWindow() 在其他点上重新打开当前已打开的信息窗口,则会依次触发 INFOWINDOW_CLOSING、INFOWINDOW_CLOSED 和 INFOWINDOW_OPENED 事件。

INFOWINDOW_CLOSING mapevent_infowindowclosing

在关闭信息窗口之前会触发此事件。

INFOWINDOW_OPENED mapevent_infowindowopened

在打开信息窗口时会触发此事件。

MAPTYPE_ADDED mapevent_maptypeadded

在新的 MapType 添加到地图中后会触发此事件。请注意,这是一个有别于 MAPTYPE_CHANGED 的事件,MAPTYPE_CHANGED 表示地图类型已发生更改,而不仅仅是地图目前可以支持这一新的地图类型。

MAPTYPE_CHANGED maptypechanged

在选择其他地图类型时会触发此事件。

MAPTYPE_REMOVED mapevent_maptyperemoved

从地图中删除 MapType 后会触发此事件。

MAPTYPE_STYLE_CHANGED mapevent_maptypestylechanged

在样式化地图类型的样式发生更改时会触发此事件。

MAP_PREINITIALIZE mapevent_mappreinitialize

在初始化地图之前会立即触发此事件。此事件表示在地图上调用 setInitOptions(...) 的准确时间,它会传递 MapOptions 实例,该实例包含第一次显示地图时地图应该具有的选项。

MAP_READY mapevent_mapready

当地图初始化完成并且 isLoaded() 将传回 true 时会触发此事件。这意味着位置、缩放比例以及地图类型都已全部初始化,但图块图像仍可能处于载入当中。

OVERLAY_BEFORE_REMOVED mapevent_overlaybeforeremoved

在要从地图中删除叠加层时会触发此事件。

OVERLAY_MOVED mapevent_overlaymoved

在更改叠加层位置时会触发此事件。此事件当前仅应用于标记,并在拖动操作结束或调用 setLatLng() 后才触发此事件。

OVERLAY_REMOVED mapevent_overlayremoved

从地图中删除单个叠加层之后会触发此事件。开发人员可使用该事件对叠加层实例执行最终的清理。

SIZE_CHANGED mapevent_sizechanged

更改了地图大小后会触发此事件。

TILES_LOADED mapevent_tilesloaded

在所有的可见目标图块加载完毕时会触发此事件。

目标图块是理想情况下用于呈现地图的图块。目标图块和所有图块之间的区别在显示三维地图时尤为明显。目标图块组成要用于呈现地图的图块集。但是,在这些图块尚未加载完毕时,我们会使用分辨率较低或较高的图块来代替它们,从而避免呈现的地图上出现缺口。

请注意,在正常平移或缩放地图时,系统会反复分派此事件。

如果要检测地图图块的首次加载时间,可在处理 MapEvent.MAP_PREINITIALIZE 时对该事件附加一个监听器。另外,您还需要在该函数中设置初始地图视图(包括中心位置、缩放级别、地图类型等,如果显示的是 3D 地图,还包括空间方位角),因为后续的 TILES_LOADED 事件将会应用到该初始地图视图中。

此事件由地图和 TileLayerOverlay 实例进行分派。

TILES_LOADED_PENDING mapevent_tilesloadedpending

此事件是 MapEvent.TILES_LOADED 的伴随事件,表示系统已开始加载新的图块,且将会在所有图块加载完毕后分派 MapEvent.TILES_LOADED

如果反复载入更多图块,则可在分派 MapEvent.TILES_LOADED 之前多次分派MapEvent.TILES_LOADED_PENDING。如果要使用超时,以便在未成功载入图块时执行相应的操作,则可以利用 API 行为,灵活选择从第一个还是从最后一个图块载入时开始计时。

VIEW_CHANGED mapevent_viewchanged

地图视图更改时会触发此事件。

VISIBILITY_CHANGED mapevent_visibilitychanged

当叠加层的可视性发生改变(从可视变为隐藏,反之亦然)时会触发此事件。

属性

名称 类型 说明
feature Object

该事件所指的对象(如 MapEvent.MAPTYPE_ADDED 事件的 IMapType 实例或 MapEvent.CONTROL_REMOVED 的 IControl 实例)。

构造函数

MapEvent(type:String, feature:Object, bubbles?:Boolean, cancellable?:Boolean)

用于创建 Event 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapEvent.type 进行访问。

feature Object

与事件相关的地图功能(叠加层、控件或地图本身)。可能为地图本身(在此情况下,由于地图将成为目标,因此目标和功能将不同)或功能(在此情况下,功能字段将与目标匹配)分派 MapEvent。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

MapMouseEvent 类

每当特定于地图或其叠加层的与鼠标相关的事件发生时,都会将 MapMouseEvent 对象分派到事件流之中。

字段概述

  • CLICK
  • DOUBLE_CLICK
  • DRAG_END
  • DRAG_START
  • DRAG_STEP
  • MOUSE_DOWN
  • MOUSE_MOVE
  • MOUSE_UP
  • ROLL_OUT
  • ROLL_OVER
  • altKey
  • ctrlKey
  • latLng
  • shiftKey

构造函数概述

  • MapMouseEvent

常数

名称 说明
CLICK mapevent_click

当使用鼠标点击地图时会触发此事件。如果是在可点击的叠加层(如标记、多边形等)上执行点击操作,那么还会在叠加层上触发事件。

DOUBLE_CLICK mapevent_doubleclick

在地图上执行双击操作时会触发此事件。请注意,如果在标记或其他可点击的叠加层上执行双击操作,则不会触发此事件。

DRAG_END mapevent_dragend

当用户停止拖动地图时会触发此事件。

DRAG_START mapevent_dragstart

当用户开始拖动地图时会触发此事件。

DRAG_STEP mapevent_dragstep

当用户拖动地图时会反复触发此事件。

MOUSE_DOWN mapevent_mousedown

当用户在地图上按鼠标按钮时会触发此事件。

MOUSE_MOVE mapevent_mousemove

当鼠标在地图上移动时会触发此事件。

MOUSE_UP mapevent_mouseup

当用户在地图上释放鼠标按钮时会触发此事件。

ROLL_OUT mapevent_rollout

当用户将鼠标滚动到地图以外时会触发此事件。

ROLL_OVER mapevent_rollover

当用户在地图上滚动鼠标时会触发此事件。

属性

名称 类型 说明
altKey Boolean

是否已按下 Alt 键。

ctrlKey Boolean

是否已按下 Ctrl 键。

latLng LatLng

发生 MapMouseEvent 所在的 LatLng。

shiftKey Boolean

是否已按下 Shift 键。

构造函数

 

MapMouseEvent(type:String, feature:Object, latLng:LatLng, bubbles?:Boolean, cancellable?:Boolean, ctrlKey?:Boolean, altKey?:Boolean, shiftKey?:Boolean)

用于创建 MapMouseEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapEvent.type 进行访问。

feature Object

与事件相关的地图功能(如叠加层、控件或地图本身)。对于 MapMouseEvent,将与事件目标相匹配。

latLng LatLng

地图的 latLng。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

ctrlKey? Boolean  
altKey? Boolean  
shiftKey? Boolean  

返回页首

MapMoveEvent 类

每当地图视图发生变化时,都会将 MapMoveEvent 对象分派到事件流之中。

字段概述

  • MOVE_END
  • MOVE_START
  • MOVE_STEP
  • latLng

构造函数概述

  • MapMoveEvent

常数

名称 说明
MOVE_END mapevent_moveend

当地图视图变化结束时会触发此事件。

MOVE_START mapevent_movestart

当地图视图开始变化时会触发此事件。该事件可由拖动操作(在这种情况下,还会触发 MapMouseEvent.DRAG_START 事件)或改变地图视图的方法调用触发。

MOVE_STEP mapevent_movestep

当地图视图正在发生改变时会反复触发此事件。如果变化是由拖动操作引起的,那么还会生成 MapMouseEvent.DRAG_STEP 事件。

属性

名称 类型 说明
latLng LatLng

发生 MapMoveEvent 所在的 LatLng。

构造函数

MapMoveEvent(type:String, latLng:LatLng, bubbles?:Boolean, cancellable?:Boolean)

用于创建 MapMoveEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapMoveEvent.type 进行访问。

latLng LatLng

地图的 latLng。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

MapOptions 类

MapOptions 用于指定地图初始化的一组参数。请注意,何时应该使用 MapOptions 具有非常明确的时间,这正是处理 MapEvent.MAP_PREINITIALIZE 事件的时间。

字段概述

  • attitude
  • backgroundFillStyle
  • center
  • continuousZoom
  • controlByKeyboard
  • crosshairs
  • crosshairsStrokeStyle
  • doubleClickMode
  • dragging
  • mapType
  • mapTypes
  • mouseClickRange
  • overlayRaising
  • scrollWheelZoom
  • viewMode
  • zoom

构造函数概述

  • MapOptions

方法概述

  • toString

属性

名称 类型 说明
attitude Attitude

三维查看模式的镜头方位角。如果您要使用此属性,需要将 Map3D 实例用作地图。如果使用标准的 Map 实例,则会忽略此属性。

backgroundFillStyle FillStyle

地图背景的填充样式。

center LatLng

初始的地图中心点。

continuousZoom Object

一个布尔值,用于表示地图是否最初使用连续的缩放操作。

controlByKeyboard Object

一个布尔值,用于表示地图是否最初会由键盘来控制。

crosshairs Object

一个布尔值,用于表示地图是否最初具有十字线。

crosshairsStrokeStyle StrokeStyle

十字线的笔触样式。

doubleClickMode Object

一个数值,用于指定最初地图的双击模式。

dragging Object

一个布尔值,用于表示地图是否最初支持拖动操作。

mapType IMapType

初始地图类型。请注意,如果此类型为 Null,那么将使用 Google 的默认地图类型。如果您希望覆盖此选择,请设置此类型。

mapTypes Array

最初填充地图的初始地图类型。请注意,如果此类型为 Null,那么将使用 Google 的默认地图类型列表。如果您希望覆盖此设置,请设置此类型。

mouseClickRange Object

一个数值,用于表示允许鼠标从 MouseEvent.MOUSE_DOWN 事件(在任何待定的 MapMouseEvent.CLICK 和 MapMouseEvent.DOUBLE_CLICK 事件取消之前)发生的位置移动的最大像素数。通常情况下,并不希望在拖动地图后发生 MapMouseEvent.CLICK 事件,因为此属性会强制执行此事件。

overlayRaising Object

一个布尔值,用于表示是否最初会启用叠加层位置自动提升。

scrollWheelZoom Object

一个布尔值,用于表示地图最初是否提供了滚轮缩放。

viewMode Object

用于表示地图查看模式的整型值。如果您要使用此属性,需要将 Map3D 实例用作地图。如果使用标准的 Map 实例,则会忽略此属性。支持的查看模式有 View.VIEWMODE_2DView.VIEWMODE_PERSPECTIVE 和 View.VIEWMODE_ORTHOGONAL

zoom Object

一个数值,用于指定最初地图缩放级别。

构造函数

MapOptions(param?:Object)

用于构造新的 MapOptions 对象,可以选择通过某个对象对其进行初始化。

// Creating a MapOptions instance that corresponds to the default
// configuration for creating a map.
var options:MapOptions = new MapOptions({
  backgroundFillStyle: {
    alpha: Alpha.OPAQUE,
    color: Color.GRAY14
  },
  crosshairs: false,
  crosshairsStrokeStyle: {
    thickness: 1,
    color: Color.BLACK,
    alpha: 1,
    pixelHinting: false
  },
  controlByKeyboard: false,
  scrollWheelZoom: false,
  overlayRaising: true,
  doubleClickMode: MapAction.ACTION_PAN_ZOOM_IN,
  dragging: true,
  continuousZoom: false,
  mapType: null,
  mapTypes: null,
  center: new LatLng(0, 0),
  zoom: 1
  mouseClickRange: 2
});
参数 类型 说明
param? Object

一个初始化对象,它包含 MapOptions 实例的一组初始值。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

MapType 类

用于定义 Map 的地图类型。地图类型是图块层、地图投影、图块大小和各种其他设置(如链接颜色和版权)的集合。

实现

  • IMapType
  • flash.events.IEventDispatcher

字段概述

  • DEFAULT_MAP_TYPES
  • HYBRID_MAP_TYPE
  • NORMAL_MAP_TYPE
  • PHYSICAL_MAP_TYPE
  • SATELLITE_MAP_TYPE

构造函数概述

  • MapType

方法概述

  • getAlt
  • getBoundsZoomLevel
  • getCopyrights
  • getErrorMessage
  • getLinkColor
  • getMaxResolutionOverride
  • getMaximumResolution
  • getMinimumResolution
  • getName
  • getProjection
  • getRadius
  • getSpanZoomLevel
  • getTextColor
  • getTileLayers
  • getTileSize
  • getUrlArg
  • setMaxResolutionOverride

属性

名称 类型 说明
DEFAULT_MAP_TYPES Array

提供对默认地图类型列表的访问。

HYBRID_MAP_TYPE IMapType

提供对混合地图类型的访问

NORMAL_MAP_TYPE IMapType

提供对普通地图类型的访问

PHYSICAL_MAP_TYPE IMapType

提供对物理地图类型的访问

SATELLITE_MAP_TYPE IMapType

提供对卫星地图类型的访问

构造函数

MapType(tileLayers:Array, projection:IProjection, name:String, options?:MapTypeOptions)

用于创建 MapType 对象的实例(针对自定义地图类型)。

参数 类型 说明
tileLayers Array

地图的图块层。

projection IProjection

地图投影。

name String

地图名称。

options? MapTypeOptions

地图类型选项。

实例方法

getAlt(): String

用于传回用户将鼠标悬停在控件(允许选择此地图类型)上时所显示的提示文本。MapTypeControl 就是这样一个控件。

getBoundsZoomLevel(bounds:LatLngBounds, viewSize:Point): Number

用于传回在指定像素大小的地图中显示指定的纬度/经度范围所需的最大分辨率缩放级别。

参数 类型 说明
bounds LatLngBounds

要显示的范围。

viewSize Point

可视区域大小。

getCopyrights(bounds:LatLngBounds, zoom:Number): Array

用于传回指定范围和缩放级别的版权声明数组。此数组中的每个元素类型均为 CopyrightNotice。

参数 类型 说明
bounds LatLngBounds

当前可视区域。

zoom Number

当前缩放级别。

getErrorMessage(): String

如果未能下载图块,则会传回要显示的文本。

getLinkColor(): Number

如果控件在地图上方显示一个链接,则会传回我们应该使用的颜色。例如,版权控件中的“使用条款”链接会使用此颜色。

getMaxResolutionOverride(): Number

用于传回最大的分辨率覆盖。

getMaximumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最大分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最大分辨率。如果未指定 opt_point,则会传回全局最大分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点。

getMinimumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最小分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最小分辨率。如果未指定 opt_point,则会传回全局最小分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点(忽略)。

getName(opt_short?:Boolean): String

用于检索地图类型名称。

参数 类型 说明
opt_short? Boolean

用于传回缩写名称。

getProjection(): IProjection

用于检索地图类型投影。

getRadius(): Number

用于传回定义了此地图类型的星球半径。

getSpanZoomLevel(center:LatLng, span:LatLng, viewSize:Point): Number

用于传回显示指定中心点的指定纬度/经度跨度所需的最大分辨率缩放级别。

参数 类型 说明
center LatLng

可视区域中心。

span LatLng

可视区域跨度。

viewSize Point

可视区域大小(以像素为单位)。

getTextColor(): Number

如果控件为文本,则会传回相应的颜色来显示文本。例如,版权控件使用此颜色。

getTileLayers(): Array

按照显示图块层时应使用的 z 顺序,获取此地图类型的图块层的列表。请注意,构建完 MapType 实例之后,不能使用该方法更改显示的图块层。如果您想要显示另一组图层,则需要创建新的 MapType。

getTileSize(): Number

用于获取此地图类型的图块大小。所有预定义地图类型图块大小均为 256x256 像素:对于这些地图类型,此函数会传回 256。

getUrlArg(): String

用于传回一个字符串,可能会将此字符串用作网址参数来识别当前地图视图的永久链接中的此地图类型。目前,此参数仅在内部使用。请注意,如果在构建自定义地图类型时使用了任何内置图块层,则返回的值将会取决于这组图块层,而不是取决于由开发人员提供的任何值。

setMaxResolutionOverride(maxResolution:Number): void

设置最大分辨率覆盖,以便在此数值大于地图类型向我们报告的最大分辨率时,我们使用此数值来替换。它表示在 ZoomControl 滚动条上显示的缩放级别数量。

参数 类型 说明
maxResolution Number

最大分辨率覆盖的设置值。

返回页首

MapTypeOptions 类

MapTypeOptions 类用于为地图类型指定一组参数。

字段概述

  • alt
  • errorMessage
  • linkColor
  • maxResolution
  • minResolution
  • radius
  • shortName
  • textColor
  • tileSize
  • urlArg

构造函数概述

  • MapTypeOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

属性

名称 类型 说明
alt String

替代文本。

errorMessage String

错误消息。

linkColor Object

一个数值,用于指定链接颜色。

maxResolution Object

一个数值,用于指定此地图类型的最大缩放级别。

minResolution Object

一个数值,用于指定此地图类型的最小缩放级别。

radius Object

一个数值,用于指定地图类型的半径(用米来度量)。

shortName String

地图类型的短名称。

textColor Object

一个数值,用于指定文本颜色。

tileSize Object

一个数值,用于指定图块大小。

urlArg String

地图类型的网址参数。

构造函数

MapTypeOptions(param?:Object)

用于构造新的 MapTypeOptions 对象,可以选择通过某个对象对其进行初始化。

var options:MapTypeOptions = new MapTypeOptions({
  shortName: "sea",
  urlArg: "s",
  maxResolution: 16,
  minResolution: 4,
  tileSize: 256,
  textColor: Color.BLACK,
  linkColor: Color.RED,
  errorMessage: "This sea tile could not be loaded",
  alt: "Sea images",
  radius: 51118000
});
参数 类型 说明
param? Object

一个初始化对象,它包含 MapTypeOptions 实例的一组初始值。

静态方法

getDefaultOptions(): MapTypeOptions

用于检索 MapTypeOptions 实例,该实例表示应用于所有地图类型的默认选项集。

// Initialization object corresponding to the initial defaults.
{ shortName: new String(""),
  urlArg: new String("c"),
  tileSize: 256,
  textColor: Color.BLACK,
  linkColor: Color.DEFAULTLINK,
  errorMessage: new String(""),
  alt: new String(""),
  radius: LatLng.EARTH_RADIUS
}

setDefaultOptions(defaults:MapTypeOptions): void

用于设置在创建新地图类型时应用的默认选项集。还可以为每个单独的地图类型设置选项。如果是这样的话,为单个地图类型指定的选项的优先级将高于默认选项。defaults 参数可以指定完整或部分地图类型选项集。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults MapTypeOptions

新的默认完整或部分地图类型选项集。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

MapZoomEvent 类

每当放大或缩小地图时,都会将 MapMouseEvent 对象分派到事件流之中。

字段概述

  • CONTINUOUS_ZOOM_END
  • CONTINUOUS_ZOOM_START
  • CONTINUOUS_ZOOM_STEP
  • ZOOM_CHANGED
  • ZOOM_RANGE_CHANGED
  • zoomLevel

构造函数概述

  • MapZoomEvent

常数

名称 说明
CONTINUOUS_ZOOM_END mapevent_continuouszoomend

当连续缩放地图操作结束时会触发此事件。随后会触发 ZOOM_CHANGED 事件。

CONTINUOUS_ZOOM_START mapevent_continuouszoomstart

当连续缩放地图操作开始时会触发此事件。

CONTINUOUS_ZOOM_STEP mapevent_continuouszoomstep

当地图正在执行连续缩放操作时会反复触发此事件。

ZOOM_CHANGED mapevent_zoomchanged

地图进行缩放后会触发此事件。

ZOOM_RANGE_CHANGED mapevent_zoomrangechanged

当地图的可用缩放范围发生改变时会触发此事件。若某一区域的可用缩放级别相对于其原先的缩放级别发生改变,或者以编程的方式更改了该区域的缩放范围,则将地图平移到该区域时会触发此事件。对应的 MapZoomEvent 的 zoomLevel 属性将指示地图的当前缩放级别(不一定已发生改变)。要获取地图的新的最小和最大缩放级别,请调用 Map.getMinZoomLevel() 和 Map.getMaxZoomLevel() 方法。

属性

名称 类型 说明
zoomLevel Number

地图的当前缩放级别。

构造函数

MapZoomEvent(type:String, zoomLevel:Number, bubbles?:Boolean, cancellable?:Boolean)

用于创建 MapZoomEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型。

zoomLevel Number

地图缩放级别。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

PaneId 类

用于标识地图上的窗格的常数。请注意,当每个常数都具有数值时,将不依赖于实际值来管理窗格顺序。

字段概述

  • PANE_FLOAT
  • PANE_MAP
  • PANE_MARKER
  • PANE_OVERLAYS

常数

名称 说明
PANE_FLOAT 7

保留浮动内容的窗格,是信息窗口的默认窗格。

PANE_MAP 0

最底部的地图窗格,直接位于地图的顶端。

PANE_MARKER 4

标记窗格,是标记的默认窗格。

PANE_OVERLAYS 1

叠加层窗格,是折线、多边形和地面叠加层的默认窗格。

返回页首

ProjectionBase 类

ProjectionBase 是用于创建自定义投影的抽象基类。可以为该类创建子类,并使用每种方法来创建地图的自定义投影。

实现

  • IProjection

构造函数概述

  • ProjectionBase

方法概述

  • fromLatLngToPixel
  • fromPixelToLatLng
  • getWrapWidth
  • tileCheckRange

构造函数

ProjectionBase()

用于构造 ProjectionBase 实例。

实例方法

fromLatLngToPixel(latLng:LatLng, zoom:Number): Point

用于传回与指定的地理位置和缩放级别相对应的地图像素坐标。

参数 类型 说明
latLng LatLng

地理位置。

zoom Number

缩放级别。

fromPixelToLatLng(pixel:Point, zoom:Number, opt_nowrap?:Boolean): LatLng

用于传回与指定的地图像素坐标和缩放级别相对应的地理位置。

参数 类型 说明
pixel Point

地图坐标(以像素为单位)

zoom Number

缩放级别

opt_nowrap? Boolean

请不要将经度限定在 [-180,180] 以外

getWrapWidth(zoom:Number): Number

传回 x 方向上的地图周期性:即在多少像素数后,地图会重复其本身(因为地图环绕 Google 地球)。默认情况下,会传回无限值,即地图不重复其本身。地图将使用此参数来计算叠加层在地图视图上的位置,这些地图视图包含多个 Google 地球副本(这通常仅在低缩放级别时出现)。

参数 类型 说明
zoom Number

缩放级别。

tileCheckRange(tile:Point, zoom:Number, tileSize:Number): Boolean

测试图块索引是否在地图类型的有效范围内(地图会在此范围以外显示空图块)。请注意,如果地图包含多个 Google 地球,那么此函数可能会修改图块索引以指向其他相同图块实例。

参数 类型 说明
tile Point

图块坐标。

zoom Number

缩放级别。

tileSize Number

此图块的大小。

返回页首

StyledMapType 类

StyledMapType 类用于为地图定义样式化地图类型。

实现

  • IStyledMapType
  • flash.events.IEventDispatcher

构造函数概述

  • StyledMapType

方法概述

  • getAlt
  • getBoundsZoomLevel
  • getCopyrights
  • getErrorMessage
  • getLinkColor
  • getMaxResolutionOverride
  • getMaximumResolution
  • getMinimumResolution
  • getName
  • getProjection
  • getRadius
  • getSpanZoomLevel
  • getStyle
  • getTextColor
  • getTileLayers
  • getTileSize
  • getUrlArg
  • setMaxResolutionOverride
  • setStyle

构造函数

StyledMapType(style:Array, options?:StyledMapTypeOptions)

用于创建 StyledMapType 对象的实例。

参数 类型 说明
style Array

MapTypeStyle 元素的数组。每个元素都会按顺序应用。您也可以使用包含相应字段的非类型化对象的数组。有关采取,请参见setStyle()

options? StyledMapTypeOptions

适用于样式化地图的选项。

实例方法

getAlt(): String

用于传回用户将鼠标悬停在控件(允许选择此地图类型)上时所显示的提示文本。MapTypeControl 就是这样一个控件。

getBoundsZoomLevel(bounds:LatLngBounds, viewSize:Point): Number

用于传回在指定像素大小的地图中显示指定的纬度/经度范围所需的最大分辨率缩放级别。

参数 类型 说明
bounds LatLngBounds

要显示的范围。

viewSize Point

可视区域大小。

getCopyrights(bounds:LatLngBounds, zoom:Number): Array

用于传回指定范围和缩放级别的版权声明数组。此数组中的每个元素类型均为 CopyrightNotice。

参数 类型 说明
bounds LatLngBounds

当前可视区域。

zoom Number

当前缩放级别。

getErrorMessage(): String

如果未能下载图块,则会传回要显示的文本。

getLinkColor(): Number

如果控件在地图上方显示一个链接,则会传回我们应该使用的颜色。例如,版权控件中的“使用条款”链接会使用此颜色。

getMaxResolutionOverride(): Number

用于传回最大的分辨率覆盖。

getMaximumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最大分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最大分辨率。如果未指定 opt_point,则会传回全局最大分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点。

getMinimumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最小分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最小分辨率。如果未指定 opt_point,则会传回全局最小分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点(忽略)。

getName(opt_short?:Boolean): String

用于检索地图类型名称。

参数 类型 说明
opt_short? Boolean

用于传回缩写名称。

getProjection(): IProjection

用于检索地图类型投影。

getRadius(): Number

用于传回定义了此地图类型的星球半径。

getSpanZoomLevel(center:LatLng, span:LatLng, viewSize:Point): Number

用于传回显示指定中心点的指定纬度/经度跨度所需的最大分辨率缩放级别。

参数 类型 说明
center LatLng

可视区域中心。

span LatLng

可视区域跨度。

viewSize Point

可视区域大小(以像素为单位)。

getStyle(): Array

用于获取地图类型样式。

getTextColor(): Number

如果控件为文本,则会传回相应的颜色来显示文本。例如,版权控件使用此颜色。

getTileLayers(): Array

按照显示图块层时应使用的 z 顺序,获取此地图类型的图块层的列表。请注意,构建完 MapType 实例之后,不能使用该方法更改显示的图块层。如果您想要显示另一组图层,则需要创建新的 MapType。

getTileSize(): Number

用于获取此地图类型的图块大小。所有预定义地图类型图块大小均为 256x256 像素:对于这些地图类型,此函数会传回 256。

getUrlArg(): String

用于传回一个字符串,可能会将此字符串用作网址参数来识别当前地图视图的永久链接中的此地图类型。目前,此参数仅在内部使用。请注意,如果在构建自定义地图类型时使用了任何内置图块层,则返回的值将会取决于这组图块层,而不是取决于由开发人员提供的任何值。

setMaxResolutionOverride(maxResolution:Number): void

设置最大分辨率覆盖,以便在此数值大于地图类型向我们报告的最大分辨率时,我们使用此数值来替换。它表示在 ZoomControl 滚动条上显示的缩放级别数量。

参数 类型 说明
maxResolution Number

最大分辨率覆盖的设置值。

setStyle(style:Array): void

用于设置地图类型样式。

// Setting the style using an array of MapTypeStyle instance.
styledMapType.setStyle([
    new MapTypeStyle(MapTypeStyleFeatureType.ALL,
                     MapTypeStyleElementType.ALL,
                     [MapTypeStyleRule.saturation(-20)]),
    new MapTypeStyle(MapTypeStyleFeatureType.ROAD,
                     MapTypeStyleElementType.GEOMETRY,
                     [MapTypeStyleRule.hue(0xff0000)])]);
    ]);
// Setting the style using an array of objects.
styledMapType.setStyle([
    {elementType: 'all',
     featureType: 'all',
     stylers: [{saturation: -20}]},
    {elementType: 'geometry',
     featureType: 'road',
     stylers: [{hue: 0xff0000}]}]);
参数 类型 说明
style Array

MapTypeStyle 实例的数组。您也可以传入包含相应字段的非类型化对象的数组:通常,将样式指定为对象常量会更加简明。

返回页首

StyledMapTypeOptions 类

StyledMapTypeOptions 类用于为样式化地图类型指定一组参数。

字段概述

  • alt
  • baseMapType
  • maxResolution
  • minResolution
  • name

构造函数概述

  • StyledMapTypeOptions

方法概述

  • toString

属性

名称 类型 说明
alt String

替代文本。

baseMapType Object

一个 IStyledMapType 实例,其样式应当用作定义 StyledMapType 实例样式的基础样式。MapTypeStyle 规则将会附加到基础样式。系统会在创建 StyledMapType 实例时捕获该基础样式,因此对该基础样式的后续更改不会影响派生的样式。

maxResolution Object

一个数值,用于指定此地图类型的最大缩放级别。

minResolution Object

一个数值,用于指定此地图类型的最小缩放级别。

name String

要在地图类型控件中显示的名称。

构造函数

StyledMapTypeOptions(param?:Object)

用于构建新的 StyledMapTypeOptions 对象,您可以选择通过某个对象对其进行初始化。

var options:StyledMapTypeOptions = new StyledMapTypeOptions({
  minResolution: 4,
  maxResolution: 16,
  name: "Highlighted roads",
  alt: "Roads"
});
参数 类型 说明
param? Object

一个初始化对象,其中包含 StyledMapTypeOptions 实例的一组初始值。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

TileLayerBase 类

TileLayerBase 是用于提供地图的自定义图块层的抽象基类。可以为该类创建子类,并覆盖相应的方法来创建自定义图块层。您必须覆盖 loadTile() 方法。如果您在应用过程中需要这样做,则可以随意覆盖其他方法。

实现

  • ITileLayer

构造函数概述

  • TileLayerBase

方法概述

  • getAlpha
  • getCopyrightCollection
  • getMapType
  • getMaxResolution
  • getMinResolution
  • loadTile
  • setMapType

构造函数

 

TileLayerBase(copyrightCollection:ICopyrightCollection, minResolution?:Number, maxResolution?:Number, alpha?:Number)

用于构造 TileLayerBase 实例。仅应该从扩展 TileLayerBase 的类的构造函数中调用此构造函数。

package com.mycompany.maps {
  import com.google.maps.TileLayerBase;
  public class MyTileLayer extends TileLayerBase {
    public function MyTileLayer(copyrightCollection:ICopyrightCollection,
                                minResolution:Number = NaN,
                                maxResolution:Number = NaN,
                                alpha:Number=Alpha.OPAQUE) {
      super(copyrightCollection, minResolution, maxResolution, alpha);
    }
  }
  //  :
  // Overridden methods to implement a custom tile layer
  //  :
}
参数 类型 说明
copyrightCollection ICopyrightCollection  
minResolution? Number  
maxResolution? Number  
alpha? Number  

实例方法

getAlpha(): Number

用于传回此图块层的不透明度(Alpha 值)。getAlpha() 值的范围为 [0,1]。值为 0 时表示图块层不可见(完全透明);值为 1 时表示完全不透明。

getCopyrightCollection(): ICopyrightCollection

用于检索负责处理此图块层版权的版权模型集。

getMapType(): IMapType

用于检索此图块层的地图类型。

getMaxResolution(): Number

用于传回最细粒度的缩放级别。

getMinResolution(): Number

用于传回最粗粒度的缩放级别。

loadTile(tilePos:Point, zoom:Number): DisplayObject

在指定的缩放级别创建并载入图块 (x, y)。您必须覆盖此图块,并传回保留自定义图块的 DisplayObject。不要在子类的实现中调用此方法的基类版本。

public override function loadTile(
    tilePos:Point, zoom:Number):DisplayObject {
  var loader:Loader = new Loader();
  var tileUrl:String = "http://tiles.mycompany.com/tile_" +
      tilePos.x + "_" + tilePos.y + "_" + zoom + ".png";
  loader.load(new URLRequest(tileUrl));
  return loader;
}
参数 类型 说明
tilePos Point

图块坐标。

zoom Number

图块缩放。

setMapType(mapType:IMapType): void

用于设置此图块层的地图类型。

参数 类型 说明
mapType IMapType

地图类型。

返回页首

View 类

View 类提供用于三维地图的常量。

字段概述

  • VIEWMODE_2D
  • VIEWMODE_ORTHOGONAL
  • VIEWMODE_PERSPECTIVE

常数

名称 说明
VIEWMODE_2D 0

传统的二维地图视图。

VIEWMODE_ORTHOGONAL 2

三维正交地图视图。这是 VIEW_PERSPECTIVE 的备用选择,用于提供有限的深度提示,但没有根据距离缩放的功能。如果使用 Flash 9,VIEW_ORTHOGONAL 将会带来更快的呈现速度。

VIEWMODE_PERSPECTIVE 1

三维透视地图视图。在 Flash 9 中透视投影需要大量的计算,而 Flash 10 本身已支持透视投影。如果使用 Flash 9,则可以考虑使用能带来更快呈现速度的 VIEW_ORTHOGONAL。

返回页首

ControlBase 类

控件的基类。可以为该类创建子类以提供地图的自定义控件。

实现

  • IControl

字段概述

  • map
  • position

构造函数概述

  • ControlBase

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

属性

名称 类型 说明
map IMap  
position ControlPosition  

构造函数

ControlBase(position:ControlPosition)

在相对于地图指定角的位置构造控件。

// MyControl is a developer-created sub-class of ControlBase.
var control:MyControl = new MyControl(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件相对于地图的位置。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件本身)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置控件操作所在的地图实例。通常通过调用 Map.addControl() 自动调用该实例。

参数 类型 说明
map IMap

地图界面

setControlPosition(controlPosition:ControlPosition): void

用于更改控件位置。

参数 类型 说明
controlPosition ControlPosition

控件的新位置。

返回页首

ControlPosition 类

ControlPosition 用于说明控件在地图视图中的位置。它会指定地图视图的哪个角被视为参照点以及 X 和 Y 与此角形成的间距偏移。

字段概述

  • ANCHOR_BOTTOM_LEFT
  • ANCHOR_BOTTOM_RIGHT
  • ANCHOR_TOP_LEFT
  • ANCHOR_TOP_RIGHT
  • AUTO_ALIGN_NONE
  • AUTO_ALIGN_X
  • AUTO_ALIGN_Y

构造函数概述

  • ControlPosition

方法概述

  • equals
  • getAnchor
  • getAutoAlign
  • getOffsetX
  • getOffsetY
  • toString

常数

名称 说明
ANCHOR_BOTTOM_LEFT 0x20

控件将锚定在地图的左下角。

ANCHOR_BOTTOM_RIGHT 0x21

控件将锚定在地图的右下角。

ANCHOR_TOP_LEFT 0

控件将锚定在地图的左上角。

ANCHOR_TOP_RIGHT 1

控件将锚定在地图的右上角。

AUTO_ALIGN_NONE 0

控件不会自动对齐。

AUTO_ALIGN_X 1

控件会自动水平对齐,以避免彼此重叠。

AUTO_ALIGN_Y 2

控件会自动垂直对齐,以避免彼此重叠。

构造函数

ControlPosition(anchor:Number, opt_paddingX?:Number, opt_paddingY?:Number, opt_autoAlign?:uint)

通过相对于指定地图角的偏移来构造 ControlPosition。

// Create a ControlPosition instance to anchor a control 16 pixels
// left of and 10 pixels below the top-right corner of the map.
var position:ControlPosition = new ControlPosition(
  ControlPosition.ANCHOR_TOP_RIGHT, 16, 10);
参数 类型 说明
anchor Number

锚点类型。

opt_paddingX? Number

水平间距(默认为 0)。

opt_paddingY? Number

垂直间距(如果不同于水平间距)。

opt_autoAlign? uint

设置是否自动对齐控件。

实例方法

equals(other:ControlPosition): Boolean

测试是否与另一个 ControlPosition 相同。

参数 类型 说明
other ControlPosition

要进行比较的 ControlPosition。

getAnchor(): Number

检索锚点标识符。

// Test whether a position is anchored to the map's bottom-left
// corner.
if (position.getAnchor()==ControlPosition.ANCHOR_BOTTOM_LEFT)
  trace("Positioned relative to the map's bottom-left corner.");

getAutoAlign(): uint

检索自动对齐类型。

getOffsetX(): Number

检索水平偏移。

getOffsetY(): Number

检索垂直偏移。

toString(): String

位置对象的字符串表示。

返回页首

MapTypeControl 类

MapTypeControl 提供一个控件,用于通过按钮在受支持的地图类型之间进行选择和切换。在构造控件时,当前附加到地图中的所有地图类型均可使用控件。默认情况下,地图支持 MapType.DEFAULT_MAP_TYPES 集,还可以通过 Map.addMapType() 显式添加其他地图类型。

实现

  • IControl

构造函数概述

  • MapTypeControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

构造函数

MapTypeControl(options?:MapTypeControlOptions)

用于构造 MapTypeControl 对象。

参数 类型 说明
options? MapTypeControlOptions

地图类型的控件选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

MapTypeControlOptions 类

MapTypeControlOptions 类用于为地图类型控件指定选项集。

字段概述

  • ALIGN_HORIZONTALLY
  • ALIGN_VERTICALLY
  • buttonAlignment
  • buttonSize
  • buttonSpacing
  • buttonStyle
  • position

构造函数概述

  • MapTypeControlOptions

方法概述

  • toString

常数

名称 说明
ALIGN_HORIZONTALLY 0

水平对齐按钮

ALIGN_VERTICALLY 1

垂直对齐按钮

属性

名称 类型 说明
buttonAlignment Object

一个数值,用于指定按钮的对齐方式(MapTypeControlOptions.ALIGN_HORIZONTALLY 或 MapTypeControlOptions.ALIGN_VERTICALLY)。

buttonSize Point

按钮大小。

buttonSpacing Point

按钮间距。这是一个点,您可以在水平和垂直方向布置按钮,使用相应的坐标来设置水平和垂直方向的按钮间距。

buttonStyle ButtonStyle

按钮样式。

position ControlPosition

控件在地图上的位置。

构造函数

MapTypeControlOptions(param?:Object)

用于构造 MapTypeControlOptions 对象,可以选择通过某个对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{ buttonSize: new Point(67, 19),
  buttonStyle: new ButtonStyle({
  }),
  buttonSpacing: new Point(0, 0),
  buttonAlignment: MapTypeControlOptions.ALIGN_HORIZONTALLY,
  position: new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 10)
}

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

NavigationControl 类

NavigationControl 可让用户更改地图的各项导航参数,包括缩放级别、中心位置和空间方位角(如果是三维地图)。

实现

  • IControl

构造函数概述

  • NavigationControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

构造函数

NavigationControl(options?:NavigationControlOptions)

构建 NavigationControl 对象。

参数 类型 说明
options? NavigationControlOptions

NavigationControl 控件选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

NavigationControlOptions 类

NavigationControlOptions 用于为导航控件指定一组选项。

字段概述

  • hasScrollTrack
  • position

构造函数概述

  • NavigationControlOptions

方法概述

  • toString

属性

名称 类型 说明
hasScrollTrack Object

一个布尔值,用于指定是否具有滚动条底。

position ControlPosition

控件在地图上的位置。

构造函数

NavigationControlOptions(param?:Object)

用于构建 NavigationControlOptions 的实例,可选择通过一个常规对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{
  position: new ControlPosition(ControlPosition.ANCHOR_TOP_LEFT, 10),
  hasScrollTrack: true,
}

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

OverviewMapControl 类

OverviewMapControl 会在包含地图的角上显示一个小型地图,并显示一个代表包含地图可视区域的矩形。可以拖动矩形或总览图来更新可视区域。

实现

  • IControl

构造函数概述

  • OverviewMapControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition
  • setSize

构造函数

OverviewMapControl(options?:OverviewMapControlOptions)

用于构造 OverviewMapControl 对象。

参数 类型 说明
options? OverviewMapControlOptions

地图总览的控制选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

setSize(newSize:Point): void

用于更改控件大小。

参数 类型 说明
newSize Point

控件的新大小(以像素为单位)。

返回页首

OverviewMapControlOptions 类

OverviewMapControlOptions 类用于为总览图控件指定选项集。

字段概述

  • controlStyle
  • navigatorStyle
  • padding
  • position
  • size

构造函数概述

  • OverviewMapControlOptions

方法概述

  • toString

属性

名称 类型 说明
controlStyle BevelStyle

控件的倾斜样式。

navigatorStyle RectangleStyle

导航窗口的笔触样式。

padding Point

边界与控件内容之间的间距。

position ControlPosition

控件在地图上的位置。

size Point

控件大小。

构造函数

OverviewMapControlOptions(param?:Object)

用于构造 OverviewMapControlOptions 对象,可以选择通过某个对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{ size: {
    x: 100,
    y: 100
  },
  padding: {
    x: 4,
    y: 4
  },
  controlStyle: {
    fillStyle: {
      color: Color.WHITE,
      alpha: 1.0
    },
    strokeStyle: {
      color: Color.BLACK,
      alpha: 1.0,
      thickness: 1.0
    },
    bevelStyle: BevelStyle.BEVEL_RAISED,
    bevelThickness: 2.0,
    bevelAlpha: 0.6,
    highlightColor: Color.WHITE,
    shadowColor: Color.BLACK
  },
  navigatorStyle: {
    fillStyle: {
      color: NAVIGATOR_COLOR,
      alpha: Alpha.PERCENT_20
    },
    strokeStyle: {
      thickness: 2,
      color: NAVIGATOR_COLOR,
      alpha: 1.0
    }
  },
  position: new ControlPosition(ControlPosition.ANCHOR_BOTTOM_RIGHT, 10)
}

实例方法

toString(): String

toString 方法。

返回页首

PositionControl 类

PositionControl 包含用于平移地图的一组平移按钮。

实现

  • IControl

构造函数概述

  • PositionControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

构造函数

PositionControl(options?:PositionControlOptions)

用于构造 PositionControl 对象。

参数 类型 说明
options? PositionControlOptions

位置控件选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

PositionControlOptions 类

PositionControlOptions 类用于为位置控件指定一组选项。

字段概述

  • buttonSize
  • buttonSpacing
  • buttonStyle
  • position

构造函数概述

  • PositionControlOptions

方法概述

  • toString

属性

名称 类型 说明
buttonSize Point

按钮大小。

buttonSpacing Point

按钮间距。

buttonStyle ButtonStyle

按钮样式。

position ControlPosition

控件在地图上的位置。

构造函数

PositionControlOptions(param?:Object)

用于构造 PositionControlOptions 对象,可以选择通过一个对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{ buttonSize: new Point(17, 17),
  buttonStyle: new ButtonStyle({
  }),
  buttonSpacing: new Point(4, 4),
  position: new ControlPosition(ControlPosition.ANCHOR_TOP_LEFT, 10)
}

实例方法

toString(): String

toString 方法。用于传回此对象的字符串表示。

返回页首

ScaleControl 类

ScaleControl 提供可显示地图比例的控件。

实现

  • IControl

构造函数概述

  • ScaleControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

构造函数

ScaleControl(options?:ScaleControlOptions)

用于构造 ScaleControl 对象。

参数 类型 说明
options? ScaleControlOptions

比例控件选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

ScaleControlOptions 类

ScaleControlOptions 类用于为比例控件指定一组选项。

字段概述

  • UNITS_BOTH
  • UNITS_BOTH_PREFER_IMPERIAL
  • UNITS_BOTH_PREFER_METRIC
  • UNITS_IMPERIAL_ONLY
  • UNITS_METRIC_ONLY
  • UNITS_SINGLE
  • labelFormat
  • lineThickness
  • maxWidth
  • position
  • units

构造函数概述

  • ScaleControlOptions

方法概述

  • toString

常数

名称 说明
UNITS_BOTH 0

用于显示英制和公制比例指示器。

UNITS_BOTH_PREFER_IMPERIAL 2

用于显示英制和公制比例指示器,其中英制比例指示器显示在上面。

UNITS_BOTH_PREFER_METRIC 1

用于显示英制和公制比例指示器,其中公制比例指示器显示在上面。

UNITS_IMPERIAL_ONLY 6

仅显示英制比例指示器。

UNITS_METRIC_ONLY 5

仅显示公制比例指示器。

UNITS_SINGLE 4

仅显示基于用户的语言区域选择的一个比例指示器。

属性

名称 类型 说明
labelFormat TextFormat

控件标签的格式。

lineThickness Object

用于指示比例控件中线条宽度的整数值。

maxWidth Object

一个数值,用于指示比例控件的最大宽度。

position ControlPosition

控件在地图上的位置。

units Object

比例控件显示的单位。ScaleControlOptions.UNITS_ 常数中的一个。

构造函数

ScaleControlOptions(param?:Object)

用于构造 ScaleControlOptions 对象,可以选择通过一个对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{ position: new ControlPosition(ControlPosition.ANCHOR_BOTTOM_LEFT, 70, 5)
  units: ScaleControlOptions.UNITS_BOTH,
  maxWidth: 125,
  lineThickness: 1,
  labelFormat: {
    font: "_sans",
    size: 11
  }
}

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

ZoomControl 类

ZoomControl 包含用于放大和缩小地图的按钮以及缩放滑块。

实现

  • IControl

构造函数概述

  • ZoomControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

构造函数

ZoomControl(options?:ZoomControlOptions)

通过可选的选项设置构造 ZoomControl 对象。

参数 类型 说明
options? ZoomControlOptions

缩放控件选项。

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

ZoomControlOptions 类

ZoomControlOptions 类用于为缩放控件指定一组选项。

字段概述

  • buttonSize
  • buttonSpacing
  • buttonStyle
  • hasScrollTrack
  • position

构造函数概述

  • ZoomControlOptions

方法概述

  • toString

属性

名称 类型 说明
buttonSize Point

按钮大小。

buttonSpacing Point

按钮间距。

buttonStyle ButtonStyle

按钮样式。

hasScrollTrack Object

一个布尔值,用于指定是否具有滚动条底。

position ControlPosition

控件在地图上的位置。

构造函数

ZoomControlOptions(param?:Object)

用于构造 ZoomControlOptions 对象,可以选择通过一个对象对其进行初始化。

参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

				// Initialization object corresponding to the default set.
{ buttonSize: new Point(17, 17),
  buttonStyle: new ButtonStyle({
    allStates: {
      bevelThickness: 1.5,
      bevelAlpha: 0.5
    }
  }),
  buttonSpacing: new Point(4, 4),
  hasScrollTrack: true,
  position: new ControlPosition(ControlPosition.ANCHOR_TOP_LEFT, 31, 76)
}

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

Attitude 类

Attitude 用于表示对象在空间中的旋转度。

字段概述

  • pitch
  • roll
  • yaw

构造函数概述

  • Attitude

方法概述

  • equals
  • toString

属性

名称 类型 说明
pitch Number

 

roll Number

 

yaw Number

 

构造函数

Attitude(yaw:Number, pitch:Number, roll:Number)

初始化旋转度、倾斜度和偏角。其默认值都为零,表示在地面上直接看到的对象。

参数 类型 说明
yaw Number

偏角(以度为单位)。

pitch Number

倾斜度(以度为单位)。

roll Number

旋转度(以度为单位)。

实例方法

equals(other:Attitude): Boolean

确定此空间方位角是否与另一个空间方位角相等。

参数 类型 说明
other Attitude

另一个空间方位角。

toString(): String

生成此对象的字符串表示。此方法会返回一个字符串列表,列表的形式为在括号内依次列出偏角度数、倾斜度角度数和旋转度角度数,其中各角度数以逗号分隔。例如“(10, 20, 0)”。

返回页首

Point3D 类

Point3D 表示三维坐标系中的一个位置。该类用于存放 x、y、z 坐标值。

字段概述

  • x
  • y
  • z

构造函数概述

  • Point3D

方法概述

  • toString

属性

名称 类型 说明
x Number

x 坐标。

y Number

y 坐标。

z Number

z 坐标。

构造函数

Point3D(x:Number, y:Number, z:Number)

构建 Point3D 实例并初始化 x、y 和 z。

参数 类型 说明
x Number

初始 x 值。

y Number

初始 y 值。

z Number

初始 z 值。

实例方法

toString(): String

返回包含 x、y 和 z 坐标值的字符串。字符串的形式为“(x=x, y=y, z=z)”,因此,对 X、Y、Z 坐标值分别为 12、15、16 的点调用 toString() 将会返回“(x=12, y=15, z=16)”。

返回页首

TransformationGeometry 类

TransformationGeometry 存放重构镜头投影所需要的几何图形信息,镜头投影用于将世界坐标转换为视口坐标或将视口坐标转换为世界坐标。使用 Point3D 实例返回 x、y 和 z 坐标值。

字段概述

  • cameraPosition
  • cameraXAxis
  • cameraYAxis
  • cameraZAxis
  • focalLength
  • viewportSize

构造函数概述

  • TransformationGeometry

属性

名称 类型 说明
cameraPosition Point3D

以世界坐标表示的镜头位置。

cameraXAxis Point3D

标准化矢量,即镜头 x 轴在世界坐标上的投影。

cameraYAxis Point3D

标准化矢量,即镜头 y 轴在世界坐标上的投影。

cameraZAxis Point3D

标准化矢量,即镜头 z 轴在世界坐标上的投影。

focalLength Number

从镜头到视口的距离。该单位相当于一个屏幕像素的高度,但距离是沿着屏幕的法线矢量(从屏幕表面朝着屏幕外的方向)进行测量的。如果您希望将 Maps API(Flash 版)3D 几何图形与其他 3D 建模包中所使用的几何图形关联起来,则 focalLength、视口的垂直范围viewportSize.y 和视口的垂直视野 fovy 之间的关系为:fovy = 2 x atan(viewportSize.y / (2 focalLength))

viewportSize Point

视口的大小(以像素表示)。

构造函数

 

TransformationGeometry(cameraPosition:Point3D, cameraXAxis:Point3D, cameraYAxis:Point3D, cameraZAxis:Point3D, viewportSize:Point, focalLength:Number)

构建 TransformationGeometry 实例并初始化其属性。

参数 类型 说明
cameraPosition Point3D

以世界坐标表示的镜头位置。

cameraXAxis Point3D

标准化矢量,即镜头 x 轴在世界坐标上的投影。

cameraYAxis Point3D

标准化矢量,即镜头 y 轴在世界坐标上的投影。

cameraZAxis Point3D

标准化矢量,即镜头 z 轴在世界坐标上的投影。

viewportSize Point

视口的大小(以像素表示)。

focalLength Number

从镜头到视口的距离。

返回页首

ICamera 接口

ICamera 接口可提供相应权限,用于查看透视地图时需要使用的几何图形以及变换方法。使用 Map3D.camera 将地图的镜头作为 ICamera 实例返回。

字段概述

  • attitude
  • center
  • focalLength
  • is3D
  • maxPitch
  • maxRoll
  • maxYaw
  • minPitch
  • minRoll
  • minYaw
  • shadowMatrix
  • viewport
  • zoom
  • zoomScale

方法概述

  • getLatLngClosestToCenter
  • getTransformationGeometry
  • getWorldViewPolygon
  • isAhead
  • isOnMap
  • latLngToViewport
  • latLngToWorld
  • viewportToLatLng
  • viewportToWorld
  • worldDistance
  • worldToLatLng
  • worldToViewport

属性

名称 类型 说明
attitude Attitude

地图空间方位角。

center LatLng

地图中心。

focalLength Number

镜头焦距。

is3D Boolean

使用的是否为三维视图。

maxPitch Number

最大倾斜度(以度为单位)。

maxRoll Number

最大旋转度(以度为单位)。

maxYaw Number

最大偏角(以度为单位)。

minPitch Number

最小倾斜度(以度为单位)。

minRoll Number

最小旋转度(以度为单位)。

minYaw Number

最小偏角(以度为单位)。

shadowMatrix Matrix

转换矩阵,应用于在视口上绘制的图像,以生成图像阴影(绘制在视口上,但显示为沿地图扩展)。

viewport Point

视口大小。

zoom Number

地图缩放。

zoomScale Number

地图缩放比例。

实例方法

getLatLngClosestToCenter(latLng:LatLng): LatLng

此方法使用 LatLng 并且返回 LatLng。返回值可能与参数相同,也可能通过 360 度的经度倍数进行调整,以尽可能靠近地图中心。在三维查看模式下,返回的 LatLng 将对应于地图的可见区域。从数学角度而言,指定的 LatLng 的经度将会限制在 [center_longitude-180, center_longitude+180] 的范围内。

参数 类型 说明
latLng LatLng

要处理的 LatLng。

getTransformationGeometry(): TransformationGeometry

返回镜头变换几何图形信息,可使用该信息构建用于变换 (x,y,z,w) 位置的 4 x 4 矩阵。您可以使用此函数作为基础,因为执行变换比在二维世界位置和二维视口位置之间进行转换更为高级。Google Maps API(Flash 版)演示图库中包含使用这些系数执行完全三维变换的示例。

getWorldViewPolygon(): Array

返回一个多边形,它圈起了视口内可视的地图区域,其顶点以世界坐标表示。该多边形是裁剪为视口大小的完整地图的边界。

isAhead(latLng:LatLng): Boolean

确定某个点是否位于镜头前。位于焦平面之前的所有点都视为位于镜头之前。如果此方法返回 true,则表示 latLngToViewport(latLng) 将会返回位于地平线之下的点。

参数 类型 说明
latLng LatLng

要测试的位置。

isOnMap(viewportPoint:Point): Boolean

确定某个视口点是否位于显示的地图上,在三维地图中即意味着该点是否位于地平线之下。

参数 类型 说明
viewportPoint Point

要测试的视口点。

latLngToViewport(latlng:LatLng): Point

将 lat/lng 位置转换为视口上的点。此函数始终返回一个点,即使 lat/lng 位于镜头之后,返回的点也会位于地平线之上。因此,为了确定某个点是否可见,用户首先应该调用 isAhead,然后再调用此函数。此函数也可以返回两个坐标都等于无穷大的点(当该点位于世界平面的“向前”和“向后”部分之间的边界上时会发生这种情况)。再次说明,先查询 isAhead 可阻止生成无限点。

参数 类型 说明
latlng LatLng

以 LatLng 表示的位置。

latLngToWorld(latlng:LatLng): Point

将 lat/lng 位置转换为世界坐标。

参数 类型 说明
latlng LatLng

以 LatLng 表示的位置。

viewportToLatLng(viewportPoint:Point): LatLng

将视口位置变换为 lat/lng。此函数始终返回一个位置,即使在点位于水平线之上,返回的 lat/lng 仍将位于镜头之后。因此,在调用此函数之前,用户应使用 isOnMap 清理视口位置。

参数 类型 说明
viewportPoint Point

以视口坐标表示的位置。

viewportToWorld(viewportPoint:Point): Point

将视口坐标转换为世界坐标。

参数 类型 说明
viewportPoint Point

视口坐标。

worldDistance(worldPoint:Point): Number

返回从镜头到某个指定点(用世界坐标表示)的距离。

参数 类型 说明
worldPoint Point

以世界坐标表示的点。

worldToLatLng(worldPoint:Point): LatLng

将世界坐标转换为未经处理的 lat/lng 位置。

参数 类型 说明
worldPoint Point

世界坐标。

worldToViewport(point:Point): Point

将世界坐标转换为视口坐标。

参数 类型 说明
point Point

世界坐标。

返回页首

IClientGeocoder 接口

IClientGeocoder 是由客户端地址解析器对象实现的接口。客户端地址解析器可与 Google 服务器通信,以获取用户指定地址的地址解析。另外,地址解析器可维护自己的地址缓存,可以无需往返于服务器而回答重复的查询。

实现类

  • ClientGeocoder

方法概述

  • geocode
  • getOptions
  • resetCache
  • reverseGeocode
  • setOptions

实例方法

geocode(address:String): void

启动地址解析请求。在操作即将完成时分派 GeocodingEvent.GEOCODING_SUCCESS 或 GeocodingEvent.GEOCODING_FAILURE。

参数 类型 说明
address String

要进行地址解析的地址。

getOptions(): ClientGeocoderOptions

用于检索地址解析器对象的选项。使用 setOptions() 方法可修改地址解析器选项。

resetCache(): void

用于重置地址解析缓存,从而清除此对象和其他 ClientGeocoder 对象检索的所有结果。

reverseGeocode(latLng:LatLng): void

启动逆向地址解析请求。在操作即将完成时分派 GeocodingEvent.GEOCODING_SUCCESS 或 GeocodingEvent.GEOCODING_FAILURE。

参数 类型 说明
latLng LatLng

要进行逆向地址解析的 LatLng。

setOptions(options:ClientGeocoderOptions): void

用于更新地址解析器选项。options 参数可指定完整或部分地址解析器选项集。

参数 类型 说明
options ClientGeocoderOptions

新的完整或部分地址解析器选项集。

返回页首

IControl 接口

这是由地图控件实现的接口。您可以实现此接口或使用 com.google.maps.controls.ControlBase 类以为地图提供自定义控件。使用 Map.addControl() 方法向地图添加控件。

实现类

  • ControlBase
  • MapTypeControl
  • NavigationControl
  • OverviewMapControl
  • PositionControl
  • ScaleControl
  • ZoomControl

方法概述

  • getControlPosition
  • getDisplayObject
  • getSize
  • initControlWithMap
  • setControlPosition

实例方法

getControlPosition(): ControlPosition

用于检索控件位置。

getDisplayObject(): DisplayObject

用于检索控件的显示对象(通常为控件对象本身,但如果控件包含 sprite 而不是扩展 sprite,则可能为其他对象)。

getSize(): Point

用于检索控件大小。

initControlWithMap(map:IMap): void

用于设置此控件操作所在的地图实例。通常通过调用 Map.addControl() 来调用该实例。

参数 类型 说明
map IMap

此控件应该附加到的地图。如果先前将此控件附加到了其他地图中,则会从该地图删除此控件,然后将其附加到此地图中。如果 map 参数为 Null,则会从先前的所有地图中删除此控件,但不会将其附加到新地图。

setControlPosition(position:ControlPosition): void

用于设置控件在地图上的位置,并在地图上更新其位置。

navigatorControl.setControlPosition(
    new ControlPosition(ControlPosition.ANCHOR_TOP_RIGHT, 2, 2));
参数 类型 说明
position ControlPosition

控件的新位置。

返回页首

ICopyrightCollection 接口

ICopyrightCollection 是由 CopyrightCollection 和对等类实现的接口。CopyrightCollection 用于管理在自定义地图上显示的版权消息。版权模型集包含以下信息:在哪个缩放级别的地图上为哪一区域显示哪一版权。这对于显示异类数据的地图类型(如卫星地图类型)非常重要。

实现类

  • CopyrightCollection

方法概述

  • addCopyright
  • getCopyrightNotice
  • getCopyrights
  • getCopyrightsAtLatLng

实例方法

addCopyright(copyright:Copyright): Boolean

用于将指定的版权添加到集合中;如果该版权为新内容并且已添加,则传回 true,如果该版权为重复内容并被忽略,则传回 false。

参数 类型 说明
copyright Copyright

要添加的新版权。

getCopyrightNotice(bounds:LatLngBounds, zoom:Number): CopyrightNotice

传回指定可视区域的 CopyrightNotice 实例。

参数 类型 说明
bounds LatLngBounds

查询范围。

zoom Number

缩放级别。

getCopyrights(bounds:LatLngBounds, zoom:Number): Array

用于检索类型为 String 的元素数组,该数组构成了我们应为指定可视区域显示的版权文本。

参数 类型 说明
bounds LatLngBounds

查询范围。

zoom Number

缩放级别。

getCopyrightsAtLatLng(latLng:LatLng): Array

用于传回类型为 Copyright 的元素数组,该数组是与指定位置相关的版权。

参数 类型 说明
latLng LatLng

我们要获取其版权的点。

返回页首

IDirections 接口

IDirections 是由 Directions 对象实现的接口。Directions 对象可与 Google 服务器进行通信,以获取两个或多个路标之间的路线。对此类请求的回复包含一条表示路线的编码折线,以及要采用的 HTML 格式的路段。

实现类

  • 路线

字段概述

  • bounds
  • copyrightsHtml
  • distance
  • distanceHtml
  • duration
  • durationHtml
  • encodedPolylineData
  • numGeocodes
  • numRoutes
  • status
  • summaryHtml

方法概述

  • clear
  • createPolyline
  • getGeocode
  • getOptions
  • getRoute
  • load
  • setOptions

属性

名称 类型 说明
bounds LatLngBounds

此路线查询结果的边框。如果查询失败,则为 Null。

copyrightsHtml String

一个包含此结果的版权信息的 HTML 字符串。

distance Number

此整个路线请求的总距离(以米为单位)。

distanceHtml String

以本地化字符串表示的此整个路线请求的总距离,以此路线集起始国家/地区通用的单位为准。

duration Number

此整个路线请求的总时间(以秒为单位)。

durationHtml String

以本地化字符串表示的此整个路线请求的总时间。

encodedPolylineData EncodedPolylineData

经过编码的折线数据,可用于路线请求。

numGeocodes uint

结果中提供的地址解析项的数量。如果查询成功,则此值应该等于总的输入航点数量。如果未提供任何结果(可能因为未发送查询或前一次查询失败),则此值将会为 0。

numRoutes uint

结果中提供的路线数量。如果查询成功,则此值应该等于总的输入航点数量减 1。如果未提供任何结果(可能因为未发送查询或前一次查询失败),则此值将会为 0。

status uint

路线请求的状态代码。如果未提供结果,则此值将会为 500。

summaryHtml String

一个包含此整个路线请求的距离和时间概述的 HTML 代码段。

实例方法

clear(): void

用于清除任何现有的路线结果,并取消所有待定的 load() 请求。

createPolyline(options?:PolylineOptions): IPolyline

用于创建与整个路线回复关联的 Polyline 对象。请注意,系统将会以一条折线来表示回复中的所有路线。仅在载入路线结果(即已触发“load”事件)后才可以创建此对象。

参数 类型 说明
options? PolylineOptions

用于创建折线的选项。

getGeocode(i:uint): Placemark

用于传回第 i 个航点的地址解析结果。

参数 类型 说明
i uint

要传回的地址解析结果的索引。此值应该介于 0 至 numGeocodes - 1 范围之间(包含这两个数值)。

getOptions(): DirectionsOptions

用于检索路线对象的选项。使用 setOptions() 方法可修改路线对象的选项。

getRoute(i:uint): Route

用于传回回复中第 i 条路线的 Route 对象。

参数 类型 说明
i uint

要传回的路线的索引。此值应该介于 0 至 numRoutes - 1 范围之间(包含这两个数值)。

load(query:String): void

启动路线请求。为完成操作分派 DirectionsEvent.DIRECTIONS_SUCCESSDirectionsEvent.DIRECTIONS_FAILURE 或 DirectionsEvent.DIRECTIONS_ABORTED。每个事件都作为通知提供服务,用于告知路线回复已从服务器中返回,如果成功执行相应事件,则可以从此对象中检索回复信息。接收到路线结果后,此对象会清除旧的结果,并替换为新结果。路线结果由多条路线组成,在查询中指定的每个连续航点/地址对分别对应一条路线,而路线则由多个路段组成。调用新的 load() 请求时,如果未完成前一个 load() 请求,则会取消前一个请求,并为该请求分派 DirectionsEvent.DIRECTIONS_ABORTED 事件。因此,您可以使用单个 Directions 对象逐个发送路线请求,不过,如果生成多个并列请求,则必须使用多个 Directions 对象。

参数 类型 说明
query String

地图样式的路线查询。此值可以为“from: src to: dst1 to: dst2 ...”格式,也可以为自由格式的路线查询(“SFO to SJC”)。

setOptions(options:DirectionsOptions): void

用于更新路线选项。options 参数可指定完整或部分路线选项集。

参数 类型 说明
options DirectionsOptions

新的完整或部分路线选项集。

返回页首

IElevation 接口

IElevation 是由 Elevation 对象实现的接口。Elevation 对象可与 Google 服务器通信,以获取一个或多个位置的海拔信息。

实现类

  • 海拔

方法概述

  • loadElevationAlongEncodedPath
  • loadElevationAlongPath
  • loadElevationForEncodedLocations
  • loadElevationForLocations

实例方法

loadElevationAlongEncodedPath(encodedPolylineData:EncodedPolylineData, numPoints:int): void

向 Google 服务器发送请求,查询某条路径上的一个或多个等距离位置的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
encodedPolylineData EncodedPolylineData

可以在其中查到海拔信息的编码位置。与 loadElevationForEncodedLocations() 相反,您可以将路线查询所返回的复杂编码折线数据直接传递给此方法,因为海拔数据只有在指定数目的插值位置才能找到,而不是在 EncodedPolylineData 实例定义的每个位置都能找到。不过,该实现可能会在使用前对该数据结构进行内部简化处理。

numPoints int

要计算海拔的点数。

loadElevationAlongPath(locations:Array, numPoints:int): void

向 Google 服务器发送请求,查询某条路径上的一个或多个等距离位置的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
locations Array

用于定义路径的 LatLng 元素的数组。系统使用插值方法生成要计算海拔的位置。

numPoints int

要计算海拔的点数。

loadElevationForEncodedLocations(encodedPolylineData:EncodedPolylineData): void

向 Google 服务器发送请求,查询一个或多个纬度和经度的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
encodedPolylineData EncodedPolylineData

可以在其中查到海拔信息的编码位置。请注意,路线查询所返回的经过编码的折线数据可能会包含数千个位置,如果尝试获取所有位置的海拔数据,则很可能会超出您的配额。此方法仅限与经过编码的简化折线数据配合使用。

loadElevationForLocations(locations:Array): void

向 Google 服务器发送请求,查询一个或多个纬度和经度的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
locations Array

LatLng 元素的数组,包含可以在其中查到海拔信息的位置。

返回页首

IGroundOverlay 接口

IGroundOverlay 是由地面叠加层对象实现的接口。地面叠加层是放置在地图内容之上的图像,它的各个角是通过纬度/经度对来定位的。

地面叠加层会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现类

  • GroundOverlay

方法概述

  • getOptions
  • setOptions

实例方法

getOptions(): GroundOverlayOptions

用于检索地面叠加层使用的完整选项集。使用 setOptions 方法可修改地面叠加层的选项。

setOptions(options:GroundOverlayOptions): void

用于更新地面叠加层的选项。options 参数可指定完整或部分地面叠加层选项集。如果指定了部分选项集,它会补充现有的标记选项,仅覆盖已明确设置的值,而保留其余值不变。

// Modify the ground overlay's stroke colour, leaving the rest
// of its options unchanged.
var options:GroundOverlayOptions =
    new GroundOverlayOptions( { strokeStyle: { color: 0x000080 }} );
myGroundOverlay.setOptions(options);
参数 类型 说明
options GroundOverlayOptions

新的完整或部分地面叠加层选项集。

返回页首

IInfoWindow 接口

IInfoWindow 是由可以显示 HTML 格式文本的信息窗口实现的接口。

字段概述

  • removed

属性

名称 类型 说明
removed Boolean

用于检查是否删除了信息窗口。

返回页首

IMap 接口

IMap 是由 Map 实现的接口。用于创建 Map 类的实例以创建地图。这是 API 中的中心类。

实现类

  • Map
  • Map3D
  • MapType

字段概述

  • MERCATOR_PROJECTION
  • overlayRaising

方法概述

  • addControl
  • addMapType
  • addOverlay
  • clearControls
  • clearOverlays
  • closeInfoWindow
  • continuousZoomEnabled
  • controlByKeyboardEnabled
  • crosshairsEnabled
  • disableContinuousZoom
  • disableControlByKeyboard
  • disableCrosshairs
  • disableDragging
  • disableScrollWheelZoom
  • draggingEnabled
  • enableContinuousZoom
  • enableControlByKeyboard
  • enableCrosshairs
  • enableDragging
  • enableScrollWheelZoom
  • fromLatLngToPoint
  • fromLatLngToViewport
  • fromPointToLatLng
  • fromViewportToLatLng
  • getBoundsZoomLevel
  • getCenter
  • getCurrentMapType
  • getDisplayObject
  • getDoubleClickMode
  • getImplementationVersion
  • getLatLngBounds
  • getMapTypes
  • getMaxZoomLevel
  • getMinZoomLevel
  • getOptions
  • getPaneManager
  • getPrintableBitmap
  • getProjection
  • getSize
  • getZoom
  • isLoaded
  • openInfoWindow
  • panBy
  • panTo
  • removeControl
  • removeMapType
  • removeOverlay
  • returnToSavedPosition
  • savePosition
  • scrollWheelZoomEnabled
  • setCenter
  • setDoubleClickMode
  • setMapType
  • setSize
  • setZoom
  • unload
  • zoomIn
  • zoomOut

属性

名称 类型 说明
MERCATOR_PROJECTION IProjection

用于检索墨卡托投影。

overlayRaising Boolean

将此属性设置为 true 时,可在鼠标悬停时提升叠加层。如果启用了此属性,那么将鼠标悬停在支持鼠标悬停事件的叠加层上(目前只有标记支持)会将此叠加层置于顶层。默认情况下已启用提升叠加层功能。

实例方法

addControl(control:IControl): void

注册一个新控件。在收到 MAP_READY 事件之前可调用此控件。

public class MyMap extends Map {
  public function MyMap() {
    super();
    addEventListener(MapEvent.MAP_READY, onMapReady);
    addControl(new MapTypeControl());
  }
}
参数 类型 说明
control IControl

要注册的新控件。

addMapType(newMapType:IMapType): void

注册一个新的地图类型。

参数 类型 说明
newMapType IMapType

要注册的新地图类型。

addOverlay(overlay:IOverlay): void

向地图添加叠加层。

var marker:Marker = new Marker(
    new LatLng(48.858842, 2.346997),
    new MarkerOptions({ fillRGB: 0x004000,
                        name: "Paris, France",
                        description: "City on the Seine" }));
map.addOverlay(marker);
参数 类型 说明
overlay IOverlay

要添加到地图中的叠加层。

clearControls(): void

从地图中删除所有控件。

clearOverlays(): void

从地图中删除所有叠加层。

closeInfoWindow(): Boolean

关闭信息窗口。

continuousZoomEnabled(): Boolean

检查是否启用了连续缩放。

controlByKeyboardEnabled(): Boolean

检查是否启用了键盘控制。

crosshairsEnabled(): Boolean

检查是否启用了中心十字准线。

disableContinuousZoom(): void

禁用连续平滑缩放。

disableControlByKeyboard(): void

禁用键盘控制。

disableCrosshairs(): void

禁用中心十字准线。

disableDragging(): void

禁用地图拖动。

disableScrollWheelZoom(): void

禁用使用鼠标滚轮缩放。

draggingEnabled(): Boolean

检查是否启用了地图拖动。

enableContinuousZoom(): void

启用连续平滑缩放。

enableControlByKeyboard(): void

启用键盘控制。

enableCrosshairs(): void

启用中心十字准线。

enableDragging(): void

启用地图拖动。

enableScrollWheelZoom(): void

启用使用鼠标滚轮缩放。

fromLatLngToPoint(latLng:LatLng, opt_zoom?:Number): Point

传回指定的纬度、经度和缩放的 x、y 坐标,该坐标是相对于地图投影的原点而言(该原点位于指定缩放级别的地图左上方图块的左上角)。

参数 类型 说明
latLng LatLng

地图上的 latLng 位置。

opt_zoom? Number

目标缩放级别(默认为当前缩放级别)

fromLatLngToViewport(latLng:LatLng, opt_disablewrap?:Boolean): Point

传回地图可视区域坐标系中指定的 latLng 位置的像素坐标([0,0] 位于地图对象的左上角)。

参数 类型 说明
latLng LatLng

地图上该点的 LatLng 坐标。

opt_disablewrap? Boolean

是否禁用了“将地图经度限制在 +180/-180 度的范围内”。

对于此参数的两个值,该调用会返回两个相同的还是不同的像素坐标,则取决于地图的当前中心与目标位置之间的最短路径是否穿过 +180/-180 度的经度范围。

例如,当前地图中心位于澳大利亚悉尼 [LatLng(-33.857, 151.215)],而传递给此调用的位置为美国旧金山 [LatLng(37.779, -122.420)],则该调用会对 opt_disablewrap 参数的两个值返回两个不同的像素坐标。

默认情况下(将 opt_disablewrap 设置为 false),地图经度会限制在 +180/-180 度的范围内,从而返回的像素坐标将会位于地图当前中心的右侧(选择从悉尼到旧金山之间穿越太平洋的较短路径)。

如果禁用了处理地图经度功能(将 opt_disablewrap 设置为 true),则由调用返回的像素坐标将会位于当前中心的左侧(选择从悉尼到旧金山之间穿越印度洋和大西洋的较长路径)。

如果从地图的当前中心到目标位置之间的较短路径不穿过 +180/-180 度经线(例如,如果地图的当前中心在澳大利亚悉尼,而目标位置在日本东京),则该调用对于 opt_disablewrap 参数的两个值所返回的值是相同的。

fromPointToLatLng(pos:Point, opt_zoom?:Number, opt_nowrap?:Boolean): LatLng

传回指定的 x、y 和缩放的“纬度,经度”坐标。这些坐标相对于地图投影的原点(位于指定缩放级别的地图的左上图块的左上角)。

参数 类型 说明
pos Point

点的 x、y 坐标

opt_zoom? Number

目标缩放级别(默认为当前缩放级别)

opt_nowrap? Boolean

不处理 [-180, 180] 范围以外的经度

fromViewportToLatLng(pos:Point, opt_nowrap?:Boolean): LatLng

传回地图可视区域(位于地图对象的左上角)中指定的坐标点的纬度和经度。

参数 类型 说明
pos Point

地图可视区域中的坐标。

opt_nowrap? Boolean

不处理 [-180, 180] 范围以外的经度

getBoundsZoomLevel(bounds:LatLngBounds): Number

传回指定矩形区域在地图视图中适合的最高分辨率缩放级别。缩放级别要按当前选中的地图类型计算。

参数 类型 说明
bounds LatLngBounds

要显示的范围。

getCenter(): LatLng

用于检索地图视图控件中心的坐标。

getCurrentMapType(): IMapType

用于检索当前地图类型。

getDisplayObject(): DisplayObject

用于检索代表地图的显示对象。

getDoubleClickMode(): Number

用于进入鼠标双击模式。

getImplementationVersion(): String

用于获取实现库 SWF 的版本。

getLatLngBounds(): LatLngBounds

用于传回地图视图的可视矩形区域(以地理坐标表示)。

getMapTypes(): Array

用于检索该位置可用的地图类型列表。

getMaxZoomLevel(opt_mapType?:IMapType, opt_point?:LatLng): Number

用于检索最大的缩放级别。

参数 类型 说明
opt_mapType? IMapType

用于确定最大分辨率的地图类型。

opt_point? LatLng

要获取其最大缩放级别的点。

getMinZoomLevel(opt_mapType?:IMapType, opt_point?:LatLng): Number

用于检索最小缩放级别。

参数 类型 说明
opt_mapType? IMapType

用于确定最小分辨率的地图类型。

opt_point? LatLng

要获取其最小缩放级别的点。

getOptions(): MapOptions

用于检索地图使用的完整选项集。请注意,由于 MapOptions 仅在地图初始化时使用,因此该方法仅允许检索原始设置,而不支持重新配置地图。

getPaneManager(): IPaneManager

用于检索地图的窗格管理器。

getPrintableBitmap(): Bitmap

用于返回 Bitmap 实例,其中包含待打印地图的快照图像。

地图本身可能包含从多个域载入的内容。此方法要求通过 crossdomain.xml 文件授予域 maps.googleapis.com 访问地图上所有显示内容的权限。例如,如果地图使用的某个自定义图块层包含从 http://www.thirdpartymap.com/path/tile_x_y_z.png 形式的网址载入的图块,请在 http://www.thirdpartymap.com/path/crossdomain.xml 处放置一个 crossdomain.xml 文件。使用 Security.loadPolicyFile() 加载此文件,并且在加载图块图像时,确保使用 checkPolicyFile 属性为 true 的 LoaderContext 实例。

请注意,通过在上述网址中使用 path/,仅能授予 maps.googleapis.com 访问 http://www.thirdpartymap.com/path/ 下内容的特许权限,而非访问www.thirdpartymap.com 上所有内容的权限。

getProjection(): IProjection

用于传回应用于地图的投影。

getSize(): Point

用于检索地图视图大小。

getZoom(): Number

用于检索地图缩放级别。

isLoaded(): Boolean

检查是否已初始化地图。

openInfoWindow(latlng:LatLng, options?:InfoWindowOptions): IInfoWindow

在指定点处打开一个简单的信息窗口。

参数 类型 说明
latlng LatLng

用于打开信息窗口的点。

options? InfoWindowOptions

信息窗口选项。

panBy(distance:Point, animate?:Boolean): void

以动画方式平移指定的距离(以像素为单位)。

参数 类型 说明
distance Point

距离(以像素为单位)

animate? Boolean

是否能以动画方式显示更改。

panTo(latLng:LatLng): void

将地图的中心位置更改为指定的位置。如果该位置已经在当前的地图视图中显示,则会以平滑动画的方式移动到中心点。

参数 类型 说明
latLng LatLng

新中心点的坐标。

removeControl(control:IControl): void

从地图中删除控件。如果未将控件添加至地图,则此操作无效。

参数 类型 说明
control IControl

要删除的控件。

removeMapType(oldMapType:IMapType): void

要取消注册的地图类型。

参数 类型 说明
oldMapType IMapType

要取消注册的地图类型。

removeOverlay(overlay:IOverlay): void

从地图中删除一个叠加层。

参数 类型 说明
overlay IOverlay

要从地图中删除的叠加层。

returnToSavedPosition(): void

将地图传回至保存位置。

savePosition(): void

存储当前的地图位置和缩放级别,以便日后通过 returnToSavedPosition 重新调用。

scrollWheelZoomEnabled(): Boolean

检查是否启用了滚轮缩放。

setCenter(latLng:LatLng, opt_zoom?:Number, opt_mapType?:IMapType): void

更改地图的中心位置。

参数 类型 说明
latLng LatLng

新中心点的坐标。

opt_zoom? Number

新的缩放级别。

opt_mapType? IMapType

新的地图类型。

setDoubleClickMode(val:Number): void

用于设置鼠标双击模式。

参数 类型 说明
val Number

鼠标双击模式(MapAction 常数之一)。

setMapType(mapType:IMapType): void

用于更改地图的地图类型。

参数 类型 说明
mapType IMapType

地图类型。

setSize(newSize:Point): void

用于设置地图视图的大小。

参数 类型 说明
newSize Point

地图的新视图大小。

setZoom(level:Number, opt_doContinuousZoom?:Boolean): void

用于更改地图视图控件的缩放级别。

参数 类型 说明
level Number

新的缩放级别。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

unload(): void

从地图的父项中删除地图,并尝试卸载该地图来释放与其相关联的内存空间。调用此方法后,便不能再使用该地图对象。

zoomIn(opt_latlng?:LatLng, opt_doCenter?:Boolean, opt_doContinuousZoom?:Boolean): void

如果可以,将地图放大一个缩放级别。

参数 类型 说明
opt_latlng? LatLng

如果设置了此参数,我们将围绕此点进行缩放。否则,我们将围绕地图的中心进行放大。

opt_doCenter? Boolean

如果此参数为 true,那么我们还希望以 opt_latlng 为中心。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

zoomOut(opt_latlng?:LatLng, opt_doContinuousZoom?:Boolean): void

如果可以,将地图缩小一个缩放级别。

参数 类型 说明
opt_latlng? LatLng

如果设置了此参数,我们将围绕此点进行缩放。否则,我们将围绕地图的中心进行缩小。

opt_doContinuousZoom? Boolean

是否应当连续进行缩放(假如已启用地图的连续缩放功能)。

返回页首

IMap 接口3D

IMap3D 是由 Map3D 实现的接口。通过创建 Map3D 类的实例来创建支持三维视图的地图。

实现类

  • Map3D

字段概述

  • camera
  • dragMode
  • viewMode

方法概述

  • cancelFlyTo
  • flyTo
  • getAttitude
  • setAttitude

属性

名称 类型 说明
camera ICamera

该镜头可用于返回关于查看几何图形的信息,并可在纬度和经度、世界坐标和视口坐标之间进行转换。

dragMode int

在地图上使用的拖动模式。此属性的可接受值为 MapAction.DRAGMODE_LATLNGMapAction.DRAGMODE_PITCH 和 MapAction.DRAGMODE_YAW

默认情况下,在分派 MapMouseEvent.DRAG_START 和 MapMouseEvent.DRAG_STEP 事件之前,系统会根据 CTRL 和 SHIFT 键盘组合键的状态立即自动更新拖动模式。如果按下 SHIFT 键,则系统会将拖动模式设置为 MapAction.DRAGMODE_MAP_YAW_PITCH,如果按下 CTRL 键,则将其设置为MapAction.DRAGMODE_CAMERA_YAW_PITCH;如果两键都未按下,则将其设置为 MapAction.DRAGMODE_LATLNG

我们建议您保留此行为。这与 Google 地球中的行为一致。但是,如果要进行更改,则应当同时向 MapMouseEvent.DRAG_START 和MapMouseEvent.DRAG_STEP 附加监听器。然后,您就可以在自己的处理程序中根据相关参数(包括鼠标位置和键盘组合键状态)来设置相应的地图拖动模式了。

请注意,由于拖动模式可以在处理 MapMouseEvent.DRAG_STEP 之前和处理过程中立即更改,因此用户无需释放鼠标按钮即可开始使用新的拖动模式。如果在拖动操作过程中更改拖动模式,则在该操作以新的拖动模式继续进行前,您将会收到 DRAG_STOP 和 DRAG_START 事件。

viewMode int

应用到地图的查看模式。此属性的可接受值为 View.VIEWMODE_2DView.VIEWMODE_PERSPECTIVE 和 View.VIEWMODE_ORTHOGONAL

实例方法

cancelFlyTo(): void

取消任何通过调用 flyTo() 而启动的地图动作,并触发对 MapEvent.FLY_TO_CANCELED 和 MapEvent.FLY_TO_DONE 的分派。

如果没有进行飞行,则调用此方法不会产生任何效果。

flyTo(center:LatLng, zoom?:Number, attitude?:Attitude, duration?:Number): void

在指定的时间段内,更改地图的中心位置、缩放比例和空间方位角。如果希望更改立即生效,可将时间段设置为 0。

如果飞行路线比较复杂,您可以在上一次调用 flyTo() 的动画完成之前对其重复调用。每个飞行段都将加入队列,并依次执行。如果队列中存在多个飞行段,则系统会使用三次样条函数对镜头位置和空间方位角进行插值处理。

默认情况下,用户可以在飞行过程中与地图进行交互,此操作不会终止飞行(在用户释放控件之后,飞行将会沿剩余的飞行段继续飞行)。不过,如果您希望取消剩余的飞行部分,则可使用 cancelFlyTo() 方法。

飞行终止时(不管是否由于被取消而终止)将会分派 MapEvent.FLY_TO_DONE

参数 类型 说明
center LatLng

新地图中心的坐标。

zoom? Number

新的地图缩放比例。

attitude? Attitude

新的地图空间方位角。

duration? Number

更改发生之前的持续时间,以秒为单位。

getAttitude(): Attitude

获取地图空间方位角。在三维模式下,它将会控制用户查看地图的方位。

setAttitude(value:Attitude): void

设置地图空间方位角。在三维模式下,它将会控制用户查看地图的方位。

参数 类型 说明
value Attitude

新的地图空间方位角。

返回页首

IMapType 接口

IMapType 是由地图类型对象实现的接口。地图类型是图块层、地图投影、图块大小和各种其他设置(如链接颜色和版权)的集合。Google 提供了一组预定义的地图类型。您还可以使用 com.google.maps.MapType 类来定义自定义地图类型。可以使用 Map.addMapType() 方法向地图添加地图类型。

实现类

  • MapType

方法概述

  • getAlt
  • getBoundsZoomLevel
  • getCopyrights
  • getErrorMessage
  • getLinkColor
  • getMaxResolutionOverride
  • getMaximumResolution
  • getMinimumResolution
  • getName
  • getProjection
  • getRadius
  • getSpanZoomLevel
  • getTextColor
  • getTileLayers
  • getTileSize
  • getUrlArg
  • setMaxResolutionOverride

实例方法

getAlt(): String

用于传回用户将鼠标悬停在控件(允许选择此地图类型)上时所显示的提示文本。MapTypeControl 就是这样一个控件。

getBoundsZoomLevel(bounds:LatLngBounds, viewSize:Point): Number

用于传回在指定像素大小的地图中显示指定的纬度/经度范围所需的最大分辨率缩放级别。

参数 类型 说明
bounds LatLngBounds

要显示的范围。

viewSize Point

可视区域大小。

getCopyrights(bounds:LatLngBounds, zoom:Number): Array

用于传回指定范围和缩放级别的版权声明数组。此数组中的每个元素类型均为 CopyrightNotice。

参数 类型 说明
bounds LatLngBounds

当前可视区域。

zoom Number

当前缩放级别。

getErrorMessage(): String

如果未能下载图块,则会传回要显示的文本。

getLinkColor(): Number

如果控件在地图上方显示一个链接,则会传回我们应该使用的颜色。例如,版权控件中的“使用条款”链接会使用此颜色。

getMaxResolutionOverride(): Number

用于传回最大的分辨率覆盖。

getMaximumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最大分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最大分辨率。如果未指定 opt_point,则会传回全局最大分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点。

getMinimumResolution(opt_point?:LatLng): Number

用于传回此地图类型支持的最小分辨率的缩放级别。如果指定 opt_point,则会传回指定纬度/经度处的最小分辨率。如果未指定 opt_point,则会传回全局最小分辨率。

参数 类型 说明
opt_point? LatLng

用于评估分辨率所在的点(忽略)。

getName(opt_short?:Boolean): String

用于检索地图类型名称。

参数 类型 说明
opt_short? Boolean

用于传回缩写名称。

getProjection(): IProjection

用于检索地图类型投影。

getRadius(): Number

用于传回定义了此地图类型的星球半径。

getSpanZoomLevel(center:LatLng, span:LatLng, viewSize:Point): Number

用于传回显示指定中心点的指定纬度/经度跨度所需的最大分辨率缩放级别。

参数 类型 说明
center LatLng

可视区域中心。

span LatLng

可视区域跨度。

viewSize Point

可视区域大小(以像素为单位)。

getTextColor(): Number

如果控件为文本,则会传回相应的颜色来显示文本。例如,版权控件使用此颜色。

getTileLayers(): Array

按照显示图块层时应使用的 z 顺序,获取此地图类型的图块层的列表。请注意,构建完 MapType 实例之后,不能使用该方法更改显示的图块层。如果您想要显示另一组图层,则需要创建新的 MapType。

getTileSize(): Number

用于获取此地图类型的图块大小。所有预定义地图类型图块大小均为 256x256 像素:对于这些地图类型,此函数会传回 256。

getUrlArg(): String

用于传回一个字符串,可能会将此字符串用作网址参数来识别当前地图视图的永久链接中的此地图类型。目前,此参数仅在内部使用。请注意,如果在构建自定义地图类型时使用了任何内置图块层,则返回的值将会取决于这组图块层,而不是取决于由开发人员提供的任何值。

setMaxResolutionOverride(maxResolution:Number): void

设置最大分辨率覆盖,以便在此数值大于地图类型向我们报告的最大分辨率时,我们使用此数值来替换。它表示在 ZoomControl 滚动条上显示的缩放级别数量。

参数 类型 说明
maxResolution Number

最大分辨率覆盖的设置值。

返回页首

IMarker 接口

IMarker 是由在地图上标记位置的标记对象实现的接口。您可以使用 Map.addOverlay() 方法向地图添加标记。

标记会在移动或用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.DRAG_START
  • MapMouseEvent.DRAG_STEP
  • MapMouseEvent.DRAG_END
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK
  • MapMouseEvent.OVERLAY_MOVED
  • MapEvent.OVERLAY_ANIMATE_END

请注意,任意已分派 MapMouseEvent 上的 latLng 属性存放的都是标记的当前纬度/经度,而不是位于鼠标指针正下方的位置的纬度/经度。在这一点上,标记的行为与其他叠加层存在差异。

实现类

  • Marker

方法概述

  • closeInfoWindow
  • getLatLng
  • getOptions
  • openInfoWindow
  • setLatLng
  • setOptions

实例方法

closeInfoWindow(): void

如果信息窗口与此标记关联,则会关闭信息窗口。

getLatLng(): LatLng

用于检索标记的位置。

getOptions(): MarkerOptions

用于检索标记使用的完整选项集。使用 setOptions 方法可修改标记选项。

openInfoWindow(options?:InfoWindowOptions, useSeparatePane?:Boolean): IInfoWindow

打开位于标记上方的信息窗口。

参数 类型 说明
options? InfoWindowOptions

信息窗口选项。

useSeparatePane? Boolean

如果为 true,则会将信息窗口放置在其自身的窗格上。使用 Map3D 时,默认行为是将信息窗口放置到此标记所在的同一窗格上,从而将信息窗口放置在相同深度。将此参数设置为 true,可强制使行为与使用二维地图时一致(信息窗格放置在其自身的窗格上)。

setLatLng(value:LatLng): void

用于更改标记的 LatLng。

参数 类型 说明
value LatLng

标记的新 LatLng 位置。

setOptions(options:MarkerOptions): void

用于更新标记选项。options 参数可指定完整或部分标记选项集。如果指定了部分选项集,它会补充现有的标记选项,仅覆盖已明确设置的值,而保留其余值不变。

// Modify the marker's fill colour, leaving the rest
// of its options unchanged.
var options:MarkerOptions =
    new MarkerOptions( { fillStyle: { color: 0x000080 }} );
myMarker.setOptions(options);
参数 类型 说明
options MarkerOptions

新的完整或部分标记选项集。

返回页首

IMaxZoom 接口

实现类

  • MaxZoom

方法概述

  • load

实例方法

load(latLng:LatLng, opt_targetZoom?:Number): void

向 Google 服务器发送请求,查找指定地图类型(位于指定的纬度和经度处)中的图像的最大缩放级别。如果请求成功,系统会分派 MaxZoomEvent.MAXZOOM_SUCCESS,其中包含指定的纬度和经度以及该点的最大缩放级别。如果不成功,则系统会分派 MaxZoomEvent.MAXZOOM_FAILURE,表明出现了错误。如果设置了 opt_targetZoom,则仅会考虑使用最多达到 opt_targetZoom 的缩放级别。请注意:仅 MapType.SATELLITE_MAP_TYPE 和 MapType.HYBRID_MAP_TYPE 的卫星图像实现了此功能。

参数 类型 说明
latLng LatLng

用于查找最大缩放级别的纬度和经度。

opt_targetZoom? Number

可能返回的最高缩放级别。

返回页首

IOverlay 接口

此接口是由叠加层对象(如标记、折线、多边形、地面叠加层和信息窗口)实现的。使用 Map.addOverlay() 方法可将 IOverlay 实例放置到地图上。

实现类

  • OverlayBase

字段概述

  • foreground
  • pane
  • shadow
  • visible

方法概述

  • getDefaultPane
  • positionOverlay

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

visible Boolean

叠加层的可视性。

实例方法

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

返回页首

IPane 接口

IPane 是由地图窗格实现的接口。窗格是叠加层(如标记、折线和多边形等)的容器。

字段概述

  • id
  • map
  • paneManager
  • visible

方法概述

  • addOverlay
  • bringToTop
  • clear
  • fromLatLngToPaneCoords
  • fromPaneCoordsToLatLng
  • fromPaneCoordsToProjectionPoint
  • fromProjectionPointToPaneCoords
  • getViewportBounds
  • invalidate
  • removeOverlay
  • updatePosition

属性

名称 类型 说明
id uint

窗格 ID。

map IMap

此窗格添加到的地图实例。如果从地图中删除窗格,则为 Null。

paneManager IPaneManager

此窗格添加到的窗格管理器实例。如果从地图中删除窗格,则为 Null。

visible Boolean

窗格的可视性。

实例方法

addOverlay(overlay:IOverlay): void

用于向窗格中添加叠加层。

参数 类型 说明
overlay IOverlay

要添加到此窗格的叠加层。

bringToTop(overlay:IOverlay): void

用于将某一叠加层置于窗格上所有其他叠加层的顶端。

参数 类型 说明
overlay IOverlay

要置于顶端的叠加层。

clear(): void

用于删除所有添加到此窗格中的叠加层。

fromLatLngToPaneCoords(latLng:LatLng, closestToCenter?:Boolean): Point

用于将 latLng 转换为窗格的坐标系统。窗格显示的叠加层可使用此方法来确定其位置。窗格的坐标系统不一定与地图的坐标系统相匹配。

参数 类型 说明
latLng LatLng

要转换的位置的 LatLng。

closestToCenter? Boolean

如果为 true,则在显示多个地图副本时返回最接近地图中心的 x 坐标;如果为 false,则直接映射 latlng。

fromPaneCoordsToLatLng(point:Point, opt_nowrap?:Boolean): LatLng

用于将窗格坐标系统中的点转换为纬度/经度。窗格的坐标系统不一定与地图的坐标系统相匹配。

参数 类型 说明
point Point

窗格坐标系统中的一个点。

opt_nowrap? Boolean

用于决定是否保留经度值,无论该值是否位于 [-180, +180]。当此参数设置为 false(默认值)时,将会对经度进行处理使其位于 [-180, +180]。

fromPaneCoordsToProjectionPoint(point:Point): Point

根据地图的当前缩放级别,将窗格坐标系统中的点转换为投影点坐标。投影点是 IProjection.fromLatLngToPixel 传回的点(即点 (0,0) 位于具体缩放级别的地图的左上图块的左上角)。

参数 类型 说明
point Point

窗格中的像素坐标。

fromProjectionPointToPaneCoords(projectionPoint:Point): Point

用于将投影点坐标转换为窗格的局部坐标。

参数 类型 说明
projectionPoint Point

对象相对于地图原点(即点 (0,0) 位于具体缩放级别的地图的左上图块的左上角)的像素坐标。

getViewportBounds(): Rectangle

用于检索窗格坐标系统中的可视区域的范围。

invalidate(): void

用于使窗格上所有造成延迟更新的几何图形失效。

removeOverlay(overlay:IOverlay): void

用于从窗格中删除叠加层。

参数 类型 说明
overlay IOverlay

要从此窗格中删除的叠加层。

updatePosition(force?:Boolean): void

用于更新此窗格中对地图的更改(如平移和缩放)。

参数 类型 说明
force? Boolean

是否强制更新此窗格中的所有叠加层。

返回页首

IPaneManager 接口

这是地图的窗格管理器的接口。窗格管理器负责创建、删除以及重排地图上的叠加层窗格。

实现此类的对象既可以管理系统默认窗格,也可以管理由用户创建的窗格。

该 API 提供了 4 种默认窗格,它们以固定顺序呈现,从下往上依次为:

  • PaneId.PANE_MAP
  • PaneId.PANE_OVERLAYS
  • PaneId.PANE_MARKER
  • PaneId.PANE_FLOAT

您无法重排或删除这些默认窗格。但是,您可以添加、重排或者删除由用户创建的窗格。

窗格的顺序由一个从 0 开始的索引参数指定,其中 0 表示最底层(即紧靠地图)的窗格。如果插入由用户创建的窗格时指定的索引值已存在,则等于以及大于该值的现有索引值将会自动增加一个单位的值。例如,如果插入新窗格时指定的索引值为 2,则原有索引值 2、3、4 会变为 3、4、5。如果插入窗格时指定的索引值为 paneCount,则新插入的窗格将会位于所有现有窗格之上。

如果为某索引指定的值超过最大有效值,则会强制该索引值使用最大有效值。

字段概述

  • map
  • paneCount

方法概述

  • clearOverlays
  • containsPane
  • createPane
  • getPaneAt
  • getPaneById
  • getPaneIndex
  • placePaneAt
  • removeAllPanes
  • removePane

属性

名称 类型 说明
map IMap

对地图的引用。

paneCount int

可用窗格的总数。可用窗格包括默认窗格(此类窗格无法删除)和由用户创建的所有窗格。

实例方法

clearOverlays(): void

用于删除在所有窗格上注册的全部叠加层。

containsPane(pane:IPane): Boolean

用于检查窗格管理器是否包含指定的窗格。

参数 类型 说明
pane IPane  

createPane(index?:int): IPane

创建一个新窗格并将其添加到指定索引处,该索引应位于 0 至 paneCount 范围之内。

// Create a new pane lying immediately below the marker pane.
var manager:IPaneManager = map.getPaneManager();
var markerPane:IPane = manager.getPaneById(PaneId.PANE_MARKER);
var markerIndex:int = manager.getPaneIndex(markerPane);
var pane:IPane = manager.createPane(markerIndex);
参数 类型 说明
index? int

新窗格在窗格堆栈中的索引(如果未指定索引值或索引值为负,则会将此窗格添加到信息窗口窗格的正下方)。如果值为 0,则会将新窗格放置在当前所有窗格的下方。如果值为 paneCount,则会将新窗格放置在当前所有窗格的上方。如果值大于 paneCount,则会忽略超过该值的部分,其结果与值为 paneCount 的情况相同。

getPaneAt(index:int): IPane

返回位于指定索引处的窗格。如果指定的索引值超出有效范围,则返回 Null。

参数 类型 说明
index int

窗格的深度索引。

getPaneById(paneId:int): IPane

根据指定 ID 返回窗格。若要获取对默认窗格的引用,则需要使用此方法。

参数 类型 说明
paneId int

窗格 ID。

getPaneIndex(pane:IPane): int

返回指定窗格的深度索引。

参数 类型 说明
pane IPane

要返回其索引的窗格。

placePaneAt(pane:IPane, index:int): void

将窗格放置在指定的深度。更改窗格的索引值可以重新安排各个窗格之间相互间隔的深度。如果是默认窗格,则其相对顺序可能无法更改。

// Place myPane immediately above the overlays pane.
var manager:IPaneManager = map.getPaneManager();
var overlaysPane:IPane = manager.getPaneById(PaneId.PANE_OVERLAYS);
manager.placePaneAt(myPane, overlaysPane + 1);
参数 类型 说明
pane IPane

将更改其位置的窗格。

index int

窗格的深度索引。

removeAllPanes(): void

删除所有由用户创建的窗格。

removePane(pane:IPane): void

删除窗格。如果传递的是默认窗格,则此方法不会产生任何效果。

参数 类型 说明
pane IPane

要删除的窗格。

返回页首

IPolygon 接口

IPolygon 是由 Polygon 和用户创建的对等类实现的接口。Polygon 是代表多边形对象的地图叠加层。

多边形可以是由多个不相交的区域所组成的简单多边形,可以包含孔,也可以自相交。

起初,多边形存在“外部”边界和“内部”边界之分:一个多边形可以由一条外部边界和零条或多条内部边界组成。现在,这两者之间已经没有实质性的区别,可以直接表述为多边形由一条或多条边界组成。

一些方法名称仍能反映出原始的区别。如果某个多边形由 n 条边界组成,则包含“Outer”的方法将会返回有关边界 0 的信息;而包含“Inner”的方法将会返回有关边界 1...n-1 的信息,但会将索引偏移 1。如果方法中未包含这两个词,则将会返回有关边界 0...n-1 的信息。

例如,假定某个多边形由 5 条边界组成,则以下表达式对将会返回相同的结果:

getOuterVertexCount() getVertexCount(0)
getInnerVertexCount(2) getVertexCount(3)
getInnerPolylineCount() getPolylineCount() - 1
getVertex(4, 8) getInnerVertex(3, 8)

多边形会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现类

  • Polygon

方法概述

  • getInnerPolylineCount
  • getInnerVertex
  • getInnerVertexCount
  • getLatLngBounds
  • getOptions
  • getOuterVertex
  • getOuterVertexCount
  • getPolylineCount
  • getVertex
  • getVertexCount
  • removePolyline
  • setOptions
  • setPolyline
  • setPolylineFromEncoded

实例方法

getInnerPolylineCount(): int

用于传回组成此多边形内边界的折线的数目。

getInnerVertex(line:int, index:int): LatLng

用于传回指定内折线边界中具有指定索引的顶点的 LatLng。

参数 类型 说明
line int

内折线的索引。

index int

指定折线中目标顶点的索引。

getInnerVertexCount(line:int): int

用于传回指定内折线中的顶点数目。

参数 类型 说明
line int

内折线的索引。

getLatLngBounds(): LatLngBounds

用于传回此多边形的 LatLngBounds;如果多边形未包含任何点,则为 Null。

getOptions(): PolygonOptions

用于检索多边形的选项。使用 setOptions() 方法可修改多边形的选项。

getOuterVertex(index:int): LatLng

用于传回外部边界中具有指定索引的顶点。

参数 类型 说明
index int

目标顶点的索引。

getOuterVertexCount(): int

用于传回外折线中的顶点数目。

getPolylineCount(): int

用于传回组成此多边形边界的折线的数目。

getVertex(line:int, index:int): LatLng

从指定的折线边界返回具有指定索引的顶点的 LatLng。

参数 类型 说明
line int

折线的索引。

index int

指定的折线中目标顶点的索引。

getVertexCount(line:int): int

返回指定线条中的顶点数目。

参数 类型 说明
line int

线条的索引。

removePolyline(line:int): void

删除某条组成多边形的折线。

参数 类型 说明
line int

要删除的折线的索引。如果使用的值不对应于任何现有折线,则会引发异常。可接受的值在 [0, getPolylineCount()-1] 范围内。

setOptions(options:PolygonOptions): void

用于更新多边形的选项。options 参数可指定完整或部分多边形选项集。如果指定了部分选项集,它会补充现有的多边形选项,仅覆盖已明确设置的值,而保留其余值不变。例如,下面的代码段将会修改多边形的填充 alpha,而其余选项则保持不变。

var options:PolygonOptions =
    new PolygonOptions( { fillStyle: { alpha: 0.2 }} );
myPolygon.setOptions(options); 
参数 类型 说明
options PolygonOptions

新的完整或部分多边形选项集。

setPolyline(line:int, vertices:Array): void

添加或替换组成多边形的某条折线。

参数 类型 说明
line int

要添加的折线的索引。可接受的值在 [0, getPolylineCount()] 范围内。如果使用的值对应于一条现有折线,则会替换该现有折线。如果使用的值为getPolylineCount(),则会添加新的折线,而不会替换任何现有折线。如果使用的值超出接受范围,则引发异常。

vertices Array

LatLng 元素的数组。

setPolylineFromEncoded(line:int, encoded:EncodedPolylineData): void

使用编码折线数据添加或替换组成多边形的某条折线。

参数 类型 说明
line int

要添加的折线的索引。可接受的值在 [0, getPolylineCount()] 范围内。如果使用的值对应于一条现有折线,则会替换该现有折线。如果使用的值为 getPolylineCount(),则会添加新的折线,而不会替换任何现有折线。如果使用的值超出接受范围,则引发异常。

encoded EncodedPolylineData

编码折线数据。

返回页首

IPolyline 接口

IPolyline 是由 Polyline 和用户创建的对等类实现的接口。Polyline 是代表折线对象的地图叠加层,由顶点的列表创建。

折线会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现类

  • Polyline

方法概述

  • getLatLngBounds
  • getLength
  • getOptions
  • getVertex
  • getVertexCount
  • setOptions

实例方法

getLatLngBounds(): LatLngBounds

用于传回此折线或其后续折线的 LatLngBounds。如果此折线未包含任何点,则传回 Null。

getLength(opt_radius?:Number): Number

用于传回沿地球表面的折线的长度(以米为单位)。

参数 类型 说明
opt_radius? Number

球形天体对象的半径。

getOptions(): PolylineOptions

用于检索折线的选项。使用 setOptions() 方法可修改折线的选项。

getVertex(index:Number): LatLng

用于传回具有指定索引的顶点。

参数 类型 说明
index Number

目标顶点的索引。

getVertexCount(): Number

用于传回此折线中的顶点数目。

setOptions(options:PolylineOptions): void

用于更新折线选项。options 参数可指定完整或部分折线选项集。如果指定了部分选项集,它会补充现有的折线选项,仅覆盖已明确设置的值,而保留其余值不变。例如,下面的代码段将会修改折线的笔触粗细,而其余选项则保持不变。

var options:PolylineOptions =
    new PolylineOptions( { strokeStyle: { thickness: 3 }} );
myPolyline.setOptions(options); 
参数 类型 说明
options PolylineOptions

新的完整或部分折线选项集。

返回页首

IProjection 接口

IProjection 是用于地图投影的接口。地图投影实现器将会传递给 MapType 的构造函数。此接口通过所有预定义的地图类型使用的 MercatorProjection 来实现。如果您要定义使用不同地图投影的地图类型,则可以实现此接口。使用 ProjectionBase 类可实现自定义投影。

实现类

  • ProjectionBase

方法概述

  • fromLatLngToPixel
  • fromPixelToLatLng
  • getWrapWidth
  • tileCheckRange

实例方法

fromLatLngToPixel(latLng:LatLng, zoom:Number): Point

用于传回在指定的地理坐标和指定的缩放级别上的点的地图坐标(以像素为单位)。

参数 类型 说明
latLng LatLng

地理位置

zoom Number

缩放级别

fromPixelToLatLng(pixel:Point, zoom:Number, opt_nowrap?:Boolean): LatLng

用于传回在指定的地理坐标和指定的缩放级别上的点的地图坐标(以像素为单位)。

参数 类型 说明
pixel Point

地图坐标(以像素为单位)

zoom Number

缩放级别

opt_nowrap? Boolean

不处理 [-180, 180] 范围以外的经度

getWrapWidth(zoom:Number): Number

在 x 方向上传回至地图的周期,即多少像素数后地图会重复其本身(因为地图环绕地球一次)。默认情况下会传回无限值,即地图本身不重复。地图将使用此参数来计算叠加层在地图视图上的位置,这些地图视图包含多个 Google 地球副本(这通常仅在低缩放级别时出现)。

参数 类型 说明
zoom Number

缩放级别。

tileCheckRange(tile:Point, zoom:Number, tilesize:Number): Boolean

如果该地图类型的图块索引在有效范围内,则会传回至地图。否则地图将会显示空图块。如果地图包含地球的多个副本,则它还会修改图块索引以指向相同图块的其他实例,以及不同图块坐标上的相同图块。

参数 类型 说明
tile Point

图块坐标。

zoom Number

图块缩放坐标。

tilesize Number

此图块的大小。

返回页首

IScaleControl 接口

IScaleControl 是由 ScaleControl 实现的接口。ScaleControl 提供可显示地图比例的控件。

返回页首

IStyledMapType 接口

IStyledMapType 是由样式化地图类型对象实现的接口。样式化地图类型允许对 Google 的图块层应用自定义样式。

实现类

  • StyledMapType

方法概述

  • getStyle
  • setStyle

实例方法

getStyle(): Array

用于获取地图类型样式。

setStyle(style:Array): void

用于设置地图类型样式。

// Setting the style using an array of MapTypeStyle instance.
styledMapType.setStyle([
    new MapTypeStyle(MapTypeStyleFeatureType.ALL,
                     MapTypeStyleElementType.ALL,
                     [MapTypeStyleRule.saturation(-20)]),
    new MapTypeStyle(MapTypeStyleFeatureType.ROAD,
                     MapTypeStyleElementType.GEOMETRY,
                     [MapTypeStyleRule.hue(0xff0000)])]);
    ]);
// Setting the style using an array of objects.
styledMapType.setStyle([
    {elementType: 'all',
     featureType: 'all',
     stylers: [{saturation: -20}]},
    {elementType: 'geometry',
     featureType: 'road',
     stylers: [{hue: 0xff0000}]}]);
参数 类型 说明
style Array

MapTypeStyle 实例的数组。您也可以传入包含相应字段的非类型化对象的数组:通常,将样式指定为对象常量会更加简明。

返回页首

ITileLayer 接口

这是通过其他地图类型所用的图块层实现定义的接口。要定义自定义图块层,请使用 TileLayerBase 类。

实现类

  • TileLayerBase
  • TileLayerOverlay

方法概述

  • getAlpha
  • getCopyrightCollection
  • getMaxResolution
  • getMinResolution
  • loadTile

实例方法

getAlpha(): Number

用于传回图块层的视频剪辑的不透明度/alpha。getAlpha() 值的范围为 0.0 - 1.0。

getCopyrightCollection(): ICopyrightCollection

用于检索负责处理此图块层版权的版权模型集。

getMaxResolution(): Number

用于传回最细粒度的缩放级别。

getMinResolution(): Number

用于传回最粗粒度的缩放级别。

loadTile(tilePos:Point, zoom:Number): DisplayObject

用于在指定的缩放级别创建并载入图块 (x, y)。

参数 类型 说明
tilePos Point

图块坐标。

zoom Number

图块缩放。

返回页首

ITileLayerOverlay 接口

实现类

  • TileLayerOverlay

字段概述

  • projection
  • tileLayer
  • tileSize

方法概述

  • refresh

属性

名称 类型 说明
projection IProjection

用于计算图块位置的投影。

tileLayer ITileLayer

用于叠加层的图块层。

tileSize int

图块大小。

实例方法

refresh(): void

用于刷新图块层叠加层,强制重新加载所有图块。

如果使用此方法,应该注意图块并非只是简单地从浏览器缓存中重新载入。一种方法是为图块提供合适的 HTTP 标头,确保决不缓存图块。另一种方法是修改重新载入图块时要使用的网址(例如附加哑元查询参数),以确保浏览器可以区分新的载入与原始的载入。

返回页首

IWrappable 接口

IWrappable 是基础接口,适用于提供 AS3 跨域脚本编写功能的所有对象。

字段概述

  • interfaceChain
  • wrapper

属性

名称 类型 说明
interfaceChain Array

用于包装此对象的接口列表。在跨域通信中使用这些接口。

wrapper Object

此对象的跨域包装程序的实例。

返回页首

IWrappableEventDispatcher 接口

IWrappableEventDispatcher 是基础接口,适用于提供跨域事件分派功能的所有对象。

方法概述

  • getBaseEventDispatcher

实例方法

getBaseEventDispatcher(): Object

用于检索基础事件的 dispatcher 对象,该对象允许访问跨域对象的事件分派功能。

返回页首

EncodedPolylineData 类

EncodedPolylineData 类表示创建编码折线所需的一组数据。

字段概述

  • levels
  • numLevels
  • points
  • zoomFactor

构造函数概述

  • EncodedPolylineData

属性

名称 类型 说明
levels String

包含编码折线缩放级别组的字符串。

numLevels Number

编码级别字符串中包含的缩放级别数。

points String

包含编码纬度和经度坐标的字符串。

zoomFactor Number

编码级别字符串中的两个临近缩放级别组之间的放大率。

构造函数

EncodedPolylineData(points:String, zoomFactor:Number, levels:String, numLevels:Number)

构造函数。

参数 类型 说明
points String

包含编码纬度和经度坐标的字符串。

zoomFactor Number

编码级别字符串中的两个临近缩放级别组之间的放大率。

levels String

包含编码折线缩放级别组的字符串。

numLevels Number

编码级别字符串中包含的缩放级别数。

返回页首

GroundOverlay 类

GroundOverlay 放置在地图内容之上的图像,它的各个角是通过纬度/经度对来定位的。

地面叠加层会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现

  • IGroundOverlay
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • shadow
  • visible

构造函数概述

  • GroundOverlay

方法概述

  • getDefaultPane
  • getOptions
  • hide
  • isHidden
  • positionOverlay
  • setOptions
  • show

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

visible Boolean

叠加层的可视性。

构造函数

GroundOverlay(content:DisplayObject, bounds:LatLngBounds, options?:GroundOverlayOptions)

使用指定的选项构造新的 GroundOverlay 实例。

参数 类型 说明
content DisplayObject

要显示的内容。

bounds LatLngBounds

图片延伸的纬度和经度范围。

options? GroundOverlayOptions

地面叠加层选项。

实例方法

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

getOptions(): GroundOverlayOptions

用于检索地面叠加层使用的完整选项集。使用 setOptions 方法可修改地面叠加层的选项。

hide(): void

isHidden(): Boolean

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

setOptions(options:GroundOverlayOptions): void

用于更新地面叠加层的选项。options 参数可指定完整或部分地面叠加层选项集。如果指定了部分选项集,它会补充现有的标记选项,仅覆盖已明确设置的值,而保留其余值不变。

// Modify the ground overlay's stroke colour, leaving the rest
// of its options unchanged.
var options:GroundOverlayOptions =
    new GroundOverlayOptions( { strokeStyle: { color: 0x000080 }} );
myGroundOverlay.setOptions(options);
参数 类型 说明
options GroundOverlayOptions

新的完整或部分地面叠加层选项集。

show(): void

返回页首

GroundOverlayOptions 类

GroundOverlayOptions 类用于为 GroundOverlay 指定一组呈现参数。

字段概述

  • applyProjection
  • renderContent
  • rotation
  • rotationContentCenter
  • strokeStyle

构造函数概述

  • GroundOverlayOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

属性

名称 类型 说明
applyProjection Object

布尔值,用于指定叠加层是否需要投影。如果为 true,则会在呈现叠加层时应用地图投影。如果为 false,则认为已对叠加层进行投影。默认值为 false。

renderContent Object

布尔值,用于指定是呈现地面叠加层内容的图像,还是只将该图像附加到显示列表并设置相应的几何图形转换。

从第 1.11 版开始,默认的行为是呈现叠加层内容的图像。这种方法的功能更强,但操作简单,只需为显示列表中的元素设置几何图形变换。此方法支持更多 2D/3D 显示的组合,支持使用 applyProjection 和旋转,并可以生成叠加层内容的平滑图像。

如果想继续使用旧实现,则可将该属性的值设置为 false。但是如果您执行了此操作,系统将:

  • 不支持 3D;
  • 忽略 applyProjection
  • 不会应用平滑。
rotation Object

一个数值,用于指定地面叠加层的旋转度(指定顺时针方向的旋转度数)。请注意,3D 查看模式(通过 Map3D 创建并使用View.VIEWMODE_PERSPECTIVE 和 View.VIEWMODE_ORTHOGONAL 的地图)不支持旋转。

旋转的行为方式取决于 applyProjection 的值是 true 还是 false

如果为 false,则认为已对地面叠加层内容进行投影。仅在视口空间中应用旋转。

如果为 true,则会将地面叠加层内容映射到球面上。绕轴应用旋转,该轴连接球心和球面上对应于 rotationContentCenter的点。然后应用地图投影,在平面地图上生成地面叠加层的图像。请注意,如果使用这种转换顺序,则原始内容中的直线会变为曲线。

rotationContentCenter Point

内容坐标中的地面叠加层旋转中心。这是旋转所围绕的地面叠加层内容坐标中的点。如果未设置该点,那么将围绕内容中心进行旋转。

strokeStyle StrokeStyle

地面叠加层笔触样式。

构造函数

GroundOverlayOptions(param?:Object)

用于构造新的 GroundOverlayOptions 对象,可以选择通过某个对象对其进行初始化。

var options:GroundOverlayOptions = new GroundOverlayOptions({
  strokeStyle: {
    color: 0x987654,
    alpha: 0.8,
    thickness: 3,
    pixelHinting: true
  },
  rotation: 90,
  applyProjection: true,
  renderContent: true
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

静态方法

getDefaultOptions(): GroundOverlayOptions

用于检索 GroundOverlayOptions 实例,该实例表示应用于所有地面叠加层的默认选项集。

// Initialization object corresponding to the initial defaults.
{ strokeStyle:
  { thickness: 0,
    alpha: 0.0,  // invisible
    color: Color.BLACK,
    pixelHinting: false
  },
  rotation: 0,
  applyProjection: false,
  renderContent: true
}

setDefaultOptions(defaults:GroundOverlayOptions): void

用于更新默认的 GroundOverlayOptions。这些默认选项将应用于调用 setDefaultOptions 方法后创建的所有地面叠加层。单个地面叠加层还可以指定其自己的选项集。单个选项的优先级要高于默认选项。defaults 参数可指定完整或部分地面叠加层选项集。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults GroundOverlayOptions

一组新的地面叠加层默认选项。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

Marker 类

Marker 对象用于标记地图上的位置,它可用于实现 IOverlay 接口,并可通过 Map.addOverlay() 方法添加到地图中。

标记与纬度和经度相关联,可用于确定其图标在地图上的锚定点的地理位置。

它可以呈现默认图标,也可以显示由开发人员提供的自定义图标。您可以使用 Marker.setOptions() 方法指定自定义图标(或标准图标的呈现选项)。

标记会在移动或用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.DRAG_START
  • MapMouseEvent.DRAG_STEP
  • MapMouseEvent.DRAG_END
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK
  • MapMouseEvent.OVERLAY_MOVED
  • MapEvent.OVERLAY_ANIMATE_END

请注意,任意已分派 MapMouseEvent 上的 latLng 属性承载的是标记当前的纬度和经度,而不是鼠标指针正下方的位置的纬度和经度。在这一点上,标记的行为与其他叠加层存在差异。

实现

  • IMarker
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • shadow
  • visible

构造函数概述

  • Marker

方法概述

  • closeInfoWindow
  • getDefaultPane
  • getLatLng
  • getOptions
  • hide
  • isHidden
  • openInfoWindow
  • positionOverlay
  • setLatLng
  • setOptions
  • show

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

visible Boolean

叠加层的可视性。

构造函数

Marker(latLng:LatLng, options?:MarkerOptions)

使用指定的选项在指定纬度-经度处构造新标记。

参数 类型 说明
latLng LatLng

标记的位置。

options? MarkerOptions

完整或部分标记选项集。如果指定了部分选项集,则标记的完整选项集将是相应的部分选项及使用 MarkerOptions.setDefaultOptions() 调用设置的现有默认选项的组合。

实例方法

closeInfoWindow(): void

如果信息窗口与此标记关联,则会关闭信息窗口。

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

getLatLng(): LatLng

用于检索标记的位置。

getOptions(): MarkerOptions

用于检索标记使用的完整选项集。使用 setOptions 方法可修改标记选项。

hide(): void

isHidden(): Boolean

openInfoWindow(options?:InfoWindowOptions, useSeparatePane?:Boolean): IInfoWindow

打开位于标记上方的信息窗口。

参数 类型 说明
options? InfoWindowOptions

信息窗口选项。

useSeparatePane? Boolean

如果为 true,则会将信息窗口放置在其自身的窗格上。使用 Map3D 时,默认行为是将信息窗口放置到此标记所在的同一窗格上,从而将信息窗口放置在相同深度。将此参数设置为 true,可强制使行为与使用二维地图时一致(信息窗格放置在其自身的窗格上)。

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

setLatLng(value:LatLng): void

用于更改标记的 LatLng。

参数 类型 说明
value LatLng

标记的新 LatLng 位置。

setOptions(options:MarkerOptions): void

用于更新标记选项。options 参数可指定完整或部分标记选项集。如果指定了部分选项集,它会补充现有的标记选项,仅覆盖已明确设置的值,而保留其余值不变。

// Modify the marker's fill colour, leaving the rest
// of its options unchanged.
var options:MarkerOptions =
    new MarkerOptions( { fillStyle: { color: 0x000080 }} );
myMarker.setOptions(options);
参数 类型 说明
options MarkerOptions

新的完整或部分标记选项集。

show(): void

返回页首

MarkerOptions 类

MarkerOptions 类用于为 Marker 指定一组呈现参数。

字段概述

  • ALIGN_BOTTOM
  • ALIGN_HORIZONTAL_CENTER
  • ALIGN_LEFT
  • ALIGN_RIGHT
  • ALIGN_TOP
  • ALIGN_VERTICAL_CENTER
  • clickable
  • distanceScaling
  • draggable
  • fillStyle
  • gravity
  • hasShadow
  • icon
  • iconAlignment
  • iconOffset
  • iconShadow
  • label
  • labelFormat
  • radius
  • strokeStyle
  • tooltip

构造函数概述

  • MarkerOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

常数

名称 说明
ALIGN_BOTTOM 0x20

使对象底部对齐

ALIGN_HORIZONTAL_CENTER 1

使对象中心对齐(水平方向)

ALIGN_LEFT 0

使对象左对齐

ALIGN_RIGHT 2

使对象右对齐

ALIGN_TOP 0x00

使对象顶部对齐

ALIGN_VERTICAL_CENTER 0x10

使对象中心对齐(垂直方向)

属性

名称 类型 说明
clickable Object

一个布尔值,用于指定是否可点击标记。不可点击的标记不会生成 MapMouseEvent.CLICK 或 MapMouseEvent.DOUBLE_CLICK 事件,不过,如果可以拖动,则仍会触发其他事件。当光标悬停在不可点击的标记上时,不会在标记上呈现手形光标图标。必须明确将此属性设置为 false 才能使标记不可点击。

distanceScaling Object

布尔值,用于指定是否在三维地图上根据距离缩放标记。如果不是显示三维地图,则可以忽略此属性。

draggable Object

一个布尔值,用于指定是否可以在地图周围拖动标记。

fillStyle FillStyle

标记的填充样式。

gravity Object

一个数值,用于指定标记的重力因子。

hasShadow Object

一个布尔值,用于指定标记是否具有阴影。如果标记采用的是自定义图标,则必须可以对图标内容进行跨脚本访问以便生成阴影(如果载入标记的域不同于地图应用的源域的话)。

icon DisplayObject

用于显示用作标记自定义图标的对象。请注意,指定为图标的显示对象实例仅能用于单个标记(因为将会通过 addChild() 调用将其添加到标记中,并且无法重用)。如果将相同的图片或视频剪辑同时添加到多个不同的标记,则需要为每个标记分别创建该图片(或视频剪辑)的单独实例。

iconAlignment Object

一个数值,用于指定标记上的哪个点用于对齐图标(相对于图标所代表的 LatLng)。使用 MarkerOptions.ALIGN 标记的组合可指定对齐方式。

iconOffset Point

标记的自定义图标偏移。使用自定义图标时,此参数可指定标记的目标位置相对于自定义图标的对齐点的偏移。

iconShadow DisplayObject

用于创建自定义标记图标的阴影的显示对象。

请注意,大部分情况下系统会自动生成阴影,您不必设置此属性。只有以下情况例外:从其中加载自定义图标的域与您的地图 swf 或 Google 的库 (maps.googleapis.com) 所处的域不同,且缺少授予从上述某个域访问图标像素的权限的 crossdomain.xml 文件。

如果您设置了此属性,则系统会停止生成常规阴影,而改为将阴影过滤器附到您传入的显示对象上。

您无法同时对 icon 和 iconShadow 使用同一对象。如果要加载外部内容,请加载两份副本(分别对应两个属性)。

label String

标记的标签文本。设置标签文本会删除任何自定义的图标,并且会应用标准呈现来绘制标记。

labelFormat TextFormat

标记的标签文本格式。

radius Object

一个数值,用于指定标记半径。

strokeStyle StrokeStyle

标记的笔触样式。

tooltip String

标记的工具提示文本。

构造函数

MarkerOptions(param?:Object)

用于构造新的 MarkerOptions 对象,可以选择通过某个对象对其进行初始化。

var options:MarkerOptions = new MarkerOptions({
  strokeStyle: {
    color: 0x987654
  },
  fillStyle: {
    color: 0x223344,
    alpha: 0.8
  },
  label: "Z",
  labelFormat: {
    bold: true
  },
  tooltip: "This is a marker",
  radius: 12,
  hasShadow: true,
  clickable: false,
  draggable: true,
  gravity: 0.5,
  distanceScaling: false
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

静态方法

getDefaultOptions(): MarkerOptions

用于检索 MarkerOptions 实例,该实例表示应用于所有标记的默认选项集。

// Initialization object corresponding to the initial defaults.
{ strokeStyle: {
    thickness: 2,
    alpha: 1.0,
    color:Color.BLACK,
    pixelHinting: false
  },
  fillStyle: {
    color: 0xFF766A,
    alpha: 1.0
  },
  labelFormat: {
    font: "_sans",
    size: 12,
    color: Color.BLACK
  },
  gravity: 0.8,
  radius: 9,
  hasShadow: true,
  draggable: false,
  distanceScaling: false
}

setDefaultOptions(defaults:MarkerOptions): void

用于设置在创建新标记时应用的默认选项集。这些默认选项将应用于调用 setDefaultOptions 方法后创建的所有标记。单个标记还可以指定其自己的选项集。单个选项的优先级要高于默认选项。defaults 参数可指定完整或部分标记选项集。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults MarkerOptions

一组新的默认标记选项。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

OverlayBase 类

这是自定义叠加层的基础类。开发人员可以扩展此类以创建自己的叠加层实现。

OverlayBase 代表应该用于呈现叠加层前景的可见对象。

OverlayBase 的默认实现可定义没有阴影的叠加层。如果需要阴影,则开发人员需要创建单独的显示对象并覆盖 get shadow 属性存取器,才能启用阴影。

除了呈现叠加层的前景和阴影(如果需要)之外,所有自定义叠加层还应定义 positionOverlay() 方法,当用户平移或缩放地图时,该方法可以更改叠加层在其窗格上的位置。IPane.fromLatLngToPaneCoords() 和 IPane.fromProjectionPointToPaneCoords() 可用于确定叠加层在窗格上的位置。

在实现 positionOverlay() 方法时,自定义叠加层最好避免执行过多的呈现操作。如果在地图上放置大量叠加层,则地图就会频繁调用此方法,并会在每次调用时重新呈现叠加层,这样可能会降低应用程序的性能。

实现自定义叠加层可能还需要为 MapEvent.OVERLAY_ADDED 和 MapEvent.OVERLAY_REMOVED 事件定义监听器,以处理向地图添加和从地图上删除叠加层的操作。

实现

  • IOverlay
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • shadow
  • visible

构造函数概述

  • OverlayBase

方法概述

  • getDefaultPane
  • positionOverlay

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层前景内容的对象。

pane IPane

此叠加层所在的窗格。窗格是在将叠加层添加到地图中时设置的。

开发人员可以重写 set pane 方法,以处理地图叠加层的添加/删除操作。

或者,开发人员也可以为叠加层上的 MapEvent.OVERLAY_ADDED 和 MapEvent.OVERLAY_REMOVED 事件添加监听器,以处理地图叠加层的添加/删除操作。

shadow DisplayObject

用于代表叠加层阴影的显示对象。默认情况下会返回 null(无阴影)。

如果叠加层需要具有阴影,则您应当在将叠加层添加到地图之前重新定义该方法属性,并设置 shadow 值。

在将叠加层添加到地图中时,此属性传回的显示对象应该保持不变。

visible Boolean

叠加层的可视性。

构造函数

OverlayBase()

构造函数。

实例方法

getDefaultPane(map:IMap): IPane

当此方法通过 Map.addOverlay() 调用被添加到地图上时,可用于确定叠加层所放置的窗格。

要使 Map.addOverlay() 调用正常发挥作用,该方法必须过载。如果始终使用 IPane.addOverlay() 调用将叠加层直接添加到其窗格,则不需要执行上述操作。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。

当地图的位置(中心)和/或地图的缩放级别发生变化时,系统会调用此方法以作出响应。开发人员不应自行调用此方法。

要实现此方法,您应更改叠加层在屏幕上的位置,以响应地图中心的变化,或完全重新绘制叠加层(如果需要重新配置叠加层,以适应不同的地图中心/缩放级别的话)。

应使用 IPane 接口(fromLatLngToPaneCoords() 或 fromProjectionPointToPaneCoords())提供的映射来更改叠加层的显示对象在其窗格上的位置,从而重新定位叠加层。

默认实现中不会实现此方法,必须在派生类中重载它才能正常工作。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

返回页首

Polygon 类

Polygon 类用于定义地图上显示的多边形。

多边形可以是由多个不相交的区域所组成的简单多边形,可以包含孔,也可以自相交。

起初,多边形存在“外部”边界和“内部”边界之分:一个多边形可以由一条外部边界和零条或多条内部边界组成。现在,这两者之间已经没有实质性的区别,可以直接表述为多边形由一条或多条边界组成。

一些方法名称仍能反映出原始的区别。如果某个多边形由 n 条边界组成,则包含“Outer”的方法将会返回有关边界 0 的信息;而包含“Inner”的方法将会返回有关边界 1...n-1 的信息,但会将索引偏移 1。如果方法中未包含这两个词,则将会返回有关边界 0...n-1 的信息。

例如,假定某个多边形由 5 条边界组成,则以下表达式对将会返回相同的结果:

getOuterVertexCount() getVertexCount(0)
getInnerVertexCount(2) getVertexCount(3)
getInnerPolylineCount() getPolylineCount() - 1
getVertex(4, 8) getInnerVertex(3, 8)

多边形会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现

  • IPolygon
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • shadow
  • visible

构造函数概述

  • Polygon

方法概述

  • fromEncoded
  • getDefaultPane
  • getInnerPolylineCount
  • getInnerVertex
  • getInnerVertexCount
  • getLatLngBounds
  • getOptions
  • getOuterVertex
  • getOuterVertexCount
  • getPolylineCount
  • getVertex
  • getVertexCount
  • hide
  • isHidden
  • positionOverlay
  • removePolyline
  • setOptions
  • setPolyline
  • setPolylineFromEncoded
  • show

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

visible Boolean

叠加层的可视性。

构造函数

Polygon(points:Array, options?:PolygonOptions)

使用指定的选项构造连接指定纬度和经度的新多边形。

要根据经过编码的数据创建多边形,您既可以使用静态方法 fromEncoded(),也可以创建一个空多边形并调用其 setPolylineFromEncoded() 方法。

要创建由多条边界组成的多边形,可以结合使用 fromEncoded()setPolyline() 和 setPolylineFromEncoded() 方法。

参数 类型 说明
points Array

LatLng 顶点位置的数组。如果是构建空多边形,则为 Null。

options? PolygonOptions

完整或部分多边形选项集。如果指定了部分选项集,则多边形的完整选项集将是相应部分选项及其默认选项的组合。

静态方法

fromEncoded(polylineList:Array, options?:PolygonOptions): Polygon

根据经过编码的数据构建多边形。

请注意,虽然可以创建 Polygon 的子类,但不能使用 fromEncoded() 方法创建子类的实例。如果您需要这样灵活选择,则应自己创建子类的实例,然后调用setPolylineFromEncoded() 设置子类的边界。

参数 类型 说明
polylineList Array

折线的 EncodedPolylineData 对象数组。

options? PolygonOptions

完整或部分多边形选项集。如果指定了部分选项集,则多边形的完整选项集将是相应的部分选项及使用 PolygonOptions.setDefaultOptions() 调用设置的现有默认选项的组合。

实例方法

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

getInnerPolylineCount(): int

用于传回组成此多边形内边界的折线的数目。

getInnerVertex(line:int, index:int): LatLng

用于传回指定内折线边界中具有指定索引的顶点的 LatLng。

参数 类型 说明
line int

内折线的索引。

index int

指定折线中目标顶点的索引。

getInnerVertexCount(line:int): int

用于传回指定内折线中的顶点数目。

参数 类型 说明
line int

内折线的索引。

getLatLngBounds(): LatLngBounds

用于传回此多边形的 LatLngBounds;如果多边形未包含任何点,则为 Null。

getOptions(): PolygonOptions

用于检索多边形的选项。使用 setOptions() 方法可修改多边形的选项。

getOuterVertex(index:int): LatLng

用于传回外部边界中具有指定索引的顶点。

参数 类型 说明
index int

目标顶点的索引。

getOuterVertexCount(): int

用于传回外折线中的顶点数目。

getPolylineCount(): int

用于传回组成此多边形边界的折线的数目。

getVertex(line:int, index:int): LatLng

从指定的折线边界返回具有指定索引的顶点的 LatLng。

参数 类型 说明
line int

折线的索引。

index int

指定的折线中目标顶点的索引。

getVertexCount(line:int): int

返回指定线条中的顶点数目。

参数 类型 说明
line int

线条的索引。

hide(): void

isHidden(): Boolean

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

removePolyline(line:int): void

删除某条组成多边形的折线。

参数 类型 说明
line int

要删除的折线的索引。如果使用的值不对应于任何现有折线,则会引发异常。可接受的值在 [0, getPolylineCount()-1] 范围内。

setOptions(options:PolygonOptions): void

用于更新多边形的选项。options 参数可指定完整或部分多边形选项集。如果指定了部分选项集,它会补充现有的多边形选项,仅覆盖已明确设置的值,而保留其余值不变。例如,下面的代码段将会修改多边形的填充 alpha,而其余选项则保持不变。

var options:PolygonOptions =
    new PolygonOptions( { fillStyle: { alpha: 0.2 }} );
myPolygon.setOptions(options); 
参数 类型 说明
options PolygonOptions

新的完整或部分多边形选项集。

setPolyline(line:int, vertices:Array): void

添加或替换组成多边形的某条折线。

参数 类型 说明
line int

要添加的折线的索引。可接受的值在 [0, getPolylineCount()] 范围内。如果使用的值对应于一条现有折线,则会替换该现有折线。如果使用的值为getPolylineCount(),则会添加新的折线,而不会替换任何现有折线。如果使用的值超出接受范围,则引发异常。

vertices Array

LatLng 元素的数组。

setPolylineFromEncoded(line:int, encoded:EncodedPolylineData): void

使用编码折线数据添加或替换组成多边形的某条折线。

参数 类型 说明
line int

要添加的折线的索引。可接受的值在 [0, getPolylineCount()] 范围内。如果使用的值对应于一条现有折线,则会替换该现有折线。如果使用的值为 getPolylineCount(),则会添加新的折线,而不会替换任何现有折线。如果使用的值超出接受范围,则引发异常。

encoded EncodedPolylineData

编码折线数据。

show(): void

返回页首

PolygonOptions 类

PolygonOptions 类用于为多边形指定一组呈现参数。

字段概述

  • fillStyle
  • strokeStyle
  • tooltip

构造函数概述

  • PolygonOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

属性

名称 类型 说明
fillStyle FillStyle

多边形的填充样式。

strokeStyle StrokeStyle

多边形的笔触样式。

tooltip String

多边形的工具提示文本。

构造函数

PolygonOptions(param?:Object)

用于构造新的 PolygonOptions 对象,可以选择通过某个对象对其进行初始化。

var options:PolygonOptions = new PolygonOptions({
  strokeStyle: {
    thickness: 3,
    color: 0x123456,
    alpha: 0.5,
    pixelHinting: true
  },
  fillStyle: {
    color: 0xff0080,
    alpha: 0.8
  },
  tooltip: "Some info",
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

静态方法

getDefaultOptions(): PolygonOptions

用于检索 PolygonOptions 实例,该实例表示应用于所有多边形的默认选项集。

// Initialization object corresponding to the initial defaults.
{ fillStyle:
  { color: 0x0000FF,  // blue
    alpha: 0.25
  },
  strokeStyle:
  { color: 0x0055FF,  // blue
    alpha: 0.45,
    thickness: 2,
    pixelHinting: false
  }
}

setDefaultOptions(defaults:PolygonOptions): void

用于设置在创建新多边形时应用的默认选项集。还可以为每个单独的多边形设置选项,在这种情况下,为单个多边形指定的选项的优先级要高于默认选项。defaults 参数可指定完整或部分多边形选项集。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults PolygonOptions

新的默认完整或部分多边形选项集。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

Polyline 类

Polygon 类用于定义在地图上绘制多边形的地图叠加层。

折线会在用户与之交互时分派以下事件:

  • MapMouseEvent.MOUSE_DOWN
  • MapMouseEvent.MOUSE_UP
  • MapMouseEvent.MOUSE_MOVE
  • MapMouseEvent.ROLL_OVER
  • MapMouseEvent.ROLL_OUT
  • MapMouseEvent.CLICK
  • MapMouseEvent.DOUBLE_CLICK

任意已分派 MapMouseEvent 上的 latLng 属性用于存放位于鼠标指针正下方的位置的纬度/经度。

实现

  • IPolyline
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • shadow
  • visible

构造函数概述

  • Polyline

方法概述

  • fromEncoded
  • getDefaultPane
  • getLatLngBounds
  • getLength
  • getOptions
  • getVertex
  • getVertexCount
  • hide
  • isHidden
  • positionOverlay
  • setOptions
  • show

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

visible Boolean

叠加层的可视性。

构造函数

Polyline(points:Array, options?:PolylineOptions)

用于使用指定的选项在指定纬度-经度处构造新折线。要通过一组编码点来创建折线,请使用 fromEncoded() 方法。

参数 类型 说明
points Array

LatLng 顶点位置的数组。

options? PolylineOptions

完整或部分折线选项集。如果指定了部分选项集,则折线的完整选项集将是相应的部分选项集及其默认选项的组合。

静态方法

fromEncoded(info:EncodedPolylineData, options?:PolylineOptions): Polyline

如果指定了缩放级别的数目以及缩放级别间的缩放系数,则通过一组指定的编码点和缩放级别可构造折线。编码格式会将折线点表示为一个以 E6 表示的纬度/经度坐标的平面数组。

参数 类型 说明
info EncodedPolylineData

包含折线数据的 EncodedPolylineData 对象。

options? PolylineOptions

完整或部分折线选项集。如果指定了部分选项集,则折线的完整选项集将是相应的部分选项及使用 PolylineOptions.setDefaultOptions() 调用设置的现有默认选项的组合。

实例方法

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

getLatLngBounds(): LatLngBounds

用于传回此折线或其后续折线的 LatLngBounds。如果此折线未包含任何点,则传回 Null。

getLength(opt_radius?:Number): Number

用于传回沿地球表面的折线的长度(以米为单位)。

参数 类型 说明
opt_radius? Number

球形天体对象的半径。

getOptions(): PolylineOptions

用于检索折线的选项。使用 setOptions() 方法可修改折线的选项。

getVertex(index:Number): LatLng

用于传回具有指定索引的顶点。

参数 类型 说明
index Number

目标顶点的索引。

getVertexCount(): Number

用于传回此折线中的顶点数目。

hide(): void

isHidden(): Boolean

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

setOptions(options:PolylineOptions): void

用于更新折线选项。options 参数可指定完整或部分折线选项集。如果指定了部分选项集,它会补充现有的折线选项,仅覆盖已明确设置的值,而保留其余值不变。例如,下面的代码段将会修改折线的笔触粗细,而其余选项则保持不变。

var options:PolylineOptions =
    new PolylineOptions( { strokeStyle: { thickness: 3 }} );
myPolyline.setOptions(options); 
参数 类型 说明
options PolylineOptions

新的完整或部分折线选项集。

show(): void

返回页首

PolylineOptions 类

PolylineOptions 类用于为折线指定一组呈现参数。

字段概述

  • geodesic
  • strokeStyle

构造函数概述

  • PolylineOptions

方法概述

  • getDefaultOptions
  • setDefaultOptions
  • toString

属性

名称 类型 说明
geodesic Object

一个布尔值,用于指定这是否为一条测地折线。

strokeStyle StrokeStyle

折线的笔触样式。

构造函数

PolylineOptions(param?:Object)

用于构造新的 PolylineOptions 对象,可以选择通过某个对象对其进行初始化。

var options:PolylineOptions = new PolylineOptions({
  strokeStyle: {
    thickness: 3,
    color: 0x123456,
    alpha: 0.5,
    pixelHinting: true
  }
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

静态方法

getDefaultOptions(): PolylineOptions

用于检索 PolylineOptions 实例,该实例表示应用于所有折线的默认选项集。

// Initialization object corresponding to the initial defaults.
{ strokeStyle:
  { color: 0x0000FF,  // blue
    alpha: 0.45,
    thickness: 5,
    pixelHinting: false
  }
}

setDefaultOptions(defaults:PolylineOptions): void

用于设置在创建新折线时应用的默认选项集。还可以为每条单独的折线设置选项,在这种情况下,为单条折线指定的选项的优先级要高于默认选项。defaults 参数可指定完整或部分折线选项集。如果指定了部分选项集,它会补充现有的默认选项,仅覆盖已明确设置的值,而保留其余值不变。

参数 类型 说明
defaults PolylineOptions

新的默认完整或部分折线选项集。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

TileLayerOverlay 类

TileLayerOverlay 是一种叠加层类型,用于将自定义图块层添加到地图上特定于 MapType 的图块层顶端。

实现

  • ITileLayerOverlay
  • flash.events.IEventDispatcher

字段概述

  • foreground
  • pane
  • projection
  • shadow
  • tileLayer
  • tileSize
  • visible

构造函数概述

  • TileLayerOverlay

方法概述

  • getDefaultPane
  • positionOverlay
  • refresh

属性

名称 类型 说明
foreground DisplayObject

用于显示代表叠加层内容的对象。

pane IPane

此叠加层所在的窗格(如果叠加层未添加到地图中,则为 Null)。当从地图中添加或删除叠加层后,地图会设置此属性值,并且开发人员不应修改此值。

projection IProjection

用于计算图块位置的投影。

shadow DisplayObject

用于显示代表叠加层阴影的对象(如果叠加层从未包含阴影,则为 Null)。

tileLayer ITileLayer

用于叠加层的图块层。

tileSize int

图块大小。

visible Boolean

叠加层的可视性。

构造函数

TileLayerOverlay(tileLayer:ITileLayer, tileSize?:int, projection?:IProjection)

TileLayerOverlay 构造函数。

参数 类型 说明
tileLayer ITileLayer

叠加层使用的图块层。

tileSize? int

图块大小(默认为 256)。

projection? IProjection

叠加层使用的投影(如果未设置,则默认情况下将会使用墨卡托投影)。

实例方法

getDefaultPane(map:IMap): IPane

通过调用 IMap.addOverlay() 添加叠加层时,如果未明确指定窗格,则此方法会检索该叠加层应该所处的默认窗格。

参数 类型 说明
map IMap

此叠加层添加到的地图实例。

positionOverlay(zoomChanged:Boolean): void

重新定位叠加层在屏幕上的位置。地图位置(中心)和/或地图缩放级别发生变化时,系统会调用此方法作出响应。开发人员不应自行调用此方法。此方法的实现应更改叠加层在屏幕上的位置以响应地图中心的变化,或者应完全重新绘制叠加层(如果需要为其他地图中心/缩放级别重新配置叠加层的话)。应使用 IPane 接口(fromLatLngToPaneCoords 或 fromProjectionPointToPaneCoords)提供的映射更改叠加层的显示对象在其窗格上的位置,重新定位叠加层。

参数 类型 说明
zoomChanged Boolean

是更改了地图的缩放级别,还是仅因地图平移而进行了此调用。

refresh(): void

用于刷新图块层叠加层,强制重新加载所有图块。

如果使用此方法,应该注意图块并非只是简单地从浏览器缓存中重新载入。一种方法是为图块提供合适的 HTTP 标头,确保决不缓存图块。另一种方法是修改重新载入图块时要使用的网址(例如附加哑元查询参数),以确保浏览器可以区分新的载入与原始的载入。

返回页首

ClientGeocoder 类

ClientGeocoder 对象可与 Google 服务器进行通信,以获取对用户指定地址的地址解析。另外,地址解析器可以维护自己的地址缓存,这样,无需往返于服务器即可回答重复的查询。

请注意,在从地图接收到 MapEvent.MAP_READY 事件之前,不能使用 ClientGeocoder

实现

  • IClientGeocoder
  • flash.events.IEventDispatcher

构造函数概述

  • ClientGeocoder

方法概述

  • geocode
  • getBaseCountryCode
  • getOptions
  • getViewport
  • resetCache
  • reverseGeocode
  • setBaseCountryCode
  • setOptions
  • setViewport

构造函数

ClientGeocoder(options?:ClientGeocoderOptions)

用于构造执行地址解析的 ClientGeocoder 实例。

// Deprecated and new-style code for creating a ClientGeocoder.
// Old-style code (prior to version 1.8).
var geocoder:ClientGeocoder = new ClientGeocoder("AU", myLatLngBounds);
   // New-style code
var geocoder:ClientGeocoder = new ClientGeocoder(
    new ClientGeocoderOptions({
      countryCode: "AU",
      viewport: myLatLngBounds
    }));
参数 类型 说明
options? ClientGeocoderOptions

完整或部分地址解析选项集。如果指定了部分选项集,则地址解析器对象的完整选项集将是相应的部分选项集及其默认选项的组合。在 1.8 之前的 API 版本中,ClientGeocoder 构造函数采用的是不同的参数集。这些参数目前包含在 ClientGeocoderOptions 类中。要了解关于如何使用新代码替换旧代码的详情,请查看代码示例。这一更改将会使此类与 API 中的大部分类保持一致。

实例方法

geocode(address:String): void

启动地址解析请求。在操作即将完成时分派 GeocodingEvent.GEOCODING_SUCCESS 或 GeocodingEvent.GEOCODING_FAILURE。

参数 类型 说明
address String

要进行地址解析的地址。

getBaseCountryCode(): String

用于从 ClientGeocoder 获取当前的基本国家/地区代码。

getOptions(): ClientGeocoderOptions

用于检索地址解析器对象的选项。使用 setOptions() 方法可修改地址解析器选项。

getViewport(): LatLngBounds

用于从 ClientGeocoder 获取当前视口。

resetCache(): void

用于重置地址解析缓存,从而清除此对象和其他 ClientGeocoder 对象检索的所有结果。

reverseGeocode(latLng:LatLng): void

启动逆向地址解析请求。在操作即将完成时分派 GeocodingEvent.GEOCODING_SUCCESS 或 GeocodingEvent.GEOCODING_FAILURE。

参数 类型 说明
latLng LatLng

要进行逆向地址解析的 LatLng。

setBaseCountryCode(country:String): void

用于设置 ClientGeocoder 的基本国家/地区代码。基本国家/地区代码有助于优先显示指定国家/地区的相关搜索结果。例如,在 XX 和 YY 国家/地区都有一个名为 Foo 的城市,如果将基本国家/地区代码设置为 YY,则可使地址解析器优先搜索“Foo, YY”,而不是“Foo, XX”等字词。该代码旨在完全模拟调用方使用针对指定国家/地区的地址解析器时的工作情况。如果将基本国家/地区代码指定为“ES”,那么,该地址解析器的行为将与 maps.google.es 上的地址解析器的行为完全一致。

参数 类型 说明
country String

待设置的基本国家/地区代码。

setOptions(options:ClientGeocoderOptions): void

用于更新地址解析器选项。options 参数可指定完整或部分地址解析器选项集。

参数 类型 说明
options ClientGeocoderOptions

新的完整或部分地址解析器选项集。

setViewport(argViewport:LatLngBounds): void

用于设置 ClientGeocoder 的视口。地址解析器会尝试仅返回位于视口内部或附近的结果。

参数 类型 说明
argViewport LatLngBounds

地址解析器的新视口。

返回页首

ClientGeocoderOptions 类

ClientGeocoderOptions 可指定用于配置 ClientGeocoder 实例的属性。

字段概述

  • countryCode
  • language
  • viewport

构造函数概述

  • ClientGeocoderOptions

方法概述

  • toString

属性

名称 类型 说明
countryCode String

地址解析查询的国家/地区代码。此值用由两个字母组成的标准国家/地区代码指定,例如“US”和“DE”。如果省略了此代码,则系统将会使用浏览器的首选语言设置。

language String

地址解析查询的语言。此值用由两个字母组成的标准语言代码指定,例如“en”和“fr”。如果省略了此代码,则系统将会使用浏览器的首选语言设置。

viewport LatLngBounds

地址解析查询的可视区域。地址解析器将会尝试仅传回位于可视区域内部或附近的结果。

构造函数

ClientGeocoderOptions(param?:Object)

用于构造新的 ClientGeocoderOptions 对象,可以选择通过某个对象对其进行初始化。

var options:ClientGeocoderOptions = new ClientGeocoderOptions({
  language: 'en',
  countryCode: 'CA'
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

Directions 类

Directions 对象可与 Google 服务器进行通信,以获取两个或多个路标之间的路线。对此类请求的回复包含一条表示路线的编码折线,以及要采用的 HTML 格式的路段。

实现

  • IDirections
  • flash.events.IEventDispatcher

字段概述

  • bounds
  • copyrightsHtml
  • distance
  • distanceHtml
  • duration
  • durationHtml
  • encodedPolylineData
  • numGeocodes
  • numRoutes
  • status
  • summaryHtml

构造函数概述

  • Directions

方法概述

  • clear
  • createPolyline
  • getGeocode
  • getOptions
  • getRoute
  • load
  • loadFromWaypoints
  • setOptions

属性

名称 类型 说明
bounds LatLngBounds

此路线查询结果的边框。如果查询失败,则为 Null。

copyrightsHtml String

一个包含此结果的版权信息的 HTML 字符串。

distance Number

此整个路线请求的总距离(以米为单位)。

distanceHtml String

以本地化字符串表示的此整个路线请求的总距离,以此路线集起始国家/地区通用的单位为准。

duration Number

此整个路线请求的总时间(以秒为单位)。

durationHtml String

以本地化字符串表示的此整个路线请求的总时间。

encodedPolylineData EncodedPolylineData

经过编码的折线数据,可用于路线请求。

numGeocodes uint

结果中提供的地址解析项的数量。如果查询成功,则此值应该等于总的输入航点数量。如果未提供任何结果(可能因为未发送查询或前一次查询失败),则此值将会为 0。

numRoutes uint

结果中提供的路线数量。如果查询成功,则此值应该等于总的输入航点数量减 1。如果未提供任何结果(可能因为未发送查询或前一次查询失败),则此值将会为 0。

status uint

路线请求的状态代码。如果未提供结果,则此值将会为 500。

summaryHtml String

一个包含此整个路线请求的距离和时间概述的 HTML 代码段。

构造函数

Directions(options?:DirectionsOptions)

用于构造执行路线请求和检索路线结果的 Directions 实例。

参数 类型 说明
options? DirectionsOptions

完整或部分路线选项集。如果指定了部分选项集,则路线对象的完整选项集将是相应的部分选项集及其默认选项的组合。

实例方法

clear(): void

用于清除任何现有的路线结果,并取消所有待定的 load() 请求。

createPolyline(options?:PolylineOptions): IPolyline

用于创建与整个路线回复关联的 Polyline 对象。请注意,系统将会以一条折线来表示回复中的所有路线。仅在载入路线结果(即已触发“load”事件)后才可以创建此对象。

参数 类型 说明
options? PolylineOptions

用于创建折线的选项。

getGeocode(i:uint): Placemark

用于传回第 i 个航点的地址解析结果。

参数 类型 说明
i uint

要传回的地址解析结果的索引。此值应该介于 0 至 numGeocodes - 1 范围之间(包含这两个数值)。

getOptions(): DirectionsOptions

用于检索路线对象的选项。使用 setOptions() 方法可修改路线对象的选项。

getRoute(i:uint): Route

用于传回回复中第 i 条路线的 Route 对象。

参数 类型 说明
i uint

要传回的路线的索引。此值应该介于 0 至 numRoutes - 1 范围之间(包含这两个数值)。

load(query:String): void

启动路线请求。为完成操作分派 DirectionsEvent.DIRECTIONS_SUCCESSDirectionsEvent.DIRECTIONS_FAILURE 或 DirectionsEvent.DIRECTIONS_ABORTED。每个事件都作为通知提供服务,用于告知路线回复已从服务器中返回,如果成功执行相应事件,则可以从此对象中检索回复信息。接收到路线结果后,此对象会清除旧的结果,并替换为新结果。路线结果由多条路线组成,在查询中指定的每个连续航点/地址对分别对应一条路线,而路线则由多个路段组成。调用新的 load() 请求时,如果未完成前一个 load() 请求,则会取消前一个请求,并为该请求分派 DirectionsEvent.DIRECTIONS_ABORTED 事件。因此,您可以使用单个 Directions 对象逐个发送路线请求,不过,如果生成多个并列请求,则必须使用多个 Directions 对象。

参数 类型 说明
query String

地图样式的路线查询。此值可以为“from: src to: dst1 to: dst2 ...”格式,也可以为自由格式的路线查询(“SFO to SJC”)。

loadFromWaypoints(waypoints:Array): void

使用航点数组作为输入而不是单个查询字符串来发送新的路线查询。此数组最多可包含 25 个航点项。数组中的每一项都是输入地址或“纬度,经度”点的字符串表示。

参数 类型 说明
waypoints Array

航点数组,其中每个航点都为一个 LatLng、字符串地址或点。

setOptions(options:DirectionsOptions): void

用于更新路线选项。options 参数可指定完整或部分路线选项集。

参数 类型 说明
options DirectionsOptions

新的完整或部分路线选项集。

返回页首

DirectionsEvent 类

每当路线请求完成时,系统都会将 DirectionsEvent 对象分派到事件流中。

字段概述

  • DIRECTIONS_ABORTED
  • DIRECTIONS_FAILURE
  • DIRECTIONS_SUCCESS
  • directions
  • name
  • request
  • status

构造函数概述

  • DirectionsEvent

常数

名称 说明
DIRECTIONS_ABORTED directionsaborted

路线中止事件(“directionsaborted”)。在前一个请求完成前,如果进行新的 load() 请求或调用 clear(),则会分派此事件。系统会照常发送新请求。

DIRECTIONS_FAILURE directionsfailure

路线失败事件(“directionsfailure”)。

DIRECTIONS_SUCCESS directionssuccess

路线成功事件(“directionssuccess”)。

属性

名称 类型 说明
directions IDirections

创建此事件的 IDirections 对象。请注意,在发行版本低于 1.18b(包括 1.18b)的版本中,该属性的返回类型为 Directions,而非 IDirections。如果您要在 Directions 中调用的方法未包含在 IDirections 中,则需要自行设置返回类型。

name String

路线请求文本。

request String

请求类型(对于路线请求,为“directions”)。

status Number

路线状态。

构造函数

DirectionsEvent(type:String, directions:IDirections, bubbles?:Boolean, cancellable?:Boolean)

用于创建 DirectionsEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapEvent.type 进行访问。

directions IDirections

用于创建此事件的 Directions 对象。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

DirectionsOptions 类

DirectionsOptions 可指定用于配置 Directions 实例的属性。

字段概述

  • TRAVEL_MODE_DRIVING
  • TRAVEL_MODE_WALKING
  • avoidHighways
  • countryCode
  • language
  • travelMode

构造函数概述

  • DirectionsOptions

方法概述

  • toString

常数

名称 说明
TRAVEL_MODE_DRIVING 0

用于为路线指定驾车出行方式。

TRAVEL_MODE_WALKING 1

用于为路线指定步行出行方式。

属性

名称 类型 说明
avoidHighways Object

一个布尔值,用于确定是否尝试在形成路线时避开高速路。

countryCode String

路线查询的国家/地区代码。此值用由两个字母组成的标准国家/地区代码指定,例如“US”和“DE”。如果在设置时省略了此代码,则会使用 Map.countryCode。

language String

路线查询的语言。此值用由两个字母组成的标准语言代码指定,例如“en”和“fr”。如果在设置时省略了此代码,则会使用 Map.language;否则将会使用浏览器的首选语言设置。

travelMode Object

路线查询的出行方式。此值会影响路线回复,为了符合请求的出行方式,系统将会修改路线。它应该为 TRAVEL_MODE_DRIVING 或 TRAVEL_MODE_WALKING。

构造函数

DirectionsOptions(param?:Object)

用于构造新的 DirectionsOptions 对象,可以选择通过某个对象对其进行初始化。

var options:DirectionsOptions = new DirectionsOptions({
  language: 'en',
  countryCode: 'US',
  travelMode: DirectionsOptions.TRAVEL_MODE_DRIVING
});
参数 类型 说明
param? Object

初始化对象,它包含用于补充默认值集合的一组值。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

Elevation 类

Elevation 对象可与 Google 服务器通信,以获取一个或多个位置的海拔信息。

实现

  • IElevation
  • flash.events.IEventDispatcher

构造函数概述

  • Elevation

方法概述

  • loadElevationAlongEncodedPath
  • loadElevationAlongPath
  • loadElevationForEncodedLocations
  • loadElevationForLocations

构造函数

Elevation()

用于创建可以查询一个或多个位置的海拔的 Elevation 实例。

实例方法

loadElevationAlongEncodedPath(encodedPolylineData:EncodedPolylineData, numPoints:int): void

向 Google 服务器发送请求,查询某条路径上的一个或多个等距离位置的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
encodedPolylineData EncodedPolylineData

可以在其中查到海拔信息的编码位置。与 loadElevationForEncodedLocations() 相反,您可以将路线查询所返回的复杂编码折线数据直接传递给此方法,因为海拔数据只有在指定数目的插值位置才能找到,而不是在 EncodedPolylineData 实例定义的每个位置都能找到。不过,该实现可能会在使用前对该数据结构进行内部简化处理。

numPoints int

要计算海拔的点数。

loadElevationAlongPath(locations:Array, numPoints:int): void

向 Google 服务器发送请求,查询某条路径上的一个或多个等距离位置的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
locations Array

用于定义路径的 LatLng 元素的数组。系统使用插值方法生成要计算海拔的位置。

numPoints int

要计算海拔的点数。

loadElevationForEncodedLocations(encodedPolylineData:EncodedPolylineData): void

向 Google 服务器发送请求,查询一个或多个纬度和经度的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
encodedPolylineData EncodedPolylineData

可以在其中查到海拔信息的编码位置。请注意,路线查询所返回的经过编码的折线数据可能会包含数千个位置,如果尝试获取所有位置的海拔数据,则很可能会超出您的配额。此方法仅限与经过编码的简化折线数据配合使用。

loadElevationForLocations(locations:Array): void

向 Google 服务器发送请求,查询一个或多个纬度和经度的最大海拔高度。如果请求成功,系统会分派 ElevationEvent.ELEVATION_SUCCESS,其中包含指定的纬度和经度以及这些位置的海拔。如果不成功,则系统会分派 ElevationEvent.ELEVATION_FAILURE,表明出现了错误。如果出现这种情况,则 ElevationEvent 的状态属性会包含表示错误性质的代码。

参数 类型 说明
locations Array

LatLng 元素的数组,包含可以在其中查到海拔信息的位置。

返回页首

ElevationEvent 类

每当海拔请求完成时,系统都会将 ElevationEvent 对象分派到事件流中。

字段概述

  • ELEVATION_FAILURE
  • ELEVATION_SUCCESS
  • elevations
  • status

构造函数概述

  • ElevationEvent

常数

名称 说明
ELEVATION_FAILURE elevationfailure

海拔失败事件。

ELEVATION_SUCCESS elevationsuccess

海拔成功事件。

属性

名称 类型 说明
elevations Array

用于获取与此事件相关联的 ElevationResponse 数组。

status int

Elevation 状态代码。如果成功,其值为 ServiceStatus.GEO_SUCCESS。如果失败,其值为以下某个值:ServiceStatus.GEO_BAD_REQUEST、ServiceStatus.GEO_TOO_MANY_QUERIES、ServiceStatus.GEO_REQUEST_DENIED、ServiceStatus.GEO_UNKNOWN_ERROR。

构造函数

ElevationEvent(type:String, status:int, elevations:Array, bubbles?:Boolean, cancellable?:Boolean)

用于创建 ElevationEvent 对象,将其作为参数传递给事件监听器。

参数 类型 说明
type String

事件类型。

status int

响应状态代码。

elevations Array

包含位置及其海拔的 ElevationResponse 元素的数组。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

ElevationResponse 类

ElevationResponse 用于定义某个位置及其相应的海拔。海拔服务会返回 ElevationResponse 实例的数组,以响应各海拔查询。

字段概述

  • elevation
  • location

构造函数概述

  • ElevationResponse

属性

名称 类型 说明
elevation Number

海拔(以米为单位)。

location LatLng

位置。

构造函数

ElevationResponse(location:LatLng, elevation:Number)

ElevationResponse 对象的构造函数。

参数 类型 说明
location LatLng

位置。

elevation Number

海拔(以米为单位)。

返回页首

GeocodingEvent 类

每当地址解析请求完成时,系统都会将 GeocodingEvent 对象分派到事件流中。

字段概述

  • GEOCODING_FAILURE
  • GEOCODING_SUCCESS
  • name
  • request
  • response
  • status

构造函数概述

  • GeocodingEvent

常数

名称 说明
GEOCODING_FAILURE geocodingfailure

地址解析失败事件(“geocodingfailure”)。

GEOCODING_SUCCESS geocodingsuccess

地址解析成功事件(“geocodingsuccess”)。

属性

名称 类型 说明
name String

地址解析请求文本。

request String

请求类型(对于地址解析请求,为“geocode”)。

response GeocodingResponse

如果成功完成请求,则对象将包含地址解析器传回的结果;如果请求失败,则对象为 Null。

status Number

地址解析状态。

构造函数

GeocodingEvent(type:String, bubbles?:Boolean, cancellable?:Boolean)

用于创建 GeocodingEvent 对象,将其作为参数传递给事件侦听器。

参数 类型 说明
type String

事件类型,可作为 MapEvent.type 进行访问。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

GeocodingResponse 类

GeocodingResponse 对象代表由服务器传回的地址解析操作的结果。

字段概述

  • name
  • placemarks

构造函数概述

  • GeocodingResponse

属性

名称 类型 说明
name String

地址解析请求文本。

placemarks Array

地址解析器传回的地标列表。

构造函数

GeocodingResponse()

GeocodingResponse 对象的构造函数。

返回页首

MaxZoom 类

MaxZoom 实例可与 Google 服务器通信,以获取关于用户指定位置适用的最大缩放级别的信息。

请注意,在从地图接收到 MapEvent.MAP_READY 事件之前,不能使用 MaxZoom

实现

  • IMaxZoom
  • flash.events.IEventDispatcher

构造函数概述

  • MaxZoom

方法概述

  • load

构造函数

MaxZoom(mapType:IMapType)

用于创建 MaxZoom,可用来查询地图(采用指定地图类型)上任意点的最大缩放级别。

参数 类型 说明
mapType IMapType

查询最大缩放级别时所使用的地图类型。

实例方法

load(latLng:LatLng, opt_targetZoom?:Number): void

向 Google 服务器发送请求,查找指定地图类型(位于指定的纬度和经度处)中的图像的最大缩放级别。如果请求成功,系统会分派 MaxZoomEvent.MAXZOOM_SUCCESS,其中包含指定的纬度和经度以及该点的最大缩放级别。如果不成功,则系统会分派 MaxZoomEvent.MAXZOOM_FAILURE,表明出现了错误。如果设置了 opt_targetZoom,则仅会考虑使用最多达到 opt_targetZoom 的缩放级别。请注意:仅 MapType.SATELLITE_MAP_TYPE 和 MapType.HYBRID_MAP_TYPE 的卫星图像实现了此功能。

参数 类型 说明
latLng LatLng

用于查找最大缩放级别的纬度和经度。

opt_targetZoom? Number

可能返回的最高缩放级别。

返回页首

MaxZoomEvent 类

每当最大缩放请求完成时,系统都会将 MaxZoomEvent 对象分派到事件流中。

字段概述

  • MAXZOOM_FAILURE
  • MAXZOOM_SUCCESS
  • latLng
  • zoom

构造函数概述

  • MaxZoomEvent

常数

名称 说明
MAXZOOM_FAILURE maxzoomfailure

最大缩放失败事件。

MAXZOOM_SUCCESS maxzoomsuccess

最大缩放成功事件。

属性

名称 类型 说明
latLng LatLng

用于获取与此事件相关联的纬度和经度。

zoom Number

用于获取与此事件相关联的缩放级别。

构造函数

MaxZoomEvent(type:String, latLng:LatLng, zoom:Number, bubbles?:Boolean, cancellable?:Boolean)

用于创建 MaxZoomEvent 对象,将其作为参数传递给事件监听器。

参数 类型 说明
type String

事件类型。

latLng LatLng

与此事件相关联的纬度和经度。

zoom Number

与此事件相关联的缩放级别。

bubbles? Boolean

确定 Event 对象是否参与事件流的弹出提示阶段。默认值为 false。

cancellable? Boolean

确定是否可以取消 Event 对象。默认值为 false。

返回页首

Placemark 类

用于说明地址解析请求传回的单一结果。

字段概述

  • address
  • addressDetails
  • point

构造函数概述

  • Placemark

方法概述

  • toString

属性

名称 类型 说明
address String

地标的完整地址。

addressDetails Object

地址详细信息对象。

point LatLng

地址的 LatLng。

构造函数

Placemark()

构造函数。用于创建空的地标对象。

实例方法

toString(): String

用于传回“地址”形式的地标的字符串表示。

返回页首

Route 类

此类的对象由 Directions 对象创建,用于存储路线结果中有关单一路线的信息。此类没有公共构造函数。客户端不应直接创建此类的对象。

字段概述

  • distance
  • distanceHtml
  • duration
  • durationHtml
  • endGeocode
  • endLatLng
  • numSteps
  • startGeocode
  • summaryHtml

构造函数概述

  • Route

方法概述

  • getStep

属性

名称 类型 说明
distance Number

此路线的总距离(以米为单位)。

distanceHtml String

以本地化字符串表示的此路线的总距离,以此路线集的起始国家/地区通用的单位为准。

duration Number

此路线的总时间(以秒为单位)。

durationHtml String

以本地化字符串表示的此路线的总时间。

endGeocode Placemark

此路线的起始地址和达到地址的地址解析结果。

endLatLng LatLng

沿着此路线的折线的最后一个点。请注意,此点可能不同于 Route.endGeocode 中的“纬度,经度”,因为 endLatLng 始终会传回与道路网络对应的点。没有相应的 startLatLng 属性,因为它与 Route.getStep(0).latLng 相同。

numSteps uint

此路线中的路段数。

startGeocode Placemark

此路线的起始地址的地址解析结果。

summaryHtml String

一个包含此路线的距离和时间概述的 HTML 代码段。

构造函数

Route()

构造函数。用于创建空的路线对象。

实例方法

getStep(i:uint): Step

此路线的第 i 条路段的 Step 对象。

参数 类型 说明
i uint

要获取的路段的索引(从 0 开始)。

返回页首

ServiceStatus 类

此类包含可在服务响应中传回的所有服务状态代码。它只包含常数,因此,不应对其进行实例化。

字段概述

  • GEO_ABORTED_REQUEST
  • GEO_BAD_KEY
  • GEO_BAD_REQUEST
  • GEO_BAD_STATUS_START
  • GEO_MISSING_ADDRESS
  • GEO_MISSING_QUERY
  • GEO_REQUEST_DENIED
  • GEO_SERVER_ERROR
  • GEO_SUCCESS
  • GEO_TOO_MANY_QUERIES
  • GEO_UNAVAILABLE_ADDRESS
  • GEO_UNKNOWN_ADDRESS
  • GEO_UNKNOWN_DIRECTIONS
  • GEO_UNKNOWN_ERROR

常数

名称 说明
GEO_ABORTED_REQUEST 10101

状态代码,表示相应请求因新的请求而中止。

GEO_BAD_KEY 610

状态代码,表示缺少 API 密钥或 API 密钥无效。

GEO_BAD_REQUEST 400

状态代码,表示服务器未能正确处理请求。

GEO_BAD_STATUS_START 600

错误状态代码的数值下限。

GEO_MISSING_ADDRESS 601

状态代码,表示缺少地址参数。

GEO_MISSING_QUERY 601

状态代码,表示缺少查询参数。这是在地址解析器中引进的 GEO_MISSING_ADDRESS 代码的泛化。

GEO_REQUEST_DENIED 650

状态代码,表示请求遭到拒绝。

GEO_SERVER_ERROR 500

状态代码,表示地址解析服务器存在问题。例如,如果 Geoserver 停机,则可能传回此值。

GEO_SUCCESS 200

状态代码,表示成功执行地址解析查询。

GEO_TOO_MANY_QUERIES 620

一种状态,表示我们在 24 小时内接收到的请求过多。

GEO_UNAVAILABLE_ADDRESS 603

一种状态,表示出于法律或其他原因,我们不能向此具体查询传回回复。

GEO_UNKNOWN_ADDRESS 602

状态代码,表示地址未知或错误。

GEO_UNKNOWN_DIRECTIONS 604

状态代码,表示没有可计算的路线。

GEO_UNKNOWN_ERROR 651

状态代码,表示未知错误。

返回页首

Step 类

此类的对象由 Directions 对象创建,用于存储路线结果中有关某条路线的单一路段的信息。此类没有公共构造函数。客户端不应直接创建此类的对象。

字段概述

  • descriptionHtml
  • distance
  • distanceHtml
  • duration
  • durationHtml
  • latLng
  • polylineIndex

构造函数概述

  • Step

属性

名称 类型 说明
descriptionHtml String

一个包含此路段的说明的 HTML 字符串。

distance Number

此路段的总距离(以米为单位)。

distanceHtml String

以本地化字符串表示的此路段的总距离,以此路线集的起始国家/地区通用的单位为准。

duration Number

此路段的总时间(以秒为单位)。

durationHtml String

以本地化字符串表示的此路段的总时间。

latLng LatLng

沿着此路段的折线的第一个点。

polylineIndex uint

沿着此路段的折线的第一个点的索引。

构造函数

Step()

构造函数。用于创建空的路段对象。

返回页首

BevelStyle 类

BevelStyle 类用于为绘制倾斜度指定一组参数。

字段概述

  • BEVEL_LOWERED
  • BEVEL_NONE
  • BEVEL_RAISED
  • bevelAlpha
  • bevelStyle
  • bevelThickness
  • highlightColor
  • shadowColor

构造函数概述

  • BevelStyle

方法概述

  • mergeStyles
  • toString

常数

名称 说明
BEVEL_LOWERED 2

降低倾斜度。

BEVEL_NONE 0

没有倾斜。

BEVEL_RAISED 1

增加倾斜度。

属性

名称 类型 说明
bevelAlpha Object

一个数值,用于指定倾斜的 alpha。

bevelStyle Object

倾斜类型(BevelStyle.NONE、BevelStyle.RAISED 或 BevelStyle.LOWERED)。

bevelThickness Object

一个数值,用于指定倾斜的厚度。

highlightColor Object

一个数值,用于指定倾斜的突出显示颜色。

shadowColor Object

一个数值,用于指定倾斜的阴影颜色。

构造函数

BevelStyle(params?:Object)

用于构造 BevelStyle 实例,可以选择通过某个对象对其进行初始化。

var style:BevelStyle = new BevelStyle({
  bevelStyle: BevelStyle.BEVEL_RAISED,
  bevelThickness: 1,
  bevelAlpha: 0.5,
  highlightColor: 0xff0040,
  shadowColor: 0x000000,
  fillStyle: {
    color: 0xa0a0a0,
    alpha: 1
  },
  strokeStyle: {
    color: 0x000000,
    alpha: 2
  }
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 BevelStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): BevelStyle

用于合并两个或更多个 BevelStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 BevelStyle 对象数组。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

ButtonFaceStyle 类

ButtonFaceStyle 类用于为绘制指定状态(弹起/悬停/按下)下的按钮外观指定一组参数。

字段概述

  • labelFormat

构造函数概述

  • ButtonFaceStyle

方法概述

  • mergeStyles
  • toString

属性

名称 类型 说明
labelFormat TextFormat

按钮的标签格式。

构造函数

ButtonFaceStyle(params?:Object)

用于构造 ButtonFaceStyle 实例,可以选择通过某个对象对其进行初始化。

var style:ButtonFaceStyle = new ButtonFaceStyle({
  bevelStyle: BevelStyle.BEVEL_RAISED,
  bevelThickness: 1,
  bevelAlpha: 0.5,
  highlightColor: 0xff0040,
  shadowColor: 0x000000,
  fillStyle: {
    color: 0xa0a0a0,
    alpha: 1
  },
  strokeStyle: {
    color: 0x000000,
    alpha: 2
  },
  labelFormat: {
    font: "_sans",
    size: 12
  }
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 ButtonFaceStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): ButtonFaceStyle

用于合并两个或更多个 ButtonFaceStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 ButtonFaceStyle 对象数组。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

ButtonStyle 类

ButtonStyle 类用于为绘制按钮指定一组参数。

字段概述

  • downState
  • overState
  • upState

构造函数概述

  • ButtonStyle

方法概述

  • mergeStyles
  • setAllStates
  • toString

属性

名称 类型 说明
downState ButtonFaceStyle

“按下”状态的按钮样式。

overState ButtonFaceStyle

“悬停”状态的按钮样式。

upState ButtonFaceStyle

“弹起”状态的按钮样式。

构造函数

ButtonStyle(params?:Object)

用于构造 ButtonStyle 实例,可以选择通过某个对象对其进行初始化。

var style:ButtonStyle = new ButtonStyle({
  allStates: {
    fillStyle: {
      color: 0xA0A0A0,
      alpha: 1.0
    },
    strokeStyle: {
      color: 0x000000,
      thickness: 2
    },
    labelFormat: {
      size: 12,
      font: "_sans"
    },
    bevelThickness: 1.5,
    bevelAlpha: 0.5,
    highlightColor: 0xffffff,
    shadowColor: 0x000000
  },
  upState: {
    bevelStyle: BevelStyle.BEVEL_RAISED
  },
  overState: {
    bevelStyle: BevelStyle.BEVEL_RAISED
  },
  downState: {
    bevelStyle: BevelStyle.BEVEL_LOWERED,
    labelFormat: {
      bold: true
    }
  }
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 ButtonStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): ButtonStyle

用于合并两个或更多个 ButtonStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 ButtonStyle 对象数组。

实例方法

setAllStates(shared:ButtonFaceStyle): void

用于为所有按钮状态指定一组倾斜样式属性。此方法会使用作为参数传递的 ButtonFaceStyle 中的值来补充每种状态样式。

参数 类型 说明
shared ButtonFaceStyle

要在所有按钮状态中共享的一组 ButtonFaceStyle 属性。

toString(): String

toString 方法。

返回页首

FillStyle 类

FillStyle 类用于为绘制图形对象的背景指定一组参数。

字段概述

  • alpha
  • color
  • gradient

构造函数概述

  • FillStyle

方法概述

  • mergeStyles
  • toString

属性

名称 类型 说明
alpha Object

一个数值,用于指定填充 alpha。设置填充 alpha 会清除渐变样式。

color Object

一个数值,用于指定填充颜色。设置填充颜色会清除渐变样式。

gradient GradientStyle

渐变填充样式。如果设置此属性,则渐变样式的优先级要高于颜色和 alpha。

构造函数

FillStyle(params?:Object)

用于构造新的 FillStyle 实例,可以选择通过某个对象对其进行初始化。

var gradientStyle:GradientStyle = new GradientStyle({
  type: GradientType.LINEAR,
  colors: [0xFFFF00, 0x800000],
  alphas: [1, 1],
  ratios: [0, 255]
});
gradientStyle.matrix = new Matrix();
gradientStyle.matrix.createGradientBox(14, 14, 0, 0, 0);
var styleA:FillStyle = new FillStyle({
  gradient: gradientStyle
});
var styleB:FillStyle = new FillStyle({
  color: 0xff0040,
  alpha: 0.5
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 FillStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): FillStyle

用于合并两个或更多个 FillStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 FillStyle 对象数组。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

GradientStyle 类

GradientStyle 类用于为绘制图形对象的渐变背景指定一组参数。

字段概述

  • alphas
  • colors
  • focalPointRatio
  • interpolationMethod
  • matrix
  • ratios
  • spreadMethod
  • type

构造函数概述

  • GradientStyle

方法概述

  • toString

属性

名称 类型 说明
alphas Array

一个数值类型的数组,其中每个数值都是与颜色数组中的相应元素匹配的 alpha 值。

colors Array

一个数值类型的数组,其中每个数值都是要在渐变样式中使用的 RGB 颜色值(最多 15 个元素)。

focalPointRatio Number

渐变焦点比率。

interpolationMethod String

渐变插值方法。

matrix Matrix

渐变变换距阵。

ratios Array

与颜色数组中的元素对应的颜色分布比率。

spreadMethod String

渐变扩散方法。

type String

GradientType 类的值之一,用于指定要使用的渐变类型:GradientType.LINEAR 或 GradientType.RADIAL。

构造函数

GradientStyle(params?:Object)

用于构造新的 GradientStyle 实例,可以选择通过某个对象对其进行初始化。

var mat:Matrix = new Matrix();
mat.createGradientBox(10, 10, 0, 0, 0);
var style:GradientStyle = new GradientStyle({
  type: GradientType.LINEAR,
  colors: [0xff0000, 0x00ff00, 0x0000ff],
  alphas: [0.3, 0.7, 0.5],
  ratios: [0, 64, 255],
  matrix: mat,
  spreadMethod: SpreadMethod.PAD,
  interpolationMethod: InterpolationMethod.RGB,
  focalPointRatio: 0.3
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 GradientStyle 对象的一组初始值。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

MapTypeStyle 类

MapTypeStyle 类用于指定向地图应用自定义样式的相关范围和规则。

字段概述

  • elementType
  • featureType
  • stylers

构造函数概述

  • MapTypeStyle

属性

名称 类型 说明
elementType String

选择将应用某样式器的元素类型。元素类型在特征的表示方面各具特色。MapTypeStyleElementType 类用于定义此属性的可能值。可选;如果未指定 elementType,则假定该值为“all”。

featureType String

选择要应用样式器的地图项或地图项组。可选;如果未指定 featureType,则假定该值为“all”。MapTypeStyleFeatureType 类用于定义此属性的可能值。

stylers Array

要应用到选择器的样式规则。这些规则会按它们在此数组中的排列顺序应用到地图的元素中。使用 MapTypeStyleRule 类中的方法在此数组内创建元素。

构造函数

MapTypeStyle(featureType:String, elementType:String, stylers:Array)

用于构建 MapTypeStyle 实例。

参数 类型 说明
featureType String

地图项类型。可接受的值由 <MapTypeStyleFeatureType/code>. 类定义

elementType String

元素类型。可接受的值由 <MapTypeStyleElementType/code>. 类定义

stylers Array

样式器对象的数组。使用 MapTypeStyleRule 类中的方法在此数组内创建元素。

返回页首

MapTypeStyleElementType 类

MapTypeStyleElementType 类用于为元素类型指定可能的值。这些值区分了地图项的不同表示。

字段概述

  • ALL
  • GEOMETRY
  • LABELS

常数

名称 说明
ALL all

将规则应用到指定特征的所有元素。

GEOMETRY geometry

将规则应用到特征的几何体。

LABELS labels

将规则应用到特征的标签。

返回页首

MapTypeStyleFeatureType 类

MapTypeStyleFeatureType 类用于为地图项类型指定可能的值。应用到父特征类型的样式器将自动应用到所有子特征类型。但是请注意,父特征可能包括它的某个子特征类型不包括的其他一些特征。

字段概述

  • ADMINISTRATIVE
  • ADMINISTRATIVE_COUNTRY
  • ADMINISTRATIVE_LAND_PARCEL
  • ADMINISTRATIVE_LOCALITY
  • ADMINISTRATIVE_NEIGHBORHOOD
  • ADMINISTRATIVE_PROVINCE
  • ALL
  • LANDSCAPE
  • LANDSCAPE_MAN_MADE
  • LANDSCAPE_NATURAL
  • POI
  • POI_ATTRACTION
  • POI_GOVERNMENT
  • POI_MEDICAL
  • POI_PARK
  • POI_PLACE_OF_WORSHIP
  • POI_SCHOOL
  • POI_SPORTS_COMPLEX
  • ROAD
  • ROAD_ARTERIAL
  • ROAD_HIGHWAY
  • ROAD_LOCAL
  • TRANSIT
  • TRANSIT_LINE
  • TRANSIT_STATION
  • TRANSIT_STATION_AIRPORT
  • TRANSIT_STATION_BUS
  • TRANSIT_STATION_FERRY
  • TRANSIT_STATION_RAIL
  • WATER

常数

名称 说明
ADMINISTRATIVE administrative

将规则应用到管理区域。

ADMINISTRATIVE_COUNTRY administrative.country

将规则应用到国家/地区。

ADMINISTRATIVE_LAND_PARCEL administrative.land_parcel

将规则应用到地块。

ADMINISTRATIVE_LOCALITY administrative.locality

将规则应用到地区。

ADMINISTRATIVE_NEIGHBORHOOD administrative.neighborhood

将规则应用到邻近地区。

ADMINISTRATIVE_PROVINCE administrative.province

将规则应用到省。

ALL all

将规则应用到所有地图项。

LANDSCAPE landscape

将规则应用到景观。

LANDSCAPE_MAN_MADE landscape.man_made

将规则应用到人工结构。

LANDSCAPE_NATURAL landscape.natural

将规则应用到自然特征。

POI poi

将规则应用到兴趣点。

POI_ATTRACTION poi.attraction

将规则应用到游客感兴趣的地方。

POI_GOVERNMENT poi.government

将规则应用到政府建筑。

POI_MEDICAL poi.medical

将规则应用到紧急服务(医院、药房、警察、医生等)。

POI_PARK poi.park

将规则应用到公园。

POI_PLACE_OF_WORSHIP poi.place_of_worship

将规则应用到宗教场所,如教堂、寺庙或清真寺。

POI_SCHOOL poi.school

将规则应用到学校。

POI_SPORTS_COMPLEX poi.sports_complex

将规则应用到体育场馆。

ROAD road

将规则应用到所有道路。

ROAD_ARTERIAL road.arterial

将规则应用到一级公路。

ROAD_HIGHWAY road.highway

将规则应用到高速公路。

ROAD_LOCAL road.local

将规则应用到地方道路。

TRANSIT transit

将规则应用到所有公交站和公交线路。

TRANSIT_LINE transit.line

将规则应用到公交线路。

TRANSIT_STATION transit.station

将规则应用到所有公交站。

TRANSIT_STATION_AIRPORT transit.station.airport

将规则应用到机场。

TRANSIT_STATION_BUS transit.station.bus

将规则应用到汽车站。

TRANSIT_STATION_FERRY transit.station.ferry

将规则应用到渡口。

TRANSIT_STATION_RAIL transit.station.rail

将规则应用到火车站。

WATER water

将规则应用到水体。

返回页首

MapTypeStyleRule 类

样式器会影响为地图元素设置样式的方式。MapTypeStyleRule 类用于提供辅助函数,以创建要与 MapTypeStyle 配合使用的样式器对象。请注意,如果您选择不使用 MapTypeStyleRule 的函数来创建样式器对象,则应确保每个对象有且仅有一个密钥。如果您在单个 MapTypeStyleRule 中指定了多个密钥,则系统只会使用其中的一个密钥,而忽略其他所有密钥。

方法概述

  • gamma
  • hue
  • invert_lightness
  • lightness
  • saturation
  • visibility

静态方法

gamma(value:Number): Object

用于创建样式器对象,该对象通过提升亮度以达到指定功率来修改灰度系数。

参数 类型 说明
value Number

灰度系数:介于 [0.01, 10] 范围内的数值,1.0 表示不应用任何更改。

hue(color:uint): Object

用于创建样式器对象,该对象用于设置地图项的色相,以使其匹配所提供颜色的色相。请注意,系统会保留地图项的饱和度与亮度,这意味着地图项与所提供的颜色不会完全匹配。

参数 类型 说明
color uint

颜色。仅使用低于 24 位的颜色(即,任何 alpha 值都将被忽略)。

invert_lightness(invert:Boolean): Object

用于创建可以反转亮度的样式器对象。此方法将会在保留色相与饱和度的同时反转亮度。

参数 类型 说明
invert Boolean

如果为 true,则反转亮度。

lightness(value:Number): Object

用于创建可以改变颜色亮度的样式器对象,具体方法如下:如果降低亮度,则按原始值百分比改变;如果增加亮度,则按剩余值的百分比改变。

参数 类型 说明
value Number

亮度改变的取值范围为 [-100, 100]。

saturation(value:Number): Object

用于创建可以改变颜色饱和度的样式器对象,具体方法如下:如果降低亮度,则按原始值百分比改变;如果增加亮度,则按剩余值的百分比改变。

参数 类型 说明
value Number

饱和度改变的取值范围为 [-100, 100]。

visibility(value:String): Object

用于创建可以设置可见性的样式器对象。

参数 类型 说明
value String

可见性状态的值为:“on”、“off”或“simplified”。

返回页首

RectangleStyle 类

RectangleStyle 类会将 FillStyle 和 StrokeStyle 相结合以用于呈现基本矩形。

字段概述

  • fillStyle
  • strokeStyle

构造函数概述

  • RectangleStyle

方法概述

  • mergeStyles
  • toString

属性

名称 类型 说明
fillStyle FillStyle

矩形的填充样式。

strokeStyle StrokeStyle

矩形的笔触样式。

构造函数

RectangleStyle(params?:Object)

用于构造 RectangleStyle 实例,可以选择通过某个对象对其进行初始化。

var style:RectangleStyle = new RectangleStyle({
  fillStyle: {
    color: 0xa0a0a0,
    alpha: 1
  },
  strokeStyle: {
    color: 0x000000,
    alpha: 2
  }
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 RectangleStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): RectangleStyle

用于合并两个或更多个 RectangleStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 RectangleStyle 对象数组。

实例方法

toString(): String

用于传回此对象的字符串表示。

返回页首

StrokeStyle 类

StrokeStyle 类用于为绘制图形对象的轮廓指定一组参数。

字段概述

  • alpha
  • color
  • pixelHinting
  • thickness

构造函数概述

  • StrokeStyle

方法概述

  • mergeStyles
  • toString

属性

名称 类型 说明
alpha Object

一个数值,用于指定笔触 alpha。

color Object

一个数值,用于指定笔触颜色。

pixelHinting Object

一个布尔值,用于指定是否应用像素提示。

thickness Object

一个数值,用于指定笔触粗细。

构造函数

StrokeStyle(params?:Object)

用于构造新的 StrokeStyle 对象,可以选择通过某个对象对其进行初始化。

var style:StrokeStyle = new StrokeStyle({
  thickness: 2,
  color: 0xff8030,
  alpha: 0.7,
  pixelHinting: false
});
参数 类型 说明
params? Object

一个初始化对象,它包含新 StrokeStyle 对象的一组初始值。

静态方法

mergeStyles(styles:Array): StrokeStyle

用于合并两个或更多个 StrokeStyle 对象。系统会按照样式在数组中的顺序来合并样式,数组中指数较大的样式属性会覆盖排列顺序靠前的值。

参数 类型 说明
styles Array

要合并的 StrokeStyle 对象数组。

实例方法

toString(): String

用于传回此对象的字符串表示。