Google_Maps_API_V3 帮助文档

Google_Maps_API_V3  帮助文档       

        分类:            javascript 1129人阅读 评论(0) 收藏 举报

Google Maps JavaScript API V3 参考

注意:以下网页中提到的 Google Maps JavaScript API 3 版现在是正式的 JavaScript API版本。该 API 的第 2 版已根据我们的弃用政策正式弃用。欢迎您将代码移植到这个功能更强、最近更新的版本中!

最新版本

上次更新日期:2010 6 15

欢迎使用 JavaScript Maps API V3参考。此参考将经常更新,与 API的最新更改保持同步。有关每个版本的新增功能的信息,请参考 JavaScript Maps API V3更改日志

参考目录

·         Map

o    MapOptions

o    MapTypeId

o    MapTypeControlOptions

o    MapTypeControlStyle

o    NavigationControlOptions

o    NavigationControlStyle

o    ScaleControlOptions

o    ScaleControlStyle

o    ControlPosition

o    MapPanes

o    MapCanvasProjection

·         Marker

o    MarkerOptions

o    MarkerImage

o    MarkerShape

·         Polyline

o    PolylineOptions

·         Polygon

o    PolygonOptions

·         InfoWindow

o    InfoWindowOptions

·         Geocoder

o    GeocoderRequest

o    GeocoderStatus

o    GeocoderResult

o    GeocoderAddressComponent

o    GeocoderGeometry

o    GeocoderLocationType

·         DirectionsRenderer

o    DirectionsRendererOptions

·         DirectionsService

o    DirectionsRequest

o    DirectionsTravelMode

o    DirectionsUnitSystem

o    DirectionsWaypoint

o    DirectionsStatus

o    DirectionsResult

o    DirectionsRoute

o    DirectionsLeg

o    DirectionsStep

o    DirectionsDistance

o    DirectionsDuration

·         ElevationService

o    LocationElevationRequest

o    PathElevationRequest

o    ElevationResult

o    ElevationStatus

·         叠加层和地图类型:

o    OverlayView

o    MapType

o    MapTypeRegistry

o    Projection

o    ImageMapType

o    ImageMapTypeOptions

o    StyledMapType

o    StyledMapTypeOptions

o    MapTypeStyle

o    MapTypeStyleFeatureType

o    MapTypeStyleElementType

o    MapTypeStyler

o    Rectangle

o    RectangleOptions

o    Circle

o    CircleOptions

o    GroundOverlay

o    GroundOverlayOptions

·         图层:

o    BicyclingLayer

o    FusionTablesLayer

o    FusionTablesLayerOptions

o    FusionTablesMouseEvent

o    FusionTablesCell

o    KmlLayer

o    KmlLayerOptions

o    KmlLayerMetadata

o    KmlMouseEvent

o    KmlFeatureData

o    KmlAuthor

o    TrafficLayer

·         街景视图:

o    StreetViewPanorama

o    StreetViewPanoramaOptions

o    StreetViewAddressControlOptions

o    StreetViewLink

o    StreetViewPov

o    StreetViewPanoramaData

o    StreetViewLocation

o    StreetViewTileData

o    StreetViewService

o    StreetViewStatus

·         事件:

o    MapsEventListener

o    事件

o    MouseEvent

·         Base

o    LatLng

o    LatLngBounds

o    Point

o    Size

·         MVC

o    MVCObject

o    MVCArray

Map

此类扩展了 MVCObject

构造函数

构造函数

说明

Map(mapDiv:Node, opts?:MapOptions)

在指定的 HTML 容器中创建新的地图,该容器通常是一个 DIV 元素。

方法

方法

返回值

说明

fitBounds(bounds:LatLngBounds)

None

设置地图,使其与指定范围相符。

getBounds()

LatLngBounds

返回当前视口的纬度/经度范围。如果还未启动地图(即 mapType 仍为 Null),或者没有设置中心和缩放,则结果为 Null。

getCenter()

LatLng

getDiv()

Node

getMapTypeId()

MapTypeId

getProjection()

Projection

传回当前的 Projection。如果还未启动地图(即 mapType 仍为 Null),则结果为 Null。侦听 projection_changed 并检查它的值以确保它的值不为 Null。

getStreetView()

StreetViewPanorama

将默认 StreetViewPanorama 范围传回到地图,该范围可能是嵌入在地图中的默认全景图,也可能是使用 setStreetView()设置的全景图。对地图的 streetViewControl 所做的更改将反映在此类范围全景图的显示中。

getZoom()

number

panBy(x:number, y:number)

None

将地图中心移动一段指定的距离(以像素为单位)。如果这段距离既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。请注意,地图坐标系的 x 值从西向东增加,y 值从北向南增加。

panTo(latLng:LatLng)

None

将地图中心更改为指定的 LatLng。如果更改幅度既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。

panToBounds(latLngBounds:LatLngBounds)

None

将地图平移所需的最小距离以包含指定的 LatLngBounds。 范围在地图上的位置并不确定,除了尽可能多地显示范围。范围将定位在由地图类型和导航控件限定的区域内部,但前提是它们出现在地图上。如果范围大于地图, 则地图会移动,以便包括范围的西北角。如果地图位置的移动幅度既小于地图的宽度,又小于地图的高度,那么移动的动画效果将会十分流畅。

setCenter(latlng:LatLng)

None

setMapTypeId(mapTypeId:MapTypeId)

None

setOptions(options:MapOptions)

None

setStreetView(panorama:StreetViewPanorama)

None

StreetViewPanorama 绑定到地图。此全景图将覆盖默认StreetViewPanorama,从而使地图可以绑定到地图外的外部全景图。将全景图设置为 null 可将默认的嵌入式全景图绑定回到地图。

setZoom(zoom:number)

None

属性

属性

类型

说明

controls

Array.<MVCArray.<Node>>

附加到地图的其他控件。要在地图中添加控件,请将控件的 <div> 添加到与应渲染它的ControlPosition 相对应的 MVCArray 中。

mapTypes

MapTypeRegistry

按字符串 ID 划分的 MapType 实例的注册表。

overlayMapTypes

MVCArray.<MapType>

要叠加的其他地图类型。

事件

事件

参数

说明

bounds_changed

None

当可视区域范围更改时会触发此事件。

center_changed

None

当地图中心属性更改时会触发此事件。

click

MouseEvent

当用户点击地图(但不是点击标记或信息窗口)时会触发此事件。

dblclick

MouseEvent

当用户双击地图时会触发此事件。请注意,触发此事件前还会触发点击事件。

drag

None

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

dragend

None

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

dragstart

None

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

idle

None

如果地图在平移或缩放之后变为闲置状态,则会触发此事件。

maptypeid_changed

None

当 mapTypeId 属性更改时会触发此事件。

mousemove

MouseEvent

只要用户的鼠标在地图容器上移动,就会触发此事件。

mouseout

MouseEvent

当用户的鼠标从地图容器上退出时会触发此事件。

mouseover

MouseEvent

当用户的鼠标进入地图容器时会触发此事件。

projection_changed

None

当投影更改时会触发此事件。

resize

None

当 div 更改大小时,开发人员应在地图上触发此事件:google.maps.event.trigger(map, 'resize')

rightclick

MouseEvent

在地图容器中触发 DOM contextmenu 事件时会触发此事件。

tilesloaded

None

可见图块载入完成后会触发此事件。

zoom_changed

None

当地图缩放属性更改时会触发此事件。

MapOptions对象规范

属性

属性

类型

说明

backgroundColor

string

用作地图 div 的背景颜色。当用户进行平移时,如果尚未载入图块,则显示此颜色。仅在启动地图时,才能设置此选项。

center

LatLng

初始的地图中心。必填。

disableDefaultUI

boolean

启用/停用所有默认的用户界面。该属性可以单独进行重写。

disableDoubleClickZoom

boolean

启用/停用在双击时缩放并居中。默认情况下处于启用状态。

draggable

boolean

如果为 False,则禁止拖动地图。默认情况下启用拖动。

draggableCursor

string

要在可拖动对象上显示的光标的名称或网址。

draggingCursor

string

要在拖动对象时显示的光标的名称或网址。

keyboardShortcuts

boolean

如果为 False,则禁止通过键盘控制地图。默认情况下启用键盘快捷键。

mapTypeControl

boolean

地图类型控件的初始启用/停用状态。

mapTypeControlOptions

MapTypeControlOptions

地图类型控件的初始显示选项。

mapTypeId

MapTypeId

初始的地图 mapTypeId。必填。

navigationControl

boolean

导航控件的初始启用/停用状态。

navigationControlOptions

NavigationControlOptions

导航控件的初始显示选项。

noClear

boolean

如果为 true,则不会清除地图 div 的内容。

scaleControl

boolean

缩放控件的初始启用/停用状态。

scaleControlOptions

ScaleControlOptions

缩放控件的初始显示选项。

scrollwheel

boolean

如果为 False,则停用通过滚轮缩放地图的功能。默认情况下启用滚轮功能。

streetView

StreetViewPanorama

将街景视图街景小人置于地图上时显示的 StreetViewPanorama。如果未指定全景图,则拖动街景小人时,默认 StreetViewPanorama 将显示在地图的 div中。

streetViewControl

boolean

街景视图街景小人控件的初始启用/停用状态。

zoom

number

初始的地图缩放级别。必填。

MapTypeId

常见 MapTypes的标识符。

常数

常数

说明

HYBRID

该地图类型显示卫星图像上的主要街道透明层。

ROADMAP

该地图类型显示普通的街道地图。

SATELLITE

该地图类型显示卫星图像。

TERRAIN

该地图类型显示带有自然特征(如地形和植被)的地图。

MapTypeControlOptions对象规范

用于渲染地图类型控件的选项。

属性

属性

类型

说明

mapTypeIds

Array.<MapTypeId>|Array.<string>

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

position

ControlPosition

位置 ID。用于指定控件在地图上的位置。默认位置为 TOP_RIGHT

style

MapTypeControlStyle

样式 ID。用于选择要显示的地图类型控件的样式。

MapTypeControlStyle

常见 MapTypesControls的标识符。

常数

常数

说明

DEFAULT

使用默认的地图类型控件。地图默认使用的控件会因窗口大小和其他因素而有所不同。该控件可能在该 API 以后的版本中有所更改。

DROPDOWN_MENU

反映屏幕实际使用面积的下拉菜单。

HORIZONTAL_BAR

标准的水平单选按钮栏。

NavigationControlOptions对象规范

用于渲染导航控件的选项。

属性

属性

类型

说明

position

ControlPosition

位置 ID。用于指定控件在地图上的位置。默认位置为 TOP_LEFT

style

NavigationControlStyle

样式 ID。用于选择要显示的导航控件的样式。

NavigationControlStyle

导航控件常见类型的标识符。

常数

常数

说明

ANDROID

这是一种小型缩放控件,与 Android 上的本机地图应用程序所用的控件相似。

DEFAULT

默认的导航控件。地图默认使用的控件会因窗口大小和其他因素而有所不同。该控件可能在该 API 以后的版本中有所更改。

SMALL

只具有缩放功能的小型控件。

ZOOM_PAN

较大控件,具有缩放滑块和平移方向柄。

ScaleControlOptions对象规范

用于渲染比例控件的选项。

属性

属性

类型

说明

position

ControlPosition

位置 ID。用于指定控件在地图上的位置。默认位置为 BOTTOM_LEFT

style

ScaleControlStyle

样式 ID。用于选择要显示的缩放控件的样式。

ScaleControlStyle

缩放控件 ID的标识符。

常数

常数

说明

DEFAULT

标准缩放控件。

ControlPosition

用于指定控件在地图上的位置的标识符。控件相对于同一布局位置中的其他控件而定位。首先添加的控件将定位在靠近地图边缘的位置。
  +---------------+
  + TL    T    TR +
  +               +
  + L           R +
  +               +
  +               +
  +               +
  + BL    B    BR +
  +---------------+
顶部或底部行中的元素将向中间流动。左侧或右侧的元素向下流动。

常数

常数

说明

BOTTOM

元素定位在底部行的中间。

BOTTOM_LEFT

元素定位在左下角并向中间流动。元素定位在 Google 徽标的右侧。

BOTTOM_RIGHT

元素定位在右下角并向中间流动。元素定位在版权的左侧。

LEFT

元素定位在左侧,位于左上角的元素下面,并向下流动。

RIGHT

元素定位在右侧,位于右上角的元素下面,并向下流动。

TOP

元素定位在顶部行的中间。

TOP_LEFT

元素定位在左上角并向中间流动。

TOP_RIGHT

元素定位在右上角并向中间流动。

MapPanes对象规范

此对象包含渲染叠加层的 DOM元素。下面列出了这些元素,底部为窗格 0”,顶部为窗格6”

属性

属性

类型

说明

floatPane

Node

此窗格包含信息窗口。它位于所有地图叠加层之上。(窗格 6)。

floatShadow

Node

此窗格包含信息窗口阴影。该窗格在 overlayImage 之上,这样标记便可位于信息窗口的阴影中。(窗格 4)。

mapPane

Node

此窗格是最下面的窗格,位于图块之上。(窗格 0)。

overlayImage

Node

此窗格包含标记前景图像。(窗格 3)。

overlayLayer

Node

此窗格包含折线、多边形、地面叠加层和图块图层叠加层。(窗格 1)。

overlayMouseTarget

Node

此窗格包含透明元素,可接收针对标记的 DOM 鼠标事件。该窗格在 floatShadow 之上,这样便可点击信息窗口阴影中的标记。(窗格 5)。

overlayShadow

Node

此窗格包含标记阴影。(窗格 2)。

MapCanvasProjection对象规范

方法

方法

返回值

说明

fromContainerPixelToLatLng(pixel:Point)

LatLng

根据地图容器中的像素坐标计算地理坐标。

fromDivPixelToLatLng(pixel:Point)

LatLng

根据存放可拖动地图的 div 中的像素坐标计算地理坐标。

fromLatLngToContainerPixel(latLng:LatLng)

Point

计算地图外部容器的 DOM 元素中指定地理位置的像素坐标。

fromLatLngToDivPixel(latLng:LatLng)

Point

计算存放可拖动地图的 DOM 元素中指定地理位置的像素坐标。

getWorldWidth()

number

当前缩放级别下世界地图的宽度(以像素为单位)。

Marker

此类扩展了 MVCObject

构造函数

构造函数

说明

Marker(opts?:MarkerOptions)

创建带有指定选项的标记。如果已指定地图,则标记会在构造完成后立即添加到该地图。请注意,您必须设置标记的显示位置。

方法

方法

返回值

说明

getClickable()

boolean

getCursor()

string

getDraggable()

boolean

getFlat()

boolean

getIcon()

string|MarkerImage

getMap()

Map|StreetViewPanorama

getPosition()

LatLng

getShadow()

string|MarkerImage

getShape()

MarkerShape

getTitle()

string

getVisible()

boolean

getZIndex()

number

setClickable(flag:boolean)

None

setCursor(cursor:string)

None

setDraggable(flag:boolean)

None

setFlat(flag:boolean)

None

setIcon(icon:string|MarkerImage)

None

setMap(map:Map|StreetViewPanorama)

None

在指定地图或全景图上渲染标记。如果地图设置为 Null,则会删除此标记。

setOptions(options:MarkerOptions)

None

setPosition(latlng:LatLng)

None

setShadow(shadow:string|MarkerImage)

None

setShape(shape:MarkerShape)

None

setTitle(title:string)

None

setVisible(visible:boolean)

None

setZIndex(zIndex:number)

None

事件

事件

参数

说明

click

Event

点击标记图标后会触发此事件。

clickable_changed

None

当标记的可点击属性更改时会触发此事件。

cursor_changed

None

当标记的光标属性更改时会触发此事件。

dblclick

Event

当双击标记图标时会触发此事件。

drag

MouseEvent

当用户拖动标记时会反复触发此事件。

dragend

MouseEvent

当用户停止拖动标记时会触发此事件。

draggable_changed

None

当标记的可拖动属性更改时会触发此事件。

dragstart

MouseEvent

当用户开始拖动标记时会触发此事件。

flat_changed

None

当标记的平面属性更改时会触发此事件。

icon_changed

None

当标记图标属性更改时会触发此事件。

mousedown

Event

对标记图标触发 DOM mousedown 事件时会触发此事件。

mouseout

Event

当鼠标离开标记图标区域时会触发此事件。

mouseover

Event

当鼠标进入标记图标区域时会触发此事件。

mouseup

Event

对标记触发 DOM mouseup 事件时会触发此事件。

position_changed

None

当标记位置属性更改时会触发此事件。

rightclick

Event

右键点击标记时会触发此事件。

shadow_changed

None

当标记的阴影属性更改时会触发此事件。

shape_changed

None

当标记的形状属性更改时会触发此事件。

title_changed

None

当标记名称属性更改时会触发此事件。

visible_changed

None

当标记的可见属性更改时会触发此事件。

zindex_changed

None

当标记的 zIndex 属性更改时会触发此事件。

MarkerOptions对象规范

属性

属性

类型

说明

clickable

boolean

如果为 true,则标记会收到鼠标事件和触摸事件。默认值为 true。

cursor

string

鼠标悬停时显示的光标。

draggable

boolean

如果为 true,则可拖动标记。默认值为 false。

flat

boolean

如果为 true,则不会显示标记阴影。

icon

string|MarkerImage

前景的图标

map

Map|StreetViewPanorama

待显示标记的地图。

position

LatLng

标记位置。必填。

shadow

string|MarkerImage

阴影图像

shape

MarkerShape

用于拖动/点击的图像地图区域定义。

title

string

滚动文本

visible

boolean

如果为 true,则显示标记。

zIndex

number

所有标记按其 zIndex 值的大小顺序在地图上显示,zIndex 值较大的标记显示在值较小的标记之前。默认情况下,标记是按纬度显示的,纬度较低的标记显示在纬度较高的标记前。

MarkerImage

构造函数

构造函数

说明

MarkerImage(url:string,size?:Size,origin?:Point,anchor?:Point,scaledSize?:Size)

定义一张用作标记图标或者阴影的图像。“origin”和“size”用于选择拼合图像的图块,“anchor”用于重写锚点默认所处的底部中间位置。图像的锚点是系统在跟踪图像位置时引用的像素。默认情况下,锚点设置为图像的底部中间位置 (坐标宽度/2, 高度)。因此,当标记放置在指定的 LatLng 上时,定义为锚点的像素就定位于指定的 LatLng 上。要缩放图像,无论该图像是否为拼合图像,都请将 scaledSize 的值设置为整个图像的大小,并用换算值设置大小、原点和锚点。MarkerImage 在构造完成后就无法更改。

MarkerShape对象规范

此对象定义用于确定标记的可点击区域的标记形状。该形状包括两个属性(type coord),这两个属性定义该类型的标记特有的常规类型的标记和坐标。

属性

属性

类型

说明

coord

Array.<number>

此属性的格式取决于 type 的值,并且遵循 http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords 上的 w3 AREA coords 规范。
coord 是一个整数数组,其中的整数指定形状相对于目标图像左上角的像素位置。坐标取决于下面所示的 type 值:
  - circcircle:coord 是 [x1,y1,r],其中 x1,y2 是圆心的坐标,而 r 是圆的半径。
  - polypolygon:coord 是 [x1,y1,x2,y2...xn,yn],其中每个 x,y 对包含多边形的一个顶点的坐标。
  - rectrectangle:coord 是 [x1,y1,x2,y2],其中 x1,y1 是矩形的左上角的坐标,而 x2,y2 是矩形的右下角的坐标。

type

string

描述形状的类型,并且可以是 circlepolyrectangle

Polyline

折线是地图上的连接线段的线性叠加层。此类扩展了 MVCObject

构造函数

构造函数

说明

Polyline(opts?:PolylineOptions)

使用传递的 Polyline options 创建折线,这些选项可以指定折线的路径以及绘制折线时要使用的笔触样式。您可以在构造折线时传递 LatLng 数组或 LatLngMVCArray,但在实例化时,简单的数组会在折线中转换为 MVCArray

方法

方法

返回值

说明

getMap()

Map

传回已附加此折线或多边形的地图。

getPath()

MVCArray.<LatLng>

检索第一条路径。

setMap(map:Map)

None

在指定地图上渲染此折线或多边形。如果地图设置为 Null,则会删除此折线或多边形。

setOptions(options:PolylineOptions)

None

setPath(path:
    MVCArray.<LatLng>|
    Array.<LatLng>)

None

设置第一条路径。有关详细信息,请参见 Polyline options

事件

事件

参数

说明

click

MouseEvent

对折线触发 DOM click 事件时会触发此事件。

dblclick

MouseEvent

对折线触发 DOM dblclick 事件时会触发此事件。

mousedown

MouseEvent

对折线触发 DOM mousedown 事件时会触发此事件。

mousemove

MouseEvent

对折线触发 DOM mousemove 事件时会触发此事件。

mouseout

MouseEvent

此事件针对折线 mouseout 触发。

mouseover

MouseEvent

此事件针对折线 mouseover 触发。

mouseup

MouseEvent

对折线触发 DOM mouseup 事件时会触发此事件。

rightclick

MouseEvent

右键点击折线时会触发此事件。

PolylineOptions对象规范

属性

属性

类型

说明

clickable

boolean

指示此 Polyline 是否处理 click 事件。默认值为 true

geodesic

boolean

将每条边渲染为测地线(“大圆”的一段)。测地线是沿地球表面的两点之间的最短路径。

map

Map

要在其上显示折线的地图。

path

MVCArray.<LatLng>|
Array.<LatLng>

折线坐标的有序序列。可以使用一个简单的 LatLng 数组或者 LatLngMVCArray 指定此路径。请注意,如果您传递简单的数组,则它会转换为 MVCArray。在 MVCArray 中插入或删除 LatLng 将自动更新地图上的折线。

strokeColor

string

采用 HTML 十六进制样式的笔触颜色,即“#FFAA00”

strokeOpacity

number

介于 0.0 和 1.0 之间的笔触不透明度

strokeWeight

number

笔触宽度(以像素为单位)。

zIndex

number

相对于其他折线的 zIndex。

Polygon

多边形(类似于折线)可在一个有序序列中定义一系列连接坐标;此外,多边形会形成一个闭合环并定义一个填充区域。此类扩展了 MVCObject

构造函数

构造函数

说明

Polygon(opts?:PolygonOptions)

使用传递的 Polygon options 创建多边形,这些选项可以指定多边形的路径、多边形边缘的笔触样式,以及多边形内部区域的填充样式。一个多边形可以包含一条或多条路径,其中每条路径由一个 LatLng 数组组成。您可以在构造这些路径时传递一个 LatLng 数组或 LatLngMVCArray。实例化时,数组会在多边形中转换为 MVCArray

方法

方法

返回值

说明

getMap()

Map

传回已附加此折线或多边形的地图。

getPath()

MVCArray.<LatLng>

检索第一条路径。

getPaths()

MVCArray.<MVCArray.<LatLng>>

检索此多边形的路径。

setMap(map:Map)

None

在指定地图上渲染此折线或多边形。如果地图设置为 Null,则会删除此折线或多边形。

setOptions(options:PolygonOptions)

None

setPath(path:
    MVCArray.<LatLng>|
    Array.<LatLng>)

None

设置第一条路径。有关详细信息,请参见 Polyline options

setPaths(paths:
    MVCArray.<MVCArray.<LatLng>>|
    MVCArray.<LatLng>|
    Array.<Array.<LatLng>>|
    Array.<LatLng>)

None

设置此多边形的路径。

事件

事件

参数

说明

click

MouseEvent

对多边形触发 DOM click 事件时会触发此事件。

dblclick

MouseEvent

对多边形触发 DOM dblclick 事件时会触发此事件。

mousedown

MouseEvent

对多边形触发 DOM mousedown 事件时会触发此事件。

mousemove

MouseEvent

对多边形触发 DOM mousemove 事件时会触发此事件。

mouseout

MouseEvent

此事件针对多边形 mouseout 触发。

mouseover

MouseEvent

此事件针对多边形 mouseover 触发。

mouseup

MouseEvent

对多边形触发 DOM mouseup 事件时会触发此事件。

rightclick

MouseEvent

右键点击多边形时会触发此事件。

PolygonOptions对象规范

属性

属性

类型

说明

clickable

boolean

指示此 Polygon 是否处理 click 事件。默认值为 true

fillColor

string

采用 HTML 十六进制样式的填充颜色,即“#00AAFF”

fillOpacity

number

介于 0.0 和 1.0 之间的填充不透明度

geodesic

boolean

将每条边渲染为测地线(“大圆”的一段)。测地线是沿地球表面的两点之间的最短路径。

map

Map

要在其上显示多边形的地图。

paths

MVCArray.<MVCArray.<LatLng>>|
MVCArray.<LatLng>|
Array.<Array.<LatLng>>|
Array.<LatLng>

用于指定闭合环的坐标的有序序列。不同于折线,一个多边形由一条或多条路径组成。因此,路径属性可以指定一个或多个 LatLng 坐标数组。可以使用一个 LatLng 数组定义简单的多边形。多个复杂的多边形可以指定一系列数组。任何简单数组都可以转换为 MVCArray。在 MVCArray 中插入或删除 LatLng 将自动更新地图上的多边形。

strokeColor

string

采用 HTML 十六进制样式的笔触颜色,即“#FFAA00”

strokeOpacity

number

介于 0.0 和 1.0 之间的笔触不透明度

strokeWeight

number

笔触宽度(以像素为单位)。

zIndex

number

相对于其他折线的 zIndex。

InfoWindow

叠加层外观与提示框类似,通常会连接到某个标记。此类扩展了 MVCObject

构造函数

构造函数

说明

InfoWindow(opts?:InfoWindowOptions)

创建带有指定选项的信息窗口。信息窗口可以放置在地图的特定位置,也可以位于标记上方,具体取决于选项中指定的内容。除非停用自动平移,否则,信息窗口会在打开后平移地图,以便让自己显示出来。信息窗口构建完成后,您需要调用 open 函数,才能在地图上显示该窗口。用户可以点击信息窗口上的关闭按钮将其从地图中关闭,开发人员也可以调用 close() 函数实现同样的效果。

方法

方法

返回值

说明

close()

None

关闭此信息窗口,方法是将其从 DOM 结构中删除。

getContent()

string|Node

getPosition()

LatLng

getZIndex()

number

open(map:Map|StreetViewPanorama,anchor?:MVCObject)

None

在指定的地图上打开这个信息窗口。信息窗口可以与锚点相关联,但这属于可选操作。在核心 API 中,唯一的锚点是 Marker 类。不过,锚点可以是展示位置属性的任意 MVCObject,也可以是用于计算 pixelOffset 的可选 pixelBounds(请参见 InfoWindowOptions)。

setContent(content:string|Node)

None

setOptions(options:InfoWindowOptions)

None

setPosition(position:LatLng)

None

setZIndex(zIndex:number)

None

事件

事件

参数

说明

closeclick

None

点击关闭按钮时会触发此事件。

content_changed

None

内容属性更改时会触发此事件。

domready

None

当包含 InfoWindow 的内容的 <div> 附加到 DOM 时,会触发此事件。如果您要动态构建信息窗口内容,则可能希望监视此事件。

position_changed

None

位置属性更改时会触发此事件。

zindex_changed

None

信息窗口的 zIndex 更改时会触发此事件。

InfoWindowOptions对象规范

属性

属性

类型

说明

content

string|Node

要在信息窗口中显示的内容。该内容可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。信息窗口将会根据相应内容调整大小。要设置内容的具体大小,请将内容设置为相应大小的 HTML 元素。

disableAutoPan

boolean

停用在打开时自动平移的功能。默认情况下,信息窗口会在打开后平移地图,以便让自己完全显示出来。

maxWidth

number

信息窗口的最大宽度(不考虑内容的宽度)。仅在已调用 open 函数前设置了该值时,才考虑使用这个值。在更改内容时,如果要更改最大宽度,请调用 close 函数、setOptions 函数,然后调用 open 函数。

pixelOffset

Size

信息窗口的箭头距离信息窗口在地图上所锚定地理坐标点的偏移量(以像素为单位)。如果信息窗口是通过锚点打开的,则从锚点范围的顶部中心开始计算 pixelOffset。

position

LatLng

用于显示此信息窗口的 LatLng。如果信息窗口是通过锚点打开的,则使用锚点的位置。

zIndex

number

所有信息窗口按 zIndex 值的大小顺序在地图上显示,zIndex 值较大的信息窗口显示在值较小的信息窗口之前。默认情况下,信息窗口是按纬度显示的,纬度较低的信息窗口显示在纬度较高的信息窗口前。信息窗口始终在标记前面显示。

Geocoder

用于在地址和 LatLng 之间进行转换的服务。

构造函数

构造函数

说明

Geocoder()

创建可将地址解析请求发送到 Google 服务器的新 Geocoder 实例。

方法

方法

返回值

说明

geocode(request:GeocoderRequest, callback:function(Array.<GeocoderResult>,GeocoderStatus)))

None

对请求内容进行地址解析。

GeocoderRequest对象规范

要发送到 Geocoder 的地址解析请求的规范。

属性

属性

类型

说明

address

string

地址。可选。

bounds

LatLngBounds

要在其中进行搜索的 LatLngBounds。可选。

language

string

用于显示结果的首选语言。可选。

location

LatLng

要搜索的 LatLng。可选。

region

string

要在其中进行搜索的国家/地区代码的顶级域名。可选。

GeocoderStatus

完成对 geocode() 的调用时由 Geocoder 传回的状态。

常数

常数

说明

ERROR

连接 Google 服务器时出错。

INVALID_REQUEST

GeocoderRequest 无效。

OK

响应包含有效的 GeocoderResponse

OVER_QUERY_LIMIT

网页发出请求的频率过高,超过了最短时间限制。

REQUEST_DENIED

不允许网页使用地址解析器。

UNKNOWN_ERROR

由于服务器错误而无法处理地址解析请求。如果您再试一次,该请求可能会成功。

ZERO_RESULTS

未找到此 GeocoderRequest 的结果。

GeocoderResult对象规范

一个地址解析器将生成从地址解析服务器检索的 JSON格式。请注意,地址解析可能会传回多个结果对象。

属性

属性

类型

说明

address_components

Array.<GeocoderAddressComponent>

一个 GeocoderAddressComponent 数组

geometry

GeocoderGeometry

一个 GeocoderGeometry 对象

types

Array.<string>

一个字符串数组,这些字符串表示传回的地址解析元素的类型。一种类型,由标识地址解析结果的唯一字符串组成。(例如,“administrative_area_level_1”、“country”等等。)

GeocoderAddressComponent对象规范

GeocoderResult 中的一个地址组件。一个完整地址可能由多个地址组件组成。

属性

属性

类型

说明

long_name

string

地址组件的完整文本

short_name

string

指定地址组件的简短缩写文本

types

Array.<string>

一个字符串数组,这些字符串指示此地址组件的类型

GeocoderGeometry对象规范

有关此 GeocoderResult 的几何信息

属性

属性

类型

说明

bounds

LatLngBounds

GeocodeResult 的精确范围(如果有)

location

LatLng

此结果的纬度/经度坐标

location_type

GeocoderLocationType

location 中传回的位置类型

viewport

LatLngBounds

用于显示此 GeocodeResult 的建议可视区域的范围

GeocoderLocationType

描述地址解析返回的位置类型。

常数

常数

说明

APPROXIMATE

传回的结果是近似值。

GEOMETRIC_CENTER

传回的结果是线(例如街道)或多边形(区域)等结果的几何中心。

RANGE_INTERPOLATED

返回的结果反映了通过插值取得的近似地址(通常在某条道路上),该地址处于两个精确点(如十字路口)之间。当无法对街道地址进行公开的地址解析时,通常会返回插值结果。

ROOFTOP

传回的结果反映了精确的地址解析。

DirectionsRenderer

以从 DirectionsService 检索的 DirectionsResult 对象的形式渲染检索的路线。此类扩展了 MVCObject

构造函数

构造函数

说明

DirectionsRenderer(opts?:DirectionsRendererOptions)

使用指定选项创建渲染程序。路线可以渲染在地图(作为可视叠加层)上,也可以渲染在 <div> 面板(作为文本说明)上。

方法

方法

返回值

说明

getDirections()

DirectionsResult

传回渲染程序的当前路线集。

getMap()

Map

传回在其上渲染 DirectionsResult 的地图。

getPanel()

Node

传回在其中渲染 DirectionsResult 的面板 <div>

getRouteIndex()

number

传回此 DirectionsRenderer 对象使用的当前(基于零的)路线索引。

setDirections(directions:DirectionsResult)

None

将渲染程序设置为使用 DirectionsService 中的结果。以这种方式设置一组有效的路线将在渲染程序的指定地图和面板上显示这些路线。

setMap(map:Map)

None

此方法指定将在其上渲染路线的地图。传递 null 可从地图中删除路线。

setPanel(panel:Node)

None

此方法在 <div> 中渲染路线。传递 null 可从面板中删除内容。

setRouteIndex(routeIndex:number)

None

DirectionsResult 对象中设置要渲染的路线的(基于零的)索引。默认情况下,将渲染数组中的第一条路线。

DirectionsRendererOptions对象规范

此对象定义可在 DirectionsRenderer 对象上设置的属性。

属性

属性

类型

说明

directions

DirectionsResult

要在地图上和/或 <div> 面板中显示的路线,作为 DirectionsResult 对象从DirectionsService 中检索。

hideRouteList

boolean

此属性指示渲染程序是否应提供用户界面以在备选路线中进行选择。默认情况下,此标记为 false,并且用户可选择的路线列表将显示在路线的关联面板中。要隐藏该列表,请将hideRouteList 设置为 true

map

Map

要在其上显示路线的地图。

markerOptions

MarkerOptions

标记的选项。由 DirectionsRenderer 渲染的所有标记都将使用这些选项。

panel

Node

要在其中显示路线路段的 <div>

polylineOptions

PolylineOptions

折线的选项。由 DirectionsRenderer 渲染的所有折线都将使用这些选项。

preserveViewport

boolean

默认情况下,输入地图会居中并缩放以适应此组路线的边框。如果此选项设置为 true,则可视区域将保持不变,但如果从未设置地图的中心和缩放则例外。

routeIndex

number

DirectionsResult 对象中路线的索引。默认值为 0。

suppressBicyclingLayer

boolean

当请求骑车路线时,取消 BicyclingLayer 的渲染。

suppressInfoWindows

boolean

取消信息窗口的渲染。

suppressMarkers

boolean

取消标记的渲染。

suppressPolylines

boolean

取消折线的渲染。

DirectionsService

用于计算两个或多个位置之间路线的服务。

构造函数

构造函数

说明

DirectionsService()

创建可将路线查询发送到 Google 服务器的新 DirectionsService 实例。

方法

方法

返回值

说明

route(request:DirectionsRequest, callback:function(DirectionsResult, DirectionsStatus)))

None

发出路线搜索请求。

DirectionsRequest对象规范

将发送到 DirectionsService 的路线查询。

属性

属性

类型

说明

avoidHighways

boolean

如果为 true,则指示路线服务尽可能避开高速公路。可选。

avoidTolls

boolean

如果为 true,则指示路线服务尽可能避开收费公路。可选。

destination

LatLng|string

目标位置。可将此项指定为要进行地址解析的字符串或 LatLng。必填。

optimizeWaypoints

boolean

如果设置为 true,DirectionService 将尝试重新排列所提供中间路标的顺序,从而最大程度地降低路线的总体成本。如果优化路标,则检查响应中的DirectionsRoute.waypoint_order 以确定新顺序。

origin

LatLng|string

原点的位置。可将此项指定为要进行地址解析的字符串或 LatLng。必填。

provideRouteAlternatives

boolean

是否应提供备选路线。可选。

region

string

用作地址解析请求偏向的区域代码。可选。

travelMode

DirectionsTravelMode

请求的路线类型。必填。

unitSystem

DirectionsUnitSystem

显示距离时要使用的首选单位制。默认为原点所在国家/地区使用的单位制。

waypoints

Array.<DirectionsWaypoint>

中间路标的数组。将通过此数组中的每个路标计算从原点到目标的路线。可选。

DirectionsTravelMode

可在 DirectionsRequest 中指定的有效出行方式以及在 DirectionsStep 中传回的出行方式。

常数

常数

说明

BICYCLING

指定骑车路线请求。

DRIVING

指定行车路线请求。

WALKING

指定步行路线请求。

DirectionsUnitSystem

可在 DirectionsRequest 中指定的有效单位制。

常数

常数

说明

IMPERIAL

指定应以英制单位表示 DirectionsResult 中的距离。

METRIC

指定应以公制单位表示 DirectionsResult 中的距离。

DirectionsWaypoint对象规范

DirectionsWaypoint 表示介于原点和目标之间的位置,行程路线将通过该位置。

属性

属性

类型

说明

location

LatLng|string

路标位置。可以是地址字符串或 LatLng。可选。

stopover

boolean

如果为 true,则表示此路标是介于原点和目标之间的站点。这会导致将路线一分为二。默认情况下,此值为true。可选。

DirectionsStatus

完成对 route() 的调用时由 DirectionsService 传回的状态。

常数

常数

说明

INVALID_REQUEST

提供的 DirectionsRequest 无效。

MAX_WAYPOINTS_EXCEEDED

DirectionsRequest 中提供的 DirectionsWaypoint 过多。允许的总路标数为 8 个,此外还包括原点和目标。

NOT_FOUND

至少无法对原点、目标或路标之一进行地址解析。

OK

响应包含有效的 DirectionsResult

OVER_QUERY_LIMIT

网页发出请求的频率过高,超过了最短时间限制。

REQUEST_DENIED

不允许网页使用路线服务。

UNKNOWN_ERROR

由于服务器错误而无法处理路线请求。如果您再试一次,该请求可能会成功。

ZERO_RESULTS

在原点和目标之间找不到任何路线。

DirectionsResult对象规范

路线以从路线服务器检索的 JSON格式进行响应。您可以使用 DirectionsRenderer 渲染这些路线,也可以解析此对象并自行渲染它。您必须显示Google Maps API 服务条款中描述的警告和版权。

属性

属性

类型

说明

routes

Array.<DirectionsRoute>

DirectionsRoute 数组,其中每一个都包含自己所含路程和路段的相关信息。除非创建 DirectionsRequestprovideRouteAlternatives 设置为 true,否则将只有一条路线。(此属性以前称为“trips”。)

DirectionsRoute对象规范

一条在 DirectionsResult 中包含一组JSON 格式的路程的路线。(此对象以前称为“DirectionsTrip”)。

属性

属性

类型

说明

bounds

LatLngBounds

此路线的范围。

copyrights

string

要针对此路线显示的版权文本。

legs

Array.<DirectionsLeg>

DirectionsLeg 数组,其中每个路程都包含有关自己所包含的路段的信息。对于指定的每个路标或目标都有一个路程。因此,没有路标的路线将包含一个 DirectionsLeg,而具有一个路标的路线将包含两个路线路程。(此属性以前称为“routes”。)

overview_path

Array.<LatLng>

LatLng 数组,代表此路线的整个路程。该路径已简化,目的是为了适应需要少量顶点的环境(如 Google Static Maps API 网址)。

warnings

Array.<string>

显示这些路线时将要显示的警告。

waypoint_order

Array.<number>

如果 optimizeWaypoints 设置为 true,则此字段将包含输入路标的重新排序的排列。例如,如果输入为:
  原点:洛杉矶
  路标:达拉斯、班戈区、菲尼克斯
  目标:纽约
优化后的输出顺序如下:
  原点:洛杉矶
  路标:菲尼克斯、达拉斯、班戈区
  目标:纽约
之后,此字段将为包含值 [2, 0, 1] 的 Array。请注意,路标的编号是从零开始的。
如果任何输入路标将 stopover 设置为 false,则此字段将为空,这是因为路线优化尚不可用于此类查询。

DirectionsLeg对象规范

一个路程,在 DirectionsResult 中包含一组JSON 格式的路段。路程中的某些字段可能并不会针对所有请求都传回。(此对象以前称为“DirectionsRoute”)。

属性

属性

类型

说明

distance

DirectionsDistance

此路程覆盖的总距离。此属性可能未定义,因为距离可能未知。

duration

DirectionsDuration

此路程的总持续时间。此属性可能未定义,因为持续时间可能未知。

end_address

string

此路程的目标地址。

end_location

LatLng

DirectionsService 使用起始位置和结束位置处最近的交通选项(通常为道路)计算两个位置之间的路线。end_location 指示实际的地址解析目标,在诸如以下的情况下,该目标可能不同于最后一个路段的 end_location:道路距离此路程的目标较远。

start_address

string

此路程的原点地址。

start_location

LatLng

DirectionsService 使用起始位置和结束位置处最近的交通选项(通常为道路)计算两个位置之间的路线。start_location 指示实际的地址解析原点,在诸如以下的情况下,该原点可能不同于第一个路段的 start_location:道路距离此路程的原点较远。

steps

Array.<DirectionsStep>

DirectionsStep 数组,其中每个路段都包含有关此路程中各个路段的信息。

DirectionsStep对象规范

DirectionsResult 中的一个采用 JSON格式的 DirectionsStep。某些字段可能尚未定义。

属性

属性

类型

说明

distance

DirectionsDistance

此路段覆盖的距离。此属性可能未定义,因为距离可能未知。

duration

DirectionsDuration

完成此路段通常所需的时间(以秒为单位,采用文本形式)。此属性可能未定义,因为持续时间可能未知。

end_location

LatLng

此路段的结束位置。

instructions

string

此路段的说明。

path

Array.<LatLng>

LatLng 的序列,描述此路段的路程。

start_location

LatLng

此路段的起始位置。

DirectionsDistance对象规范

距离的表示(采用数值和显示字符串的形式)。

属性

属性

类型

说明

text

string

距离值的字符串表示,使用请求中指定的 DirectionsUnitSystem

value

number

距离(以米为单位)。

DirectionsDuration对象规范

持续时间的表示(采用数值和显示字符串的形式)。

属性

属性

类型

说明

text

string

持续时间值的字符串表示。

value

number

持续时间(以秒为单位)。

ElevationService

定义可直接与 Google服务器对话以请求海拔数据的服务类。

构造函数

构造函数

说明

ElevationService()

创建可将海拔查询发送到 Google 服务器的新 ElevationService 实例。

方法

方法

返回值

说明

getElevationAlongPath(request:PathElevationRequest,callback:function(Array.<ElevationResult>, ElevationStatus)))

None

沿路径创建海拔请求,其中海拔数据作为基于距离的示例沿该路径传回。

getElevationForLocations(request:LocationElevationRequest,callback:function(Array.<ElevationResult>, ElevationStatus)))

None

针对一系列离散位置创建海拔请求。

LocationElevationRequest对象规范

由包含一系列离散坐标 (LatLng) ElevationService 发送的海拔请求,将针对这些坐标传回海拔数据。

属性

属性

类型

说明

locations

Array.<LatLng>

要为其检索海拔的离散位置。

PathElevationRequest对象规范

由包含路径的 ElevationService 发送的海拔查询,沿该路径传回采样数据。此请求定义沿地球的连续路径,沿该路径,将等距离获取海拔示例。顶点间的所有路径都使用介于这两点间的大圆线段。

属性

属性

类型

说明

path

Array.<LatLng>

要沿其收集海拔值的路径。

samples

Number

必填。沿指定路径的等距点数,要针对该路径检索海拔数据,包括端点。示例数必须介于 2 和 1024 之间。

ElevationResult对象规范

ElevationService 请求的结果,由一组海拔坐标及其海拔值组成。请注意,一个请求可以生成多个 ElevationResult

属性

属性

类型

说明

elevation

Number

地球上此点的海拔(以高于海平面的米数表示)。

location

LatLng

此海拔结果的位置。

ElevationStatus

完成海拔请求时由 ElevationService 传回的状态。

常数

常数

说明

INVALID_REQUEST

请求无效。

OK

请求没有遇到任何错误。

OVER_QUERY_LIMIT

网页发出请求的频率过高,超过了最短时间限制。

REQUEST_DENIED

出于某种原因,不允许网页使用海拔服务。

UNKNOWN_ERROR

无法成功处理地址解析、路线或海拔请求,但是确切的失败原因未知。

OverlayView

如果想在地图上显示自定义类型的叠加层对象,则可以使用此类。此类扩展了 MVCObject

构造函数

构造函数

说明

OverlayView()

您应当继承此类,方法是将叠加层的 prototype 设置为 new OverlayView.prototype。必须实现三个方法,即 onAdd()、draw() 和 onRemove()。在 add() 方法中,您应当创建 DOM 对象,并将其作为窗格的子对象附加。在 draw() 方法中,应放置这些元素。在 onRemove() 方法中,应将对象从 DOM 中删除。您必须调用包含有效地图对象的 setMap(),以触发对 onAdd() 方法和 setMap(null) 的调用,这样才能触发 onRemove() 方法。可以在构建叠加层时调用 setMap() 方法,也可以在需要重新显示已删除叠加层的任何时候调用该方法。每当地图属性更改时都会调用 draw() 方法,该方法可以更改元素的位置,如缩放、中心或地图类型。

方法

方法

返回值

说明

draw()

None

实现此方法可绘制或更新叠加层。在实现 onAdd() 以后,并且 projection.fromLatLngToPixel() 的位置返回指定 LatLng 的新值时,调用此方法。缩放、中心或地图类型发生更改时将会调用此方法。拖动或重新设定大小时无需调用该方法。

getMap()

Map

getPanes()

MapPanes

返回可在其中显示此 OverlayView 的窗格。仅在调用 draw 函数后才可用。

getProjection()

MapCanvasProjection

返回与相应 OverlayView 相关联的 MapCanvasProjection 对象。仅在调用 draw 函数后才可用。

onAdd()

None

实现此方法可初始化叠加层 DOM 元素。对有效地图调用 setMap() 之后,调用该方法一次。此时将会初始化窗格和投影。

onRemove()

None

实现此方法可将您的元素从 DOM 删除。调用 setMap(null) 之后立即调用此方法。

setMap(map:Map|StreetViewPanorama)

None

将叠加层添加到地图或全景图。

MapType对象规范

此接口定义地图类型。此接口通常用于基本地图,如道路、卫星或混合地图。固定不变。

方法

方法

返回值

说明

getTile(tileCoord:Point, zoom:number,ownerDocument:Document)

Node

传回指定图块坐标 (x, y) 和缩放级别的图块。此图块将附加到指定 ownerDocument。

releaseTile(tile:Node)

None

释放指定图块,并执行全部所需的清理。已从文档中删除了提供的图块。可选。

属性

属性

类型

说明

alt

string

当此 MapType 的按钮悬停在 MapTypeControl 中时显示的备选文本。可选。

maxZoom

number

显示此 MapType 时地图的最大缩放级别。对于基本 MapType,为必填项。而对于叠加层 MapType,则将其忽略。

minZoom

number

显示此 MapType 时地图的最小缩放级别。可选;默认值为 0。

name

string

要在 MapTypeControl 中显示的名称。可选。

projection

Projection

用于渲染此 MapType 的投影。可选;默认值为 Mercator。

radius

number

地图的行星半径(以米为单位)。可选;默认为地球的赤道半径(6378137 米)。

tileSize

Size

每个图块的尺寸。必填。

MapTypeRegistry

此类扩展了 MVCObject

构造函数

构造函数

说明

MapTypeRegistry()

MapTypeRegistry 拥有一组可用于地图以帮助它实现用途的自定义地图类型。例如,API 将在提供控件中的可用地图类型列表时参考此注册表。

方法

方法

返回值

说明

set(id:string, mapType:MapType)

None

设置注册表以将传递的字符串标识符与传递的 MapType 相关联。

Projection对象规范

方法

方法

返回值

说明

fromLatLngToPoint(latLng:LatLng,point?:Point)

Point

从 LatLng 圆柱转换为 Point 平面。此接口指定一个函数,该函数实现从指定 LatLng 值到地图投影上的世界地图坐标的转换。Google Maps API 在需要在屏幕上绘制位置时调用此方法。Projection 对象必须实现此方法。

fromPointToLatLng(pixel:Point,nowrap?:boolean)

LatLng

此接口指定一个函数,该函数实现从地图投影上的世界地图坐标到 LatLng 值的转换。Google Maps API 在需要将屏幕上的操作转换为地图上的位置时调用此方法。Projection对象必须实现此方法。

ImageMapType

此类实现 MapType接口并提供用于渲染图像图块。

构造函数

构造函数

说明

ImageMapType(opts:ImageMapTypeOptions)

使用提供的 ImageMapTypeOptions 构造 ImageMapType

ImageMapTypeOptions对象规范

此类用于创建可渲染图像图块的 MapType

属性

属性

类型

说明

alt

string

当此 MapType 的按钮悬停在 MapTypeControl 中时显示的备选文本。

getTileUrl

Function(Point, number):string

传回指定图块坐标 (x, y) 和缩放级别的字符串(网址)。此函数应带有 getTileUrl(Point, number):string 标志。

isPng

boolean

图像是否为 PNG 格式?某些旧浏览器要求这一点。

maxZoom

number

显示此 MapType 时地图的最大缩放级别。

minZoom

number

显示此 MapType 时地图的最小缩放级别。可选。

name

string

要在 MapTypeControl 中显示的名称。

opacity

number

应用到图块的不透明度。应将不透明度指定为介于 0 和 1.0 之间的浮动值,其中 0 表示完全透明,而 1 表示完全不透明。

tileSize

Size

图块大小。

StyledMapType

使用自定义样式创建 MapType

构造函数

构造函数

说明

StyledMapType(style:Array.<MapTypeStyle>,options?:StyledMapTypeOptions)

使用指定选项创建带有样式的 MapTypeStyledMapType 会获取一个 MapTypeStyle 数组,其中各个MapTypeStyle 会相继应用到地图。如果后一个 MapTypeStyle 像前一个 MapTypeStyle 一样将相同的MapTypeStyler 应用到相同的选择器,则它将覆盖前一个 MapTypeStyle

StyledMapTypeOptions对象规范

此类用于在创建 StyledMapType 时指定选项。

属性

属性

类型

说明

alt

string

当此 MapType 的按钮悬停在地图类型控件中时显示的备选文本。

baseMapType

StyledMapType

StyledMapType,其样式应当用作定义 StyledMapType 样式时所基于的样式。MapTypeStyle 规则将附加到基础样式。

maxZoom

number

显示此 MapType 时地图的最大缩放级别。可选。

minZoom

number

显示此 MapType 时地图的最小缩放级别。可选。

name

string

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

MapTypeStyle对象规范

MapTypeStyle 是定义如何为地图设置样式的选择器和样式器的集合。选择器指定哪些地图元素将受影响,而样式器指定应如何修改这些元素。

属性

属性

类型

说明

elementType

MapTypeStyleElementType

选择将应用某样式器的元素类型。元素类型在特征的表示方面各具特色。可选;如果未指定elementType,则假设值为 'all'

featureType

MapTypeStyleFeatureType

选择要应用样式器的单个特征或者特征组。可选;如果未指定 featureType,则假设值为'all'

stylers

Array.<MapTypeStyler>

要应用到选择器的样式规则。规则按它们在此数组中列出的顺序应用到地图的元素。

MapTypeStyleFeatureType对象规范

特征类型的可能值。将这些值指定为字符串形式,即 'administrative' 'poi.park'。应用到父特征类型的样式器将自动应用到所有子特征类型。但是请注意,父特征可能包括它的某个子特征类型不包括的其他一些特征。

常数

常数

说明

administrative

将规则应用到管理区域。

administrative.country

将规则应用到国家/地区。

administrative.land_parcel

将规则应用到地块。

administrative.locality

将规则应用到地区。

administrative.neighborhood

将规则应用到邻近地区。

administrative.province

将规则应用到省。

all

将规则应用到所有选择器类型。

landscape

将规则应用到景观。

landscape.man_made

将规则应用到人工结构。

landscape.natural

将规则应用到自然特征。

poi

将规则应用到兴趣点。

poi.attraction

将规则应用到游客感兴趣的地方。

poi.business

将规则应用到企业。

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.rail

将规则应用到火车站。

water

将规则应用到水体。

MapTypeStyleElementType对象规范

每个 MapTypeStyleElementType 在特征的表示方面各具特色。

常数

常数

说明

all

将规则应用到指定特征的所有元素。

geometry

将规则应用到特征的几何体。

labels

将规则应用到特征的标签。

MapTypeStyler对象规范

样式器影响为地图元素设置样式的方式。每个 MapTypeStyler 都应包含一个(并且仅包含一个)键。如果在一个 MapTypeStyler 中指定多个键,则仅有一个键不被忽略。例如:var rule = {hue: '#ff0000'}

属性

属性

类型

说明

gamma

number

Gamma。通过将亮度提升至指定功率来修改 gamma。有效值:浮点数 [0.01, 10],其中 1.0 表示没有变化。

hue

string

将特征的色调设置为与所提供的色调匹配。请注意,特征的饱和度和亮度会保留下来,这意味着特征与提供的颜色不会完全匹配。有效值:RGB 十六进制字符串,即,'#ff0000'

invert_lightness

boolean

反转亮度。如果值为 true, 将反转特征的亮度,同时保留色调和饱和度。

lightness

number

亮度。通过以下方法改变颜色亮度:如果是降低亮度,则按原始值的百分比改变;如果是增加亮度,则按剩余值的百分比改变。有效值:[-100, 100]。

saturation

number

饱和度。通过以下方法改变颜色饱和度:如果是降低饱和度,则按原始值的百分比改变;如果是增加饱和度,则按剩余值的百分比改变。有效值:[-100, 100]。

visibility

string

可见性:有效值:“打开”、“关闭”或“简化”。

Rectangle

矩形叠加层。此类扩展了 MVCObject

构造函数

构造函数

说明

Rectangle(opts?:RectangleOptions)

使用传递的 RectangleOptions(它指定范围和样式)创建矩形。

方法

方法

返回值

说明

getBounds()

LatLngBounds

传回此矩形的范围。

getMap()

Map

传回显示此矩形的地图。

setBounds(bounds:LatLngBounds)

None

设置此矩形的范围。

setMap(map:Map)

None

在指定地图上渲染此矩形。如果地图设置为 Null,则会删除此矩形。

setOptions(options:RectangleOptions)

None

事件

事件

参数

说明

click

MouseEvent

对矩形触发 DOM click 事件时会触发此事件。

dblclick

MouseEvent

对矩形触发 DOM dblclick 事件时会触发此事件。

mousedown

MouseEvent

对矩形触发 DOM mousedown 事件时会触发此事件。

mousemove

MouseEvent

对矩形触发 DOM mousemove 事件时会触发此事件。

mouseout

MouseEvent

此事件针对矩形 mouseout 触发。

mouseover

MouseEvent

此事件针对矩形 mouseover 触发。

mouseup

MouseEvent

对矩形触发 DOM mouseup 事件时会触发此事件。

rightclick

MouseEvent

右键点击矩形时会触发此事件。

RectangleOptions对象规范

属性

属性

类型

说明

bounds

LatLngBounds

范围。

clickable

boolean

指示此 Rectangle 是否处理 click 事件。默认值为 true

fillColor

string

采用 HTML 十六进制样式的填充颜色,即“#00AAFF”

fillOpacity

number

介于 0.0 和 1.0 之间的填充不透明度

map

Map

要在其上显示矩形的地图。

strokeColor

string

采用 HTML 十六进制样式的笔触颜色,即“#FFAA00”

strokeOpacity

number

介于 0.0 和 1.0 之间的笔触不透明度

strokeWeight

number

笔触宽度(以像素为单位)。

zIndex

number

相对于其他折线的 zIndex。

Circle

地球表面的圆;也称为球冠。此类扩展了 MVCObject

构造函数

构造函数

说明

Circle(opts?:CircleOptions)

使用传递的 CircleOptions(它指定中心、半径和样式)创建圆。

方法

方法

返回值

说明

getBounds()

LatLngBounds

获取此圆的 LatLngBounds

getCenter()

LatLng

传回此圆的中心。

getMap()

Map

传回在其上显示此圆的地图。

getRadius()

number

传回此圆的半径(以米为单位)。

setCenter(center:LatLng)

None

设置此圆的中心。

setMap(map:Map)

None

在指定地图上渲染此圆。如果地图设置为 Null,则会删除此圆。

setOptions(options:CircleOptions)

None

setRadius(radius:number)

None

设置此圆的半径(以米为单位)。

事件

事件

参数

说明

click

MouseEvent

对圆触发 DOM click 事件时会触发此事件。

dblclick

MouseEvent

对圆触发 DOM dblclick 事件时会触发此事件。

mousedown

MouseEvent

对圆触发 DOM mousedown 事件时会触发此事件。

mousemove

MouseEvent

对圆触发 DOM mousemove 事件时会触发此事件。

mouseout

MouseEvent

此事件针对圆 mouseout 触发。

mouseover

MouseEvent

此事件针对圆 mouseover 触发。

mouseup

MouseEvent

对圆触发 DOM mouseup 事件时会触发此事件。

rightclick

MouseEvent

右键点击圆时会触发此事件。

CircleOptions对象规范

属性

属性

类型

说明

center

LatLng

中心

clickable

boolean

指示此 Circle 是否处理 click 事件。默认值为 true

fillColor

string

采用 HTML 十六进制样式的填充颜色,即“#00AAFF”

fillOpacity

number

介于 0.0 和 1.0 之间的填充不透明度

map

Map

要在其上显示圆的地图。

radius

number

地球表面的半径(以米为单位)。

strokeColor

string

采用 HTML 十六进制样式的笔触颜色,即“#FFAA00”

strokeOpacity

number

介于 0.0 和 1.0 之间的笔触不透明度

strokeWeight

number

笔触宽度(以像素为单位)。

zIndex

number

相对于其他折线的 zIndex。

GroundOverlay

地图上的矩形图像叠加层。此类扩展了 MVCObject

构造函数

构造函数

说明

GroundOverlay(url:string, bounds:LatLngBounds,opts?:GroundOverlayOptions)

根据提供的图像网址及其 LatLngBounds 创建地面叠加层。图像会进行缩放以适应当前的范围,并使用当前的地图投影进行投影。

方法

方法

返回值

说明

getBounds()

LatLngBounds

获取此叠加层的 LatLngBounds

getMap()

Map

传回在其上显示此地面叠加层的地图。

getUrl()

string

获取投影图象的网址。

setMap(map:Map)

None

在指定地图上渲染此地面叠加层。如果地图设置为 Null,则会删除此叠加层。

事件

事件

参数

说明

click

MouseEvent

GroundOverlay 触发 DOM click 事件时会触发此事件。

GroundOverlayOptions对象规范

此对象定义可在 GroundOverlay 对象上设置的属性。

属性

属性

类型

说明

clickable

boolean

如果为 true,则地面叠加层可以收到 click 事件。

map

Map

要在其上显示叠加层的地图。

BicyclingLayer

显示自行车道和路径的图层。此类扩展了 MVCObject

构造函数

构造函数

说明

BicyclingLayer()

显示自行车道和路径并表示大型道路的图层。

方法

方法

返回值

说明

getMap()

Map

传回在其上显示此图层的地图。

setMap(map:Map)

None

在指定地图上渲染此图层。如果地图设置为 Null,则会删除此图层。

FusionTablesLayer

利用 FusionTablesLayer,可以在地图上将来自 Google Fusion Table的数据显示为渲染的图层。(有关 Fusion Table的详细信息,请访问 http://code.google.com/apis/fusiontables。)可以使用 Fusion Table API中所使用的相同查询语言查询表数据。此类扩展了 MVCObject

构造函数

构造函数

说明

FusionTablesLayer(tableId:string, opts?:FusionTablesLayerOptions)

显示来自 Fusion Table 的数据的图层。

方法

方法

返回值

说明

getMap()

Map

传回在其上显示此图层的地图。

getQuery()

string

getTableId()

number

传回要从中查询数据的表的 ID。

setMap(map:Map)

None

在指定地图上渲染此图层。如果地图设置为 Null,则会删除此图层。

setOptions(options:FusionTablesLayerOptions)

None

setQuery(query:string)

None

将查询设置为针对 tableId 属性指定的表执行。图层将会更新以显示查询的结果。

setTableId(tableId:number)

None

设置要从中查询数据的表的 ID。设置此值将导致重绘图层。

事件

事件

参数

说明

click

FusionTablesMouseEvent

点击图层中的特征时将会触发此事件。

FusionTablesLayerOptions对象规范

此对象定义可在 FusionTablesLayer 对象上设置的属性。

属性

属性

类型

说明

heatmap

boolean

默认情况下,表数据显示为地理特征。如果为 true,则使用此图层显示热图,该热图表示通过查询选定表传回的地理特征的密度。

map

Map

要在其上显示图层的地图。

query

string

选择要显示的数据时应用的 Fusion Table 查询。查询不得进行网址转义。

suppressInfoWindows

boolean

取消点击图层特征时信息窗口的渲染。

FusionTablesMouseEvent对象规范

FusionTablesLayer 的鼠标事件的属性。

属性

属性

类型

说明

infoWindowHtml

string

预先渲染的 HTML 内容,由默认用户界面放置在信息窗口中。

pixelOffset

Size

要应用于锚定在所点击特征上的信息窗口的偏移量。

position

LatLng

信息窗口在所点击特征上的锚定位置。

row

Object

FusionTablesCell 对象的集合,按列名称编入索引,表示包括所点击特征的表行的内容。

FusionTablesCell对象规范

描述 Fusion Table表中的一个单元格。

属性

属性

类型

说明

columnName

string

单元格所在列的名称。

value

string

单元格的内容。

KmlLayer

KmlLayer 将地理标记添加到位于可公共访问的 Web服务器上的 KMLKMZ GeoRSS 文件中的地图。点击每个特征时将为该特征提供一个 KmlFeatureData 对象。此类扩展了 MVCObject

构造函数

构造函数

说明

KmlLayer(url:string,opts?:KmlLayerOptions)

创建 KmlLayer,它渲染指定 KML/KMZ 文件 (http://code.google.com/apis/kml/documentation/kmlreference.html) 或 GeoRSS 文件 (www.georss.org) 的内容。

方法

方法

返回值

说明

getMap()

Map

获取在其上渲染 KML 图层的地图。

getMetadata()

KmlLayerMetadata

获取与此图层相关联的元数据,如图层标记中所指定。

getUrl()

string

获取所显示的地理标记的网址。

setMap(map:Map)

None

在指定地图上渲染该 KML 图层。如果地图设置为 Null,则会删除此图层。

事件

事件

参数

说明

click

KmlMouseEvent

点击图层中的特征时将会触发此事件。

defaultviewport_changed

None

当 KML 图层默认可视区域改变时会触发此事件。

KmlLayerOptions对象规范

此对象定义可在 KmlLayer 对象上设置的属性。

属性

属性

类型

说明

map

Map

要在其上显示图层的地图。

preserveViewport

boolean

默认情况下,输入地图会居中并缩放以适应图层内容的边框。如果此选项设置为 true,则可视区域将保持不变,但如果从未设置地图的中心和缩放则例外。

suppressInfoWindows

boolean

取消点击图层特征时信息窗口的渲染。

KmlLayerMetadata对象规范

一个 KML图层的元数据(采用 JSON 格式)。

属性

属性

类型

说明

author

KmlAuthor

图层的 <atom:author>,从图层标记中提取。

description

string

图层的 <description>,从图层标记中提取。

name

string

图层的 <name>,从图层标记中提取。

snippet

string

图层的 <Snippet>,从图层标记中提取。

KmlMouseEvent对象规范

KML/KMZ GeoRSS文档的 click 事件的属性。

属性

属性

类型

说明

featureData

KmlFeatureData

KmlFeatureData 对象,包含有关所点击特征的信息。

pixelOffset

Size

要应用于锚定在所点击特征上的信息窗口的偏移量。

position

LatLng

信息窗口在所点击特征上的锚定位置。

KmlFeatureData对象规范

一个 JSON格式的 KML 特征数据,当点击 KML 特征时传回。此对象中包含的数据将镜像声明它时所在的 KML GeoRSS 标记中特征的关联数据。

属性

属性

类型

说明

author

KmlAuthor

特征的 <atom:author>,从图层标记(如果已指定)中提取。

description

string

特征的 <description>,从图层标记中提取。

id

string

特征的 <id>,从图层标记中提取。如果没有指定 <id>,则将为此特征生成唯一 ID。

infoWindowHtml

string

特征的气球样式文本(如果已设置)。

name

string

特征的 <name>,从图层标记中提取。

snippet

string

特征的 <Snippet>,从图层标记中提取。

KmlAuthor对象规范

包含有关 KML文档或特征的作者的详细信息。

属性

属性

类型

说明

email

string

作者的电子邮件地址,或空字符串(如果未指定)。

name

string

作者的姓名,或空字符串(如果未指定)。

uri

string

作者的主页,或空字符串(如果未指定)。

TrafficLayer

路况图层。此类扩展了 MVCObject

构造函数

构造函数

说明

TrafficLayer()

显示当前路况的图层。

方法

方法

返回值

说明

getMap()

Map

传回在其上显示此图层的地图。

setMap(map:Map)

None

在指定地图上渲染此图层。如果地图设置为 Null,则会删除此图层。

StreetViewPanorama

显示指定 LatLng 的全景图或全景图 IDStreetViewPanorama 对象提供街景视图查看器,该查看器可以独立位于单独的 <div> 中,也可绑定到 Map。此类扩展了MVCObject

构造函数

构造函数

说明

StreetViewPanorama(container:Node, opts?:StreetViewPanoramaOptions)

使用传递的 StreetViewPanoramaOptions 创建全景图。

方法

方法

返回值

说明

getLinks()

Array.<StreetViewLink>

传回街景视图全景图的导航链接集。

getPano()

string

传回街景视图全景图的当前全景图 ID。此 ID 仅在浏览器的当前会话中固定不变。

getPosition()

LatLng

传回街景视图全景图的当前LatLng 位置。

getPov()

StreetViewPov

传回街景视图全景图的当前视点。

getVisible()

boolean

如果全景图可见,则传回true。它不指定在指定的位置是否提供街景视图图像。

registerPanoProvider(provider:function(string):StreetViewPanoramaData))

None

设置针对全景图更改调用的自定义全景图提供程序以载入自定义全景图。

setPano(pano:string)

None

设置街景视图全景图的当前全景图 ID。

setPosition(latLng:LatLng)

None

设置街景视图全景图的当前LatLng 位置。

setPov(pov:StreetViewPov)

None

设置街景视图全景图的视点。

setVisible(flag:boolean)

None

设置为 true 可使全景图可见。如果设置为 false,则全景图将会隐藏,无论它是嵌入在地图中还是位于自己的<div> 中都是如此。

属性

属性

类型

说明

controls

Array.<MVCArray.<Node>>

附加到全景图的其他控件。要在全景图中添加控件,请将控件的 <div> 添加到与应渲染它的 MVCArray 相对应的 ControlPosition 中。

事件

事件

参数

说明

closeclick

Event

当点击关闭按钮时会触发此事件。

links_changed

None

当全景图的链接更改时会触发此事件。当全景图 ID 更改后,链接会同步更改。

pano_changed

None

当全景图的全景图 ID 更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时,全景图会更改。请注意,并非所有位置变化都会触发 pano_changed

position_changed

None

当全景图的位置更改时会触发此事件。当用户浏览全景图时或者当手动设置位置时,位置会改变。

pov_changed

None

当全景图的视点更改时会触发此事件。当倾斜度、缩放或方向更改时,视点会改变。

resize

None

当 div 更改大小时,开发人员应针对全景图触发此事件: google.maps.event.trigger(panorama, 'resize')

visible_changed

None

全景图的可见性更改时会触发此事件。当将街景小人拖至地图上时、点击关闭按钮时,或者调用 setVisible()时,可见性会改变。

StreetViewPanoramaOptions对象规范

用于定义 StreetViewPanorama 对象的属性的选项。

属性

属性

类型

说明

addressControl

boolean

地址控件的启用/停用状态。

addressControlOptions

StreetViewAddressControlOptions

地址控件的显示选项。

enableCloseButton

boolean

如果为 true,则显示关闭按钮。默认情况下处于停用状态。

linksControl

boolean

链接控件的启用/停用状态。

navigationControl

boolean

导航控件的启用/停用状态。

navigationControlOptions

NavigationControlOptions

导航控件的显示选项。

pano

string

全景图 ID,应在指定自定义全景图时设置。

panoProvider

Function(string):StreetViewPanoramaData

自定义全景图提供程序,它获取字符串全景图 ID 并传回对象来定义使用该 ID 的全景图。必须定义此函数才可以指定自定义全景图图像。

position

LatLng

街景视图全景图的 LatLng 位置。

pov

StreetViewPov

镜头方向,指定为全景图的方向、倾斜度和缩放。

StreetViewAddressControlOptions对象规范

用于渲染街景视图地址控件的选项。

属性

属性

类型

说明

position

ControlPosition

位置 ID。此 ID 用于指定控件在地图上的位置。默认位置为 TOP_LEFT

style

Object.<string>

要应用到街景视图地址控件的 CSS 样式。例如,{backgroundColor: 'red'}

StreetViewLink对象规范

相邻街景视图全景图的参考集合。

属性

属性

类型

说明

description

string

描述链接的本地化字符串。

heading

number

链接的标题。

pano

string

全景图的唯一标识符。此 ID 在某会话持续期间保持固定不变,但在各会话之间会改变。

roadColor

string

链接的颜色

roadOpacity

number

链接的不透明度

StreetViewPov对象规范

用于指定街景视图全景图位置处镜头方向的视点对象。将视点定义为方向、倾斜度和缩放。

属性

属性

类型

说明

heading

number

相对于正北的镜头方向(以度为单位)。正北为 0°,正东为 90°,正南为 180°,正西为 270°。

pitch

number

相对于街景视图工具的镜头倾斜度(以度为单位)。范围为 90°(朝正上方)到 -90°(朝正下方)。

zoom

number

缩放级别。级别 0 为完全缩小,进行扩大可提高缩放级别。

StreetViewPanoramaData对象规范

从使用 registerPanoProvider 定义的提供程序传回的全景图的表示。

属性

属性

类型

说明

copyright

string

指定此全景图的版权文本。

links

Array.<StreetViewLink>

指定相邻全景图的导航链接。

location

StreetViewLocation

指定此全景图的位置元数据。

tiles

StreetViewTileData

指定此全景图的自定义图块。

StreetViewLocation对象规范

街景视图全景图中某个位置的表示。

属性

属性

类型

说明

description

string

描述位置的本地化字符串。

latLng

LatLng

全景图的 latlng。

pano

string

全景图的唯一标识符。这在某会话持续期间保持固定不变,但在各会话之间会改变。

StreetViewTileData对象规范

在街景视图全景图中使用的图块集的属性。

方法

方法

返回值

说明

getTileUrl(pano:string, tileZoom:number, tileX:number, tileY:number)

string

获取指定图块的图块图像网址。
pano 是街景视图图块的全景图 ID。
tileZoom 是图块的缩放级别。
tileX 是图块的 X 坐标。
tileY 是图块的 Y 坐标。
传回图块图像的网址。

属性

属性

类型

说明

originHeading

number

全景图图块的原点处的方向(以度为单位)。

tileSize

Size

图块的渲染大小(以像素为单位)。这可能不是本机图块图像大小。

worldSize

Size

整个全景图“世界”的大小(以像素为单位)。

StreetViewService

StreetViewService 对象搜索街景视图数据。

方法

方法

返回值

说明

getPanoramaById(pano:string,callback:function(StreetViewPanoramaData,StreetViewStatus):void))

None

检索指定全景图 ID 数据并将它作为 StreetViewPanoramaData 对象传递给提供的回调。全景图 ID 对于每个全景图都是唯一的,并在某会话生命周期内保持固定,但在各会话之间容易改变。

getPanoramaByLocation(latlng:LatLng,radius:number,callback:function(StreetViewPanoramaData,StreetViewStatus):void))

None

在指定 LatLng 的指定半径中检索全景图的StreetViewPanoramaDataStreetViewPanoramaData 将传递至所提供的回调。如果半径小于 50 米,则传回最近的全景图。

StreetViewStatus

完成街景视图请求时由 StreetViewService 传回的状态。

常数

常数

说明

OK

请求已成功。

UNKNOWN_ERROR

无法成功处理请求,但确切的失败原因是未知的。

ZERO_RESULTS

没有附近的全景图。

MapsEventListener对象规范

此类是不透明的。它没有方法和构造函数。此类的实例从 addListener()addDomListener()返回,并最终传递回 removeListener()

事件命名空间

静态方法

静态方法

返回值

说明

addDomListener(instance:Object,eventName:string, handler:Function)

MapsEventListener

跨浏览器注册事件处理程序。通过调用该函数所返回句柄的 eventRemoveListener(handle) 删除此侦听器。

addDomListenerOnce(instance:Object,eventName:string, handler:Function)

MapsEventListener

将在第一个事件之后删除侦听器的 addDomListener 周围的包装。

addListener(instance:Object,eventName:string, handler:Function)

MapsEventListener

将指定侦听器函数添加到指定对象实例的指定事件名称。传回该侦听器的标识符,该标识符能够与 eventRemoveListener() 配合使用。

addListenerOnce(instance:Object,eventName:string, handler:Function)

MapsEventListener

类似于 eventAddListener,但处理程序会在处理完第一个事件后将自已删除。

clearInstanceListeners(instance:Object)

None

对于指定实例,删除其所有事件的所有侦听器。

clearListeners(instance:Object,eventName:string)

None

对于指定实例,删除其指定事件的所有侦听器。

removeListener(listener:MapsEventListener)

None

删除应由上述 eventAddListener 传回的指定侦听器。

trigger(instance:Object, eventName:string,var_args:*)

None

触发指定事件。eventName 后的所有参数都以参数的形式传递到侦听器。

MouseEvent对象规范

此对象由地图和叠加层上的各种鼠标事件返回,包含如下所示的所有字段。

属性

属性

类型

说明

latLng

LatLng

发生事件时在光标下方显示的纬度/经度。

LatLng

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

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

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

构造函数

构造函数

说明

LatLng(lat:number,lng:number, noWrap?:boolean)

请注意纬度和经度的顺序。如果 noWrap 标记为 True,则在传递时会使用这些数字,否则纬度会限定在 -90 度和 +90 度之间,而经度会限定在 -180 度和 + 180 度之间。

方法

方法

返回值

说明

equals(other:LatLng)

boolean

比较函数。

lat()

number

返回纬度值(以度为单位)。

lng()

number

返回经度值(以度为单位)。

toString()

string

转换为字符串表示。

toUrlValue(precision?:number)

string

以“经度, 纬度”形式返回相应 LatLng 的字符串。默认情况下,我们将纬度/经度值四舍五入到小数点后 6 位数。

LatLngBounds

LatLngBounds 实例代表通过地理坐标表示的矩形,包含与 180度子午线相交的矩形。

构造函数

构造函数

说明

LatLngBounds(sw?:LatLng, ne?:LatLng)

基于矩形的西南角和东北角处的点构造矩形。

方法

方法

返回值

说明

contains(latLng:LatLng)

boolean

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

equals(other:LatLngBounds)

boolean

如果此范围与指定范围大致相等,则传回 true。

extend(point:LatLng)

LatLngBounds

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

getCenter()

LatLng

计算该 LatLngBounds 的中心。

getNorthEast()

LatLng

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

getSouthWest()

LatLng

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

intersects(other:LatLngBounds)

boolean

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

isEmpty()

boolean

当范围为空时传回。

toSpan()

LatLng

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

toString()

string

转换为字符串。

toUrlValue(precision?:number)

string

以“lat_lo,lng_lo,lat_hi,lng_hi”形式返回该范围的字符串,其中“lo”表示边界框的西南角,而“hi”表示边界框的东北角。

union(other:LatLngBounds)

LatLngBounds

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

Point

构造函数

构造函数

说明

Point(x:number, y:number)

二维平面上的点。

方法

方法

返回值

说明

equals(other:Point)

boolean

比较两个点

toString()

string

传回该点的字符串表示。

属性

属性

类型

说明

x

number

X 坐标

y

number

Y 坐标

Size

构造函数

构造函数

说明

Size(width:number, height:number, widthUnit?:string,heightUnit?:string)

二维大小,其中宽度是指 x 轴上的距离,高度是指 y 轴上的距离。

方法

方法

返回值

说明

equals(other:Size)

boolean

比较两个大小。

toString()

string

传回该大小的字符串表示。

属性

属性

类型

说明

height

number

沿 y 轴的高度(以像素为单位)。

width

number

沿 X 轴的宽度(以像素为单位)。

MVCObject

构造函数

构造函数

说明

MVCObject()

实现 KVO 的基类。

方法

方法

返回值

说明

bindTo(key:string, target:MVCObject,targetKey?:string, noNotify?:boolean)

None

将视图绑定到模型。

changed(key:string)

None

针对状态更改的常规处理程序。在派生类中覆盖此项,以处理任意状态更改。

get(key:string)

*

获取值。

notify(key:string)

None

通知所有观察者此属性有所改变。这会通知绑定到对象属性的对象以及绑定到的对象。

set(key:string, value:*)

None

设置值。

setValues(values:Object|undefined)

None

设置键值对集合。

unbind(key:string)

None

删除绑定。取消绑定会将未绑定属性设置为当前值。将不会通知该对象,因为值尚未更改。

unbindAll()

None

删除所有绑定。

MVCArray

此类扩展了 MVCObject

构造函数

构造函数

说明

MVCArray(array?:Array)

一个易变的 MVC 数组。

方法

方法

返回值

说明

forEach(callback:function(*, number)))

None

循环访问每个元素,调用所提供的回调。为每个元素调用回调,如:回调 (element, index)。

getAt(i:number)

*

获取指定索引处的元素。

getLength()

number

传回此数组中的元素数。

insertAt(i:number, elem:*)

None

在指定索引处插入元素。

pop()

*

删除数组的最后一个元素并传回该元素。

push(elem:*)

number

将一个元素添加到数组末尾并传回数组的新长度。

removeAt(i:number)

*

从指定索引处删除元素。

setAt(i:number, elem:*)

None

设置指定索引处的元素。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值