Google_Maps_API_V3 帮助文档

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 值： - circ 或 circle：coord 是 [x1,y1,r]，其中 x1,y2 是圆心的坐标，而 r 是圆的半径。 - poly 或 polygon：coord 是 [x1,y1,x2,y2...xn,yn]，其中每个 x,y 对包含多边形的一个顶点的坐标。 - rect 或 rectangle：coord 是 [x1,y1,x2,y2]，其中 x1,y1 是矩形的左上角的坐标，而 x2,y2 是矩形的右下角的坐标。
type	string	描述形状的类型，并且可以是 circle、poly 或 rectangle。

Polyline
类

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

构造函数	说明
Polyline(opts?:PolylineOptions)	使用传递的 Polyline options 创建折线，这些选项可以指定折线的路径以及绘制折线时要使用的笔触样式。您可以在构造折线时传递 LatLng 数组或 LatLng 的 MVCArray，但在实例化时，简单的数组会在折线中转换为 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 数组或者 LatLng 的 MVCArray 指定此路径。请注意，如果您传递简单的数组，则它会转换为 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 数组或 LatLng 的 MVCArray。实例化时，数组会在多边形中转换为 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 数组，其中每一个都包含自己所含路程和路段的相关信息。除非创建 DirectionsRequest时 provideRouteAlternatives 设置为 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)	使用指定选项创建带有样式的 MapType。StyledMapType 会获取一个 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
服务器上的 KML、KMZ
或 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 的全景图或全景图 ID。StreetViewPanorama 对象提供街景视图“查看器”，该查看器可以独立位于单独的 <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 的指定半径中检索全景图的StreetViewPanoramaData。StreetViewPanoramaData 将传递至所提供的回调。如果半径小于 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	设置指定索引处的元素。