googleMapsAPIV3_中文参考手册

2021年2月19日发(作者：摄氏度英语)

google Maps JavaScript API V3

参考

注意：以下网页中提到的

Google Maps JavaScript API

第

3

版现在是正式的

JavaScript API

版本。

该

API

的第

2

版已根据我们的弃用政策正 式弃用。欢迎您将代码移植到这个功能更强、最近更新的

版本中！

最新版本

最后更新时间：

2011

年

6

月

8

日，星期三

欢迎使用

JavaScript Maps API V3

参考。此参考将经常更新，与

API

的最新更改保持同步。有关每

个版本的新增功能的信息，请参考

JavaScript Maps API V3

更改日志

。

参考目录

地图

：

?

?

?

控件

：

?

?

?

?

?

?

?

?

?

?

?

MapTypeControlOptions

MapTypeControlStyle

OverviewMapControlOptions

PanControlOptions

RotateControlOptions

ScaleControlOptions

ScaleControlStyle

StreetViewControlOptions

ZoomControlOptions

ZoomControlStyle

ControlPosition

叠加层

：

?

?

?

?

?

?

?

?

?

?

?

?

?

?

Marker

MarkerOptions

MarkerImage

MarkerShape

Animation

InfoWindow

InfoWindowOptions

Polyline

PolylineOptions

Polygon

PolygonOptions

Rectangle

RectangleOptions

Circle

Map

MapOptions

MapTypeId

?

?

?

?

?

?

服务

：

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

CircleOptions

GroundOverlay

GroundOverlayOptions

OverlayView

MapPanes

MapCanvasProjection

Geocoder

GeocoderRequest

GeocoderStatus

GeocoderResult

GeocoderAddressComponent

GeocoderGeometry

GeocoderLocationType

DirectionsRenderer

DirectionsRendererOptions

DirectionsService

DirectionsRequest

TravelMode

UnitSystem

DirectionsWaypoint

DirectionsStatus

DirectionsResult

DirectionsRoute

DirectionsLeg

DirectionsStep

Distance

Duration

ElevationService

LocationElevationRequest

PathElevationRequest

ElevationResult

ElevationStatus

MaxZoomService

MaxZoomResult

MaxZoomStatus

DistanceMatrixService

DistanceMatrixRequest

DistanceMatrixResponse

DistanceMatrixResponseRow

DistanceMatrixResponseElement

DistanceMatrixStatus

DistanceMatrixElementStatus

地图类型

：

?

?

?

?

?

?

?

?

MapType

MapTypeRegistry

Projection

ImageMapType

ImageMapTypeOptions

StyledMapType

StyledMapTypeOptions

MapTypeStyle

?

?

?

图层

：

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

?

MapTypeStyleFeatureType

MapTypeStyleElementType

MapTypeStyler

BicyclingLayer

FusionTablesLayer

FusionTablesLayerOptions

FusionTablesQuery

FusionTablesStyle

FusionTablesHeatmap

FusionTablesMarkerOptions

FusionTablesPolygonOptions

FusionTablesPolylineOptions

FusionTablesMouseEvent

FusionTablesCell

KmlLayer

KmlLayerOptions

KmlLayerMetadata

KmlMouseEvent

KmlFeatureData

KmlAuthor

TrafficLayer

Street View

：

?

?

?

?

?

?

?

?

?

?

事件

：

?

?

?

StreetViewPanorama

StreetViewPanoramaOptions

StreetViewAddressControlOptions

StreetViewLink

StreetViewPov

StreetViewPanoramaData

StreetViewLocation

StreetViewTileData

StreetViewService

StreetViewStatus

MapsEventListener

事件

MouseEvent

基本信息

：

?

?

?

?

MVC

：

?

LatLng

LatLngBounds

Point

Size

MVCObject

?

MVCArray

几何图形库

：

?

?

encoding

spherical

AdSense

库

：

?

?

?

AdUnit

AdUnitOptions

AdFormat

Panoramio

库

：

?

?

?

?

PanoramioLayer

PanoramioLayerOptions

PanoramioFeature

PanoramioMouseEvent

地方库

：

?

?

?

?

?

?

?

?

Autocomplete

AutocompleteOptions

PlaceDetailsRequest

PlaceGeometry

PlaceResult

PlaceSearchRequest

PlacesService

PlacesServiceStatus

类

此类扩 展了

MVCObject

。

构造函数

构造函数

Map(mapDiv:Node,

opts?:

< p>
MapOptions

)

说明

在指定的

HTML

容器中创建新的 地图，该容器通常是一

个

DIV

元素。

方法

方法

fitBounds(boun ds:

LatLngBounds

)

返回值

None

说明

用于设置视口，使其包含

指定边界。

用于返回当前视口的纬度

/

经度范围。 如果尚未启动

地图（即

mapType

仍为

Null

），或尚未设置中心和

缩放，则结果为

null

或

getBounds()

LatLngBounds

getCenter()

getDiv()

getHeading()

getMapTypeId()

getProjection()

getStreetView()

getTilt()

getZoom()

panBy(x:number, y:number)

panTo(latLng:

LatLng

)

panToBounds(latLngBounds:< /p>

LatLngBounds

)

undef ined

。

LatLng

Node

用于返回航拍图像的罗盘

number

方向。方向值按顺时针方

向计算（以度为单位），

基本方向为北方。

MapTypeId

传回当前的

Projection

。如果还未

启动地图 （即

mapType

仍

Proje ction

为

Null

），则结果为

Null

。侦听

projection_changed

并检查它的值以确保它的

值不为

Null

。

将默认

< br>StreetViewPanorama

范围传回到地图，该范围

可能是嵌入在地图中的默

StreetViewPanorama

认全景图，也可能是使用

setStreetView()

< br>设置

的全景图。对地图的

streetViewCont rol

所

做的更改将反映在此类范

围全 景图的显示中。

用于返回从视口平面到地

图平面的航拍图像（支持

SATELLITE

和

< p>
HYBRID

number

地图类型）的入射角，以

度为单位进行测量。值

0

表明没有入射角（没有倾

斜），而

45°

图像将会返

回值

45

。

number

将地图中心移动一段指定

的距离（以像素为单

位）。如果这 段距离既小

于地图的宽度，又小于地

None

< br>

图的高度，那么移动的动

画效果将会十分流畅。请

注意，地图坐标系的

x

值

从西向东增加，

y

值从北向

南增加。

< br>将地图中心更改为指定的

LatLng

。如果更改幅度既

None

小于地图的宽度，又小于< /p>

地图的高度，那么移动的

动画效果将会十分流畅。

将地图平移所需的最小距

离以包含指定的

< p>
None

LatLngBounds

< p>
。范围在

地图上的位置并不确定，

除了尽可能多地 显示范

围。范围将定位于由地图

类型和导航（平移、缩放

和

Street View

）控件所限

定的区域内（如果这些控< /p>

件出现在地图上的话）。

如果范围大于地图，则地

图会移动，以便包括范围

的西北角。如果地图位置

的移 动幅度既小于地图的

宽度，又小于地图的高

度，那么移动的动画 效果

将会十分流畅。

setCent er(latlng:

LatLng

)

setHeading(heading:number)

< /p>

setMapTypeId(mapTypeId:

MapTyp eId

)

setOptions(o ptions:

MapOptions

)

None

None

None

None

用于设置航拍图像的罗盘

方向（以度为单位进行测

量），基本方 向为北方。

将

StreetViewPanorama

绑定到地图。此 全景图将

覆盖默认

StreetViewPanorama

，

从而使地图可以绑定到地

图外的外部全景 图。将全

景图设置为

null

可将默< /p>

认的嵌入式全景图绑定回

到地图。

用于设置从视口平面到地

图平面的航拍图像（支持

< br>SATELLITE

和

HYBRID

地图类型）的入射角，以

度为单位进行测量。仅支

持两个值 ：

0

（表明没有入

射角，即没有倾斜） 和

45

（表明有

45°

倾斜）。

setStreetView(panorama:

StreetViewPanorama

)

None

setTilt(tilt:number)

None

setZoom(zoom:number)

None

属性

属性

说明

附加到地图的其他控件。要在地 图中添加控

件，请将控件的

添加到与应渲染它的

controls

Array.<

MVCArray

.>

ControlPosition

相对应的< /p>

MVCArray

中。

mapTypes

MapTypeR egistry

按字符串

ID

划分 的

MapType

实例的注册表。

overlayMapTypes

M VCArray

.<

MapType

>

要叠加的其他地图类型。

类型

事件

事件

bounds_changed

center_changed

click

参数

说明

None

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

None

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

MouseEvent

当用户点击地图（但不是点击标记或信息窗口）时会触发此

事件。

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

dblclick

< br>MouseEvent

会触发点击事件。

drag

None

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

dragend

None

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

dragstart

None

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

heading_changed

None

当地图方向属性更改时会触发此事件。

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

idle

None

件。

maptypeid_changed

None

当

mapTypeId

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

mousemove

MouseEv ent

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

mouseout

MouseEve nt

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

mouseover

MouseEv ent

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

projection_changed

None

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

当

div

更改大小时，开发人员应 在地图上触发此事件：

resize

None

r

(map, 'resize')

。

在地图容器中触发

DOM contextmenu

事件时会触发此事

rightclick

MouseEvent

件。

tilesloaded

None

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

tilt_changed

None

当地图倾斜属性更改时会触发此事件。

zoom_changed

None

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

ions

对象规范

属性

属性

类型

说明

用作地图

div

的背景颜色。当< /p>

用户进行平移时，如果尚未载

入图块，则显示此颜色。仅在

启动地图时，才能设置此选

项。

初始的地图中心。必填。

启用

/

停用所有默认的用户界

面。该属性可以单独 进行重

写。

启用

/

停用在双击时缩放并居

中。默认情况下处于启用状

态。

如果为

Fa lse

，则禁止拖动地

图。默认情况下启用拖动。

要在可拖动对象上显示的光标

的名称或网址。

要在拖动对象时显示的光标的

名称或网址 。

航拍图像的方向值按顺时针方

向计 算（以度为单位），基本

方向为北方。方向会与可以查

看到图像 的距离最近的可用角

度相对齐。

如果为

False

，则禁止通过键< /p>

backgroundColor

string

center

disableDefaultUI

LatLng

boolean

disableDoubleClickZoom

draggable

draggableCursor

draggingCursor

boolean

boolean

string

string

heading

number

keyboardShortcuts

boolean

盘控制地图。默认情 况下启用

键盘快捷键。

地图类型控件 的初始启用

/

停用

mapTypeCo ntrol

boolean

状态。

地图类型控件的初始显示选< /p>

mapTypeControlOptions

MapTypeControlOptions

项。

初始的地图

mapTypeId

。必

mapTypeId

MapTypeId

填。

< p>
将会在地图上显示的最大缩放

级别。如果将该属性省略或设

maxZoom

number

置为

Null

，则系统会改为使用< /p>

当前地图类型的最大缩放级

别。

将会在地图上显示的最小缩放

级别。如果将该属性省略或设

< p>
minZoom

number

置为

Null

，则系统会改为使用< /p>

当前地图类型的最小缩放级

别。

如果为

true

，则不会清除地图

noClear

boolean

div

中的内容。

overviewMapControl

boolean

总览图控件的启用< /p>

/

停用状态。

overviewMapControlOptions

OverviewMapControlOptions

总览图控件 的显示选项。

panControl

boolean

平移控件的启用

/

停用状态。

panControlOptions

PanControlOptions

平移控件的显示选项。

rotateControl

boolean

旋转控件的启用

/

停用状态。

rotateControlOptions

RotateControlOptions

旋转控件的显示选项。

< p>

比例控件的初始启用

/

停用状

scaleControl

boolean

态。

scaleControlOptions

< br>ScaleControlOptions

比例控件的初始显示选项。

< p>

如果为

False

， 则停用通过滚

scrollwheel

boolean

轮缩放地图的功能。 默认情况

下启用滚轮功能。

将街景视 图街景小人置于地图

上时显示的

StreetViewPano rama

。如

streetView

StreetViewPanorama

果未指定全景图，则拖 动街景

小人时，默认

StreetViewPanorama< /p>

将显

示在地图的

div

< br>中。

Street View

街景小人控件的

streetViewControl

boolean

初始启用

< p>
/

停用状态。

Street View

街景小人控件的

streetViewControlOptions

S treetViewControlOptions

初始显示选项。

从视口平面到地图平面地图的

入射角，以度为单位进行测

量。目前仅支持两个值：

0

（表明没有 入射角，即没有倾

tilt

number

斜）和

45

（表明有

45°

倾

斜）。

45°

图像仅支持针对某

些位置和采用某些缩放级别的

SATELLITE

和

HYBRID

< br>地图

类型。

zoom

number

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

zoomControl

zoomControlOptions

boolean

ZoomContr olOptions

缩放控件的启用

/

停用状态。

缩放控件的显示选项。

eId

类

常见

MapTypes

的标识符。

常数

常数

HYBRID

ROADMAP

SATELLITE

TERRAIN

说明

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

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

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

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

eControlOptions

对象规范

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

属性

属性

类型

说明

mapTypeIds

Array. <

MapTypeId

>|Array.

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

ID

。

position

style

ControlPosi tion

MapTypeControlStyle

位置

ID

。用于指定控件在地图上的位

置。默认 位置为

TOP_RIGHT

。

样式

ID

。用于选择要显示的地图类 型控

件的样式。

eControlStyle

类

常见

MapTypesControls

的标识符。

常数

常数

说明

使用默认的地图类型控件。地图 默认使用的控件会因窗口大小和其他因素而有所

DEFAULT

不同。该控件可能在该

API

以后的版本中有所更改。

DROPDOWN_MENU

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

HORIZONTAL_BAR

标准的水平单选按钮栏。

ewMapControlOptions

对象

规范

用于呈现总览图控件的选项。

属性

属性

说明

用于指示控件应以开放模式还是 紧缩（最小化）模式显示。默认情况下，该控件

opened

boolean

处于关闭状态。

类型

trolOptions

对象规范

用于呈现平移控件的选项。

属性

属性

类型

说明

position

ControlPosition

位置

ID

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

TOP_LE FT

。

ControlOptions

对象规范

用于呈现旋转控件的选项。

属性

属性

类型

说明

position

ControlPosition

位置

ID

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

TOP_LE FT

。

ontrolOptions

对象规范

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

属性

属性

说明

位置

ID

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

positi on

ControlPosition

BOTTOM_LEFT

。

style

ScaleContro lStyle

样式

ID

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

类型

ontrolStyle

类

缩放控件

ID

的标识符。

常数

常数

DEFAULT

说明

标准缩放控件。

ViewControlOptions

对象规范

用于在地图上呈现

Street View

街景小人控件的选项。

属性

属性

说明

位置

ID

。用于指定控件在地图上的位置。默认位置已嵌入到导航

（ 缩放和平移）控件中。如果此位置为空或与

position

ControlPosition

zoomControlOp tions

或

panControlOptions

< p>
中指定位置的

相同，则

Street View

控件将会作为导航控件的一部分显示。其他

情况下，该控件会单 独显示。

类型

ntrolOptions

对象规范

用于呈现缩放控件的选项。

属性

属性

说明

位置

ID

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

positi on

ControlPosition

TOP_LEFT

。

style

ZoomControl Style

样式

ID

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

类型

ntrolStyle

类

缩放控件的标识符。

常数

常数

说明

默认的缩放控件。地图默认使用 的控件会因窗口大小和其他因素而有所不同。该控件可能

DEFAULT

在该

API

以后的版本中有所更改。

LARGE

大型控件，除

+/-

按钮以外还带有缩放滑块。

SMALL

小型控件，仅带有缩放按钮。

lPosition

类

< p>
用于指定控件在地图上的位置的标识符。控件相对于同一布局位置中的其他控件而定位。首先添加< /p>

的控件将定位在靠近地图边缘的位置。

+----------------+

+ TL TC TR +

+ LT RT +

+ +

+ LC RC +

+ +

+ LB RB +

+ BL BC BR +

+----------------+

顶部或底部行中的元素将向中间流动。左侧或右侧的元素向下流动。

常数

常数

说明

BOTTOM_CENTER

BOTTOM_LEFT

BOTTOM_RIGHT

LEFT_BOTTOM

LEFT_CENTER

LEFT_TOP

RIGHT_BOTTOM

RIGHT_CENTER

RIGHT_TOP

TOP_CENTER

TOP_LEFT

TOP_RIGHT

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

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

Google

徽标的右侧。

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

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

元素定位在左侧的中间。

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

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

元素定位在右侧的中间。

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

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

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

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

类

此类扩展了

MVCObject

。

构造函数

构造函数

说明

创建带有指定选项的标记。如果 已指定地图，则标记会在构造

Marker(opts?:

Ma rkerOptions

)

完成后立 即添加到该地图。请注意，您必须设置标记的显示位

置。

方法

方法

getAnimation()

getClickable()

getCursor()

getDraggable()

getFlat()

getIcon()

getMap()

getPosition()

getShadow()

getShape()

getTitle()

getVisible()

getZIndex()

返回值

说明

Animation

boolean

string

boolean

boolean

< br>string|

MarkerImage

Map

|

S treetViewPanorama

LatLng

string|

MarkerImage

MarkerShape

string

boolean

number

启动动画。系统将

会取消所有正在播

放的动画。当前支

持的动画类型为：

None

BOUNCE

、

DROP

。 传入

null

将会导致系统停放

全部动 画。

None

None

None

None

setAnimation(animation:

Animation

)

setClickable(flag:boolean)

setCursor(cursor:string)

setDraggable(flag:boolean)

setFlat(flag:boolean)

setIcon(icon:string|

MarkerImage

)

None

setMap(map:

Map

|

StreetViewPanorama

)

None

在指定地图或全景

图上渲染标记。如

果地图设置为

Null

，则会删除此

标 记。

setOptions(options:

MarkerOptio ns

)

None

setPosition( latlng:

LatLng

)

None

setShadow(sh adow:string|

MarkerImage

)

None

setS hape(shape:

MarkerShape

)

< p>

None

setTitle(title:string)

None

setVisible(visible:boolean)

None

setZIndex(zIndex:number)

None

常数

常数

说明

API

分配给标记的最大默认

Z-index

。您可以设置较高的

Z-index

值，以使相关标记显

MAX_ZINDEX

示在前面。

事件

事件

animation_changed

click

clickable_changed

cursor_changed

dblclick

drag

dragend

draggable_changed

dragstart

flat_changed

icon_changed

mousedown

mouseout

mouseover

mouseup

position_changed

rightclick

shadow_changed

shape_changed

title_changed

visible_changed

zindex_changed

参数

None

MouseEvent

None

None

MouseEvent

MouseEvent

MouseEvent

None

MouseEvent

None

None

MouseEvent

MouseEvent

MouseEvent

MouseEvent

None

MouseEvent

None

None

None

None

None

说明

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

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

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

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

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

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

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

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

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

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

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

对标记触发

mousedown

事件时会触发此事件。

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

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

对标记触发

mouseup

事件时会触发此事件。

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

对标记触发

rightclick

事件时会触发此事件。

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

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

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

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

当标记的

zIndex

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

Options

对象规范

属性

属性

animation

说明

将标记添加到地图时所播放的动画。

如果为

true

，则标记会收到鼠标 事件和触摸事件。默

clickable

boolean

认值为

true

。

cursor

string

鼠标悬停时显示的光标。

draggable

boolean

如果为

true

，则可拖动标记。默认值为

false

。

flat

boolean

如果为

true

，则不会显示标记阴影。

icon

string|

< p>
MarkerImage

前景的图标

map

Map

|

StreetViewPanorama

要在其上显示标记的地图。

用于将多 个标记呈现为单个静态元素的优化。系统会

optimized

boolean

默认启用优化呈现。应针对动态

GIF/PNG

或在必须

将每个标记呈现为单独

DOM

元素时停用优化呈现。

position

LatLng

标记位置。必填。

如果为

false

，则停用拖动标记 时的升降效果。默认情

raiseOnDrag

boolean

况下，该选项为

true

。

shadow

string|

MarkerImage

阴影图像

shape

MarkerShape

用于拖动

/

点击的图像地图区域定义。

title

string

滚动文本

visible

boolean

如果为

true

，则显示标记。

所有标记均按其

zIndex

的顺 序在地图上显示，值较大

的标记会显示在值较小的标记之前。默认情况下，标

< p>
zIndex

number

记会按照它们在屏幕上 的垂直位置来显示，位置较低

的标记会显示在位置较高的标记之前。

类型

Animation

Image

类

构造函数

构造函数

MarkerImage(url:string, size?:

Size

, origin?:

Point

,

anchor?:

Point

, scaledSize?:

Size

)

说明

表示标记图标或阴影

图片的结构。

属性

属性

说明

地图上与标记位置相对应的图片 锚定位置。默认情况下，锚点会放置在图片

anchor

Point

底部的中心点附近。

图片在拼合图片中的位置（如果有的话）。默认情况下，原点位于图片

(0,

origin

Point

0)

的左上角。

进行缩放后的整幅图片的尺寸（如果有的话）。可使用此属性伸展

/

收缩图片

scaledSize

Size

或拼合图片。

拼合图片或图片的显示尺寸。使用拼合图片时必须指定其尺寸。如果未提供

s ize

Size

尺寸，则系统会在加 载图片时进行设置。

url

string

图片或拼合图片的网址。

类型

Shape

对象规范

此对象定义用于确定标记的 可点击区域的标记形状。该形状包括两个属性（

type

和

coord

），这

两个属性定义该类型的标 记特有的常规类型的标记和坐标。

属性

属性

说明

此属性的格式取决于

< p>
type

的值，并且遵循

/TR/REC- html40/struct/#adef- coords

上

的

w3 AREA

coords

规范。

coords

属性是一个整数数组，指定了形状相对于目标图片左上角的像

素位置。坐标取决于

type

的值，具体如 下：

coords

Array.

-

circle

：坐标为

[x1,y 1,r]

，其中

x1,y2

为圆心坐标，而

r

为圆的

半径。

-

poly

：坐标为

< p>
[x1,y1,x2,y2...xn,yn]

，其中每个

x,y

对分别包

含了多边形的其中一个顶点的坐标 。

-

rect

：坐标为

[x1,y1,x2,y2]

，其中

x1,y1

是矩形左上角的坐标，

而

x2,y2

是矩形右下角的坐标。

type

string

用于描述形状的类型， 可能的值为

circle

、

poly< /p>

或

rect

。

类型

ion

类

可以在标记上播放的动画。在标记 上使用

setAnimation

方法或使用

< br>animation

选项来播放动

画。

< br>

常数

常数

BOUNCE

DROP

说明

在动画停止播放前，标记会不断地弹跳。

标记会从地图顶部掉落下来，然后稍微弹跳几下。

ndow

类

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

MVCObject< /p>

。

构造函数

构造函数

说明

创建带有指定选项的信息窗口。 信息窗口可以放置

在地图的特定位置，也可以位于标记上方，具体取

决于选项中指定的内容。除非停用自动平移，否

则，信息窗口会在打开后平移地图， 以便让自己显

InfoWindow(opts?:

InfoW indowOptions

)

示出来。信息窗口构建完成后，您需要调用

open

函数，才能在地图上显示该窗口。用户可以点击信

息窗口上的关闭按钮 将其从地图中关闭，开发人员

也可以调用

close()

函数实现同样的效果。

方法

方法

close()

getContent()

getPosition()

返回值

说明

关闭此信息窗口，方法是将其从

None

DOM

结构中删除。

string|Node

LatLng

getZIndex()

number

open(map?:

Map

|

StreetViewPan orama

,

anchor?:

MV CObject

)

None

在指定的地图上打开这个信息窗

口。信息窗口可以与锚点相关

联 ，但这属于可选操作。在核心

API

中，唯一的锚点是

Marker

类 。不过，锚点可以是用于展示

位置属性的任意

MVCObje ct

，

也可以是用于计算

pixelOffset

时

的可选

anchorPoint

（请参见

I nfoWindowOptions

）。

anchorPoin t

是从锚点位置到信

息窗口顶端的偏移量。

< br>

setContent(content:string|N ode)

None

setOptions(options:

InfoWindowOption s

)

None

setPosition( position:

LatLng

)

None

setZIndex(zIndex:number)

None

事件

事件

参数

说明

closeclick

None

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

content_changed

None

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

当包 含

InfoWindow

的内容的

附加到

DOM

时，会触发此事

domready

None

件。如果您要动态构建信息窗口内容，则可能希望监视此事件。

position_changed

None

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

zindex_changed

None

信息窗口的

zIndex

更改时会触发此事件。

ndowOptions

对象规范

属性

属性

说明

要在信息窗口中显示的内容。该内容可以是

HTML

元素、纯文本

字符串或包含

HTML

的字符串。信息窗口将会根据相应内容调整

content

string|Node

大小。要设置内容的具体大小，请将内容设置为相应大小的

HTML

元素。

< br>停用在打开时自动平移的功能。默认情况下，信息窗口会在打开

disableA utoPan

boolean

后平移地图，以便让自己完全显示出来。

信息窗口的最大宽度（不考虑内容的宽度）。仅在已调用

open

函数前设置了该值时，才考虑使用这个值。在更改内容时，如果

maxWidth

number

要更改最大宽度，请调用

close

函数、

setOptions

函数，然后调

用

open

函数。

信息窗口的箭头距离信息窗口 在地图上所锚定地理坐标点的偏移

pixelOffset

< /p>

Size

量（以像素为单位）。如果信息窗口是通过锚点打开的， 则从锚

点范围的顶部中心开始计算

pixelOffset

。

用于显示此信息窗口的

LatLng

。如果信息窗口是通过锚点打开

position

LatLng

的，则使用锚点的位置。

所有信息窗口按

zIndex

值的大小顺序在地图上显示，

zIndex

< br>值

较大的信息窗口显示在值较小的信息窗口之前。默认情况下，信

zIndex

number

息窗口是按纬度显示的，纬度较低的信息窗口显示在纬度较高的

信息窗口前。信息窗口始终在标记前面显示。

类型

ne

类

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

MVCObject

。

构造函数

构造函数

说明

使用传递的

PolylineOptions

创建折线，这些选项可

以 指定折线的路径以及绘制折线时要使用的笔触样式。

Polyline(opts?:< /p>

PolylineOptions

)

< /p>

您可以在构造折线时传递

LatLng

数 组或

LatLng

的

MVCArray

，但在实例化时，简单的数组会在折线中转换

为

MVCArray

。

方法

方法

说明

传回已附加此折线或多边形

getMap()

Map

的地图。

getPath()

MVCArra y

.<

LatLng

>

检索第一条路径。

在指定 地图上渲染此折线或

多边形。如果地图设置为

setMap(map:

Map

)

None

Null

< p>
，则会删除此折线或多

边形。

< br>setOptions(options:

PolylineOptions

)

None

设置第一条路径。有关详细

setPath(path:

MVCArray

.<

LatLng

>|

None

信息，请参见

Array.<

LatLng

>)

PolylineOptions

。

返回值

事件

事件

click

dblclick

mousedown

mousemove

mouseout

mouseover

mouseup

rightclick

参数

MouseEvent

MouseEvent

MouseEvent

M ouseEvent

MouseEvent

MouseEven t

MouseEvent

MouseEvent

说明

对折线触发

DOM click

事件时会触发此事件。

对折线触发

DOM dblclick

事件时会触发此事件。

对折线触发

DOM mousedown

事件时会触发此事件。

对折线触发

DOM mousemove

事件时会触发此事件。

此事件针对折线

mouseout

触发。

此事件针对折线

mouseover

触发。

对折线触发

DOM mouseup

事件时会触发此事件。

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

neOptions

对象规范

属性

属性

clickable

geodesic

类型

boolean

boolean

说明

指示此

Polyline

是否处理

click

事件。默认值为

true

。

将每条边渲染为测地线（

“

大圆

”

的一段）。测地线是沿地

球表面的两点之间的最短路 径。

map

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

折线坐标 的有序序列。可以使用一个简单的

LatLng

数

组或者

LatLng

的

MV CArray

指定此路径。请注意，如

MVCArray

.<

LatLng

>|

path

果您传递简单的数组，则它 会转换为

MVCArray

。在

Arr ay.<

LatLng

>

MVCArray

中插入或删除

LatLng

将自动更新地图上的折

线。

笔触颜色。支持所有

CSS3

颜色 ，扩展命名的颜色除

strokeColor

string

外。

strokeOpacity

number

介于

0.0

和

1.0

之间的笔触不透明度

strokeWeight

number

笔触宽度（以像素为单位）。

zIndex

number

相对于其他折线的

zIndex

。

Map

n

类

多边形（类似于折线）可在一个有序序列中定义一系列连接坐标；此外，多边形会形成一 个闭合环

并定义一个填充区域。此类扩展了

MVCObject

。

构造函数

构造函数

说明

使用传递的

PolygonOptions

创建多边形，这些选项可以

指定多边形的路径、多边形边缘的笔触样式，以及多边形内

部区域的填充样式。一个多边 形可以包含一条或多条路径，

Polygon(opts?:

P olygonOptions

)

其中 每条路径由一个

LatLng

数组组成。您可以在构造这些

路径时传递一个

LatLng

数组或< /p>

LatLng

的

MVCArray

。实

例化时，数组会在多边形中转换为

MVC Array

。

方法

方法

说明

传回已附加此折线或多

getMap()

Map

边形的地图。

getPath()

MVCArra y

.<

LatLng

>

检索第一条路径。

getPaths()

MVCArr ay

.<

MVCArray

.<

LatLng

>>

检索此多边形的路径。

在指定地图上 渲染此折

线或多边形。如果地图

setMap(map:

Map

)

None

设置为

Null

，则会删除

此折线或多边形。

setOptions(options:

PolygonOp tions

)

None

设置第一条路径。有关

setPath(path:

MVCArray

.<

LatLng

>|

None

详细信息，请参见

Array.<

LatLng

>)

PolylineOptions

。

setPaths(paths:

< br>MVCArray

.<

MVCArray

.<

LatLng

>>|

MVCArray

.<

LatLng< /p>

>|

None

设置此多边形的路径。

Array.

LatLng

>>|

Array.<

LatLng

>)

返回值

事件

事件

参数

说明

click

dblclick

mousedown

mousemove

mouseout

mouseover

mouseup

rightclick

MouseE vent

MouseEvent

MouseEvent

MouseEvent

MouseEvent

M ouseEvent

MouseEvent

MouseEven t

对多边形触发

DOM click

事件时会触发此事件。

对多边形触发

DOM dblclick

事件时会触发此事件。

对多边形触发

DOM mousedown

事件时会触发此事件。

对多边形触发

DOM mousemove

事件时会触发此事件。

此事件针对多边形

mouseout

触发。

此事件针对多边形

mouseover

触发。

对多边形触发

DOM mouseup

事件时会触发此事件。

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

nOptions

对象规范

属性

属性

说明

指示此

Polygon

是否处理

click

事

clickable

boolean

件。默认值为

true

。

填充色。支持所有

CSS3

颜色，扩展命名

fillColor

string

的颜色除外。

fillOpacity

number

介于

0.0

和

1.0

之间的填充不透明度

将每条边渲染为 测地线（

“

大圆

”

的一

geodesic

boolean

段）。测地线是沿地 球表面的两点之间的

最短路径。

map

Map

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

用于指定闭合环的坐标的有序序列。不同

于折线，一个多边形由 一条或多条路径组

成。因此，路径属性可以指定一个或多个

MV CArray

.<

MVCArray

. <

LatLng

>>|

LatLng

坐标数组。可以使用一个

MVCArray

.<

LatLng

>|

paths

LatLng

< p>
数组定义简单的多边形。多个复

Array.< p>
LatLng

>>|

杂的多边形可以指定一系列 数组。任何简

Array.<

LatLng

>

单数组都可以转换为

MVCA rray

。在

MVCArray

中插入 或删除

LatLng

将自

动更新地图上 的多边形。

笔触颜色。支持所有

CSS3

颜色，扩展命

strokeColor

string

名的颜色除外。

strokeOpacity

number

介于

0.0

和

1.0

之间的笔触不透明度

strokeWeight

number

笔触宽度（以像素为单位）。

zIndex

number

相对于其他折线的

zIndex

。

类型

gle

类

矩形叠加层。此类扩展了

MVCObject

。

构造函数

构造函数

说明

使用传递的

RectangleOptions

（它指定范围和样

Re ctangle(opts?:

RectangleOptions

)

式）创建矩形。

方法

方法

getBounds()

getMap()

setBound s(bounds:

LatLngBounds

)

返回值

说明

LatLngBounds

传回此矩形的范围。

Map

传回显示此矩形的地图。

None

设置此矩形的范围。

在指定地图上渲 染此矩形。如果

setMap(map:

Map

)

None

地图设置为

Null

，则会删除此矩

形。

setOptions(options:

RectangleOpt ions

)

None

事件

事件

click

dblclick

mousedown

mousemove

mouseout

mouseover

mouseup

rightclick

参数

MouseEvent

MouseEvent

MouseEvent

M ouseEvent

MouseEvent

MouseEven t

MouseEvent

MouseEvent

说明

对矩形触发

DOM click

事件时会触发此事件。

对矩形触发

DOM dblclick

事件时会触发此事件。

对矩形触发

DOM mousedown

事件时会触发此事件。

对矩形触发

DOM mousemove

事件时会触发此事件。

此事件针对矩形

mouseout

触发。

此事件针对矩形

mouseover

触发。

对矩形触发

DOM mouseup

事件时会触发此事件。

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

gleOptions

对象规范

属性

属性

类型

bounds

LatLngBoun ds

clickable

boolean

fillColor

string

fillOpacity

number

map

Map

strokeColor

string

strokeOpacity

number

strokeWeight

number

zIndex

number

说明

范围。

指示此

Rectangle

是否处理< /p>

click

事件。默认值为

true

。

填充色。支持所有

CSS3

颜色，扩展命名的颜色除外。

介于

0.0

和

1.0

之间的填充不透明度

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

笔触颜色。支持所有

CSS3

颜色，扩展命名的颜色除外。

介于

0.0

和

1.0

之间的笔触不透明度

笔触宽度（以像素为单位）。

相对于其他折线的

zIndex

。

类

地球表面的圆；也称为

< p>
“

球冠

”

。此类扩展了< /p>

MVCObject

。

构造函数

构造函数

说明

使用传递的

CircleOptions

（它指定中心、半径和样式）创

Circle(opts?:

CircleOptions

)

建圆。

方法

方法

getBounds()

getCenter()

getMap()

getRadius()

setCe nter(center:

LatLng

)

返回值

说明

LatLngBounds

获取此圆的

LatLngBounds

。< /p>

LatLng

传回此圆的中心。

Map

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

number

传回此圆的半径（以米为单位）。

None

设置此圆的中心。

在指定地图上渲染 此圆。如果地图设

setMap(map:

Map

)

None

置为

Null

，则会删除此圆。

setO ptions(options:

CircleOptions

)

None

setRadius(radius:number)

None

设置此圆的半径（以米为单位）。

事件

事件

click

dblclick

mousedown

mousemove

mouseout

mouseover

mouseup

rightclick

参数

MouseEvent

MouseEvent

MouseEvent

M ouseEvent

MouseEvent

MouseEven t

MouseEvent

MouseEvent

说明

对圆触发

DOM click

事件时会触发此事件。

对圆触发

DOM dblclick

事件时会触发此事件。

对圆触发

DOM mousedown

事件时会触发此事件。

对圆触发

DOM mousemove

事件时会触发此事件。

此事件针对圆

mouseout

触发。

此事件针对圆

mouseover

触发。

对圆触发

DOM mouseup

事件时会触发此事件。

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

Options

对象规范

属性

属性

center

clickable

fillColor

fillOpacity

map

radius

strokeColor

strokeOpacity

strokeWeight

zIndex

类型

LatLng

boolean

string

number

Map

number

string

number

number

number

说明

中心

指示此

Circle

是否处理

click

事件。默认值为

true

< p>
。

填充色。支持所有

CSS3

颜色，扩展命名的颜色除外。

介于

0.0

和

1.0

之间的填充不透明度

要在其上显示圆的地图。

地球表面的半径（以米为单位）。

笔触颜色。支持所有

CSS3

颜色，扩展命名的颜色除外。

介于

0.0

和

1.0

之间的笔触不透明度

笔触宽度（以像素为单位）。

相对于其他折线的

zIndex

。

Overlay

类

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

MVCObject

。

构造函数

构造函数

GroundOverlay(url:string,

bo unds:

LatLngBounds

,

说明

根据提供的图像网址及其

LatLngBounds

创

建地面叠加层。 图像会进行缩放以适应当前的

opts?:

GroundOve rlayOptions

)

范围，并使用当前的地图投影进行投影。

方法

方法

getBounds()

getMap()

getUrl()

返回值

说明

LatLngBounds

获取此叠加层的

LatLngBounds

。

M ap

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

string

获取投影图象的网址。

在指定地图上渲染此地面叠加层。如果地图设置为

Null< /p>

，则会

setMap(map:

Map< /p>

)

None

删除此叠加层。

事件

事件

参数

click

MouseEvent

说明

对

GroundOverlay

触发

< p>
DOM click

事件时会触发此事件。

OverlayOptions

对象规范

此对象定义可在

< p>
GroundOverlay

对象上设置的属性。

属性

属性

clickable

map

类型

boolean

Map

说明

如果为

true

，则地面叠加层可以收到

click

事件。

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

yView

类

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

MVC Object

。

构造函数

构造函数

说明

您应当继承此类，方法是将叠加层的

prototype

设置为

new

ype

。必须实现三个方法，即

onAdd()

、

draw()

和

onRemove()

。在

add()

方法中，您应当创建

DOM

< br>对象，并将其作为窗格的子对

象附加。在

draw()

方法中，应放置这些元素。在

onRemove()

方法中，应将对象

OverlayView()

从

DOM

中删除。您必须调用包含有效地图对象的

setMap()

，以触发对

onAdd()

方法和

setMap(null)

的调用，这样才能触发

onRemove()

方法。可以在构建叠加

层时调用

setMap()

方法，也可以在需要重新显示已删除叠加层的任何时候调用该

方法。每当地图属性更改时都会调用

draw()

方法，该方法可以更改元素的位置，

如缩放、中心或地图类型。

方法

方法

draw()

返回值

None

说明

实现此方法可绘制或更新叠加< /p>

层。在实现

onAdd()

以后，并

且

tLngToPixel()

的位置返回指定

LatLng

的新 值

时，调用此方法。缩放、中心

或地图类型发生更改时将会调< /p>

用此方法。拖动或重新设定大

小时无需调用该方法。

getMap()

返回可在其中显示此

getPanes()

MapPanes

OverlayView

的窗格。仅在调

用

draw

函数后才可用。

用于返回与该

OverlayView

相关联的

getPr ojection()

MapCanvasProjecti on

MapCanvasProjection

对

象。仅在调用

draw

函数后才

可用。

实现此方法可初始化叠加层

DOM

元素。对有效地图调用

onAdd()

None

setMap()

之后，调用该方法一

次。此时将会初始化窗格和投

影。

实现此方法可将您的元素从

onRemove()

None

DOM

删除。调用

setMap(null)

之后立即调用此方法。

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

setMap(map:

Map

< br>|

StreetViewPanorama

)

< p>

None

图。

Map

es

对象规范

此对象包含渲染叠加层的

DOM

元 素。下面列出了这些元素，底部为

“

窗格

0”

，顶部为

“

< br>窗格

6”

。

属性

属性

floatPane

类型

说明

Node

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

6

）。

此窗格包含信息窗口阴影。该窗格在

overlayImage

之上，这样标记

floatSha dow

Node

便可位于信息窗口的阴影中。（窗格

4

）。

此窗格是最下面的窗格，位于图块之上。可能无法接收

DOM

事件

mapPane

Node

（窗格

0

）。

overlayImage

Node

此窗格包含标记前景图像。（窗格

3

）。

此窗格包含折线、多边形、地 面叠加层和图块图层叠加层。可能无法

overlayLayer

Node

接收

DOM

事件（窗格

1

）。

此窗格包含可接收

DOM

鼠标事件 的元素，例如标记的透明目标。该

overlayMouseTarget

Node

窗格在

floatShadow

之 上，这样便可点击信息窗口阴影中的标记。

（窗格

5

）。

overlayShadow

Node

此窗格包含标记阴影。可能无法接收

DOM

事件（窗格

2

）。

vasProjection

对象规范

此对象会从绘制方法内向< /p>

OverlayView

提供。在调用绘制之前，系统无法保证对 其进行初始化。

方法

方法

返回值

说明

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

fromContainerPixelToLatLng(pixel:

< p>
Point

)

LatLng

理坐标。

根据存放可拖动地图的

div

中的 像

fromDivPixelToLatLng(pixel:

Point

)

LatLng

素坐标计算地理坐标。

计算地图外部容器的

DOM

元素中

fromLatLngToContainerPixel(latLng:

< p>
LatLng

)

Point

指定地理位置的像素坐标。

计算存放可拖动地图的

DOM

元素

fromLatLngToDivPixel(latLng:

LatLng

)

Point

中指定地理位置的像素坐标。

当前缩放级别下 世界地图的宽度

getWorldWidth()

number

（以像素为单位）。

er

类

用于在地址和

LatLng

之间进行转换的服务。

构造函数

构造函数

Geocoder()

说明

创建可将地址解析请求发送到

Google

服务器的新

Geocoder

实例。

< br>

方法

返回

说明

值

对请求内容

geocode(request:

GeocoderRequest

,

None

进行地址解< /p>

callback:function(Array.<

Geoc oderResult

>,

GeocoderStatus

))

析。

方法

erRequest

对象规范

要发送到

Geocoder

的地址解析请求 的规范。

属性

属性

address

bounds

location

region

类型

string

LatLngBoun ds

LatLng

string

说明

地址。可选。

要在其中进行搜索的

LatLngBounds

。可选。

要搜索的

LatLng

。可选。

要在其中进行 搜索的国家

/

地区代码的顶级域名。可选。

erStatus

类

完成对

geocode()

的调用时由

Geocoder

传回的状态。

常数

常数

说明

ERROR

连接

Google

服务器时出错。

INVALID_REQUEST

G eocoderRequest

无效。

OK

响应包含有效的

GeocoderResponse

。

OVER_QUERY_LIMIT

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

REQUEST_DENIED

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

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

UNKNOWN_E RROR

成功。

ZERO_RESULTS

未找到此

GeocoderRequest

的结果。

erResult

对象规范

从地址解析服务器检索获得的单个地址解析器结果。一个地址解析请求可能会返回多个结 果对象。

请注意，尽管该结果为

“

类< /p>

JSON”

，但它并非严格意义上的

JSON

，因为该结果间接包含了

LatLng

对象。

属性

属性

说明

一个

address_components

< br>

Array.<

GeocoderAddressCo mponent

>

Geocoder AddressComponent

数组

geometry

Geocoder Geometry

一个

GeocoderGeometry

对象

一个字符串数组，这些字符串表

示传回的地址解析元素的类型。

一种类型，由标识地址解析结果

types

Array.

的唯 一字符串组成。（例如，

“administrative_area_level_1 ”

、

“country”

等等。）

类型

erAddressComponent

对象

规范

G eocoderResult

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

属性

属性

long_name

short_name

types

类型

string

string

Array.

说明

地址组件的完整文本

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

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

erGeometry

对象规范

< /p>

有关此

GeocoderResult

的 几何信息

属性

属性

类型

说明

bounds

LatLngBoun ds

此

GeocodeResult

的 精确范围（如果有）

location

LatLng

此结果的纬度

/

经度坐标

< br>

location_type

GeocoderLocationType

在

locati on

中传回的位置类型

viewport

LatLngBo unds

用于显示此

GeocodeResult

的建议可视区域的范围

erLocationType

类

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

常数

常数

APPROXIMATE

GEOMETRIC_CENTER

说明

传回的结果是近似值。

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

返回的 结果反映了通过插值取得的近似地址（通常在某条道路上），该地

RANGE_INTE RPOLATED

址处于两个精确点（如十字路口）之间。当 无法对街道地址进行公开的地

址解析时，通常会返回插值结果。

ROOFTOP

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

ionsRenderer

类

以从

DirectionsService

检索的

DirectionsResult

对象的形式渲染检索 的路线。此类扩展

了

MVCObject

。

构造函数

构造函数

说明

使用指定选项创建渲染程

序。路线可以渲染在地图

DirectionsRenderer(o pts?:

DirectionsRendererOptions

)

（作为可视叠加层）上，也

可 以渲染在

面板（作

为文本说 明）上。

方法

方法

getDirections()

getMap()

返回值

说明

传回渲染程序的当前路

DirectionsResult

线集。

传回在其上渲染

< br>Map

DirectionsResult

的地图。

传回在其中渲染

Node

< p>
DirectionsResult

的面板

。

传回此

number

DirectionsRenderer

getPanel()

getRouteIndex()

setDirections(directions:

Directions Result

)

None

setMap(map:< /p>

Map

)

None

setOptions(o ptions:

DirectionsRendererOptions

)

None

setPanel(panel:Node)

None

setRouteInde x(routeIndex:number)

None

对象使用的当前（基于

零的）路线索引。

将渲染程序设置为使用

DirectionsService

中的结果。以这种方式< /p>

设置一组有效的路线将

在渲染程序的指定地图

和面板上显示这些路

线。

此方法 指定将在其上渲

染路线的地图。传递

null

< br>可从地图中删除路

线。

在初始 化后更改此

DirectionsRenderer

的选项设置 。

此方法在

中渲染

路线。传递

null

可从

面板中删除内容。

在

< p>
DirectionsResult

对象中设置要渲染的路

线的（基于零的）索

引。默认情况下，将渲

染数组中的 第一条路

线。

事件

事件

参数

说明

当呈现的路线发生更改（在设置了新的

DirectionsR esult

或用户

directions_changed

None

将更改内容拖到路线路径上时）时会触发此事件。

ionsRendererOptions

对象规

范

此 对象定义可在

DirectionsRenderer

对象上设 置的属性。

属性

属性

directions

draggable

类型

说明

要在地图上和

/

或

面板中显示的路线，作

DirectionsR esult

为

DirectionsResult

对象从

DirectionsService

中检索 。

如果为

true

，则允许用户拖动并修改此

boolean

DirectionsRenderer

所呈现的路线路径。

< p>

此属性指示渲染程序是否应提供用户界面以在

备 选路线中进行选择。默认情况下，此标记为

boolean

false

，并且用户可选择的路线列表将显示在路

线的关联面板中。要隐藏该列表 ，请将

hideRouteList

设置为

true

。

hideRouteList

Inf oWindow

，当用户点击标记时，系统会在

其中呈现文本信 息。现有的信息窗口内容将会

被覆盖，其位置也会移动。如果未指定信息窗

infoWindow

InfoWindow

口，则

DirectionsRenderer

会创建并使用

自己的信息窗口。如果将

suppressI nfoWindows

设置为

true

，则系

统将会忽略该属性。

map

Map

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

< /p>

标记的选项。由

DirectionsRenderer

渲染

markerOptions

< p>
MarkerOptions

的所有标记都将使用这些选项。

panel

Node

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

。

折线的选项。由

DirectionsRenderer

渲染< /p>

polylineOptions

Po lylineOptions

的所有折线都将使用这些选项。

默认情况下，输入地图会居中并缩放以适应此

组路线的边框。如 果此选项设置为

true

，则

pres erveViewport

boolean

可视区域将保持不变 ，但如果从未设置地图的

中心和缩放则例外。

DirectionsResult

对象中路线的索引。默

routeIndex

number

认值为

0

。

当请求骑车路线时，取消

BicyclingLayer

suppressBicyclingLayer

boolean

的渲染。

suppressInfoWindows

boolean

取消信息窗口的渲染。

suppressMarkers

boolean

取消标记的渲染。

suppressPolylines

boolean

取消折线的渲染。

ionsService

类

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

构造函数

构造函数

说明

创建可将路线查询发送到

Google

服务器的新

DirectionsService

实

DirectionsService()

例。

方法

方法

route(request:

DirectionsRequest

,

callback:function(

DirectionsResult

,

DirectionsStatus

))

返回

说明

值

发出路线搜

None

索请求。

ionsRequest

对象规范

将发送到

< br>DirectionsService

的路线查询。

属性

属性

类型

说明

如果为

true

，则指示路线服务尽 可能避开

高速公路。可选。

如果为

true

，则指示路线服务尽 可能避开

avoidTolls

boolean

收费公路。可选。

目标位置。可将此 项指定为要进行地址解

destination

LatLng

|string

析的字符串或

LatLng

。必填。

如果设置为

true

，

DirectionService

将尝试重新排列所提供 中间路标的顺序，

从而最大程度地降低路线的总体成本。如

op timizeWaypoints

boolean

果优化路标，则检查 响应中的

nt_order

以确定新顺序。

原点的位置。可将此项指定为要进行地址

origin< /p>

LatLng

|string

解析的字符串或

LatLng

。必填。

provideRouteAlternatives

boolean

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

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

region

string

选。

travelMode

Travel Mode

请求的路线类型。必填。

显 示距离时要使用的首选单位制。默认为

unitSystem

UnitSystem

原点所在国家

/

地区使用的单位制。

中间路标的数组 。将通过此数组中的每个

waypoints

Array.<

DirectionsWaypoint

>

路标计算从原点到目标的路线。可选。

avoidHighways

boolean

Mode

类

可在

Di rectionsRequest

中指定的有效出行方式以及在

DirectionsStep

中传回的出行方式。

常数

常数

BICYCLING

DRIVING

WALKING

说明

指定骑车路线请求。

指定行车路线请求。

指定步行路线请求。

stem

类

可在

Di rectionsRequest

中指定的有效单位制。

常数

常数

IMPERIAL

METRIC

说明

指定应以英制单位表示

DirectionsResult

中的距离。

指定应以公制单位表示

DirectionsResult

中的距离。

ionsWaypoint

对象规范

DirectionsWa ypoint

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

属性

属性

类型

说明

location

LatLng

|string

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

LatLng

。可选。

如果为

true

< p>
，则表示此路标是介于原点和目标之间的站点。这会导致

stopover

boolean

< br>将路线一分为二。默认情况下，此值为

true

。可选。

ionsStatus

类

完成对

r oute()

的调用时由

DirectionsService

传回的状态。

常数

常数

INVALID_REQUEST

说明

提供的

DirectionsRequest

无效。

在

DirectionsRequest

中提供的

DirectionsWaypoint

过多。

MAX_WAYPOINTS_EXCEEDED

允许的总路标数为

8

个，此外还包括原点和目标。

NOT_FOUND

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

OK

响应包含有效的

DirectionsResult

。

OVER_QUERY_LIMIT

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

REQUEST_DENIED

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

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

UNKNOWN_ERROR

会成功。

ZERO_RESULTS

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

ionsResult

对象规范

< /p>

从路线服务器检索获得的路线响应。您可以使用

Directio nsRenderer

呈现这些路线，也可以解

析此对象并自行 呈现。您必须显示

Maps API

服务条款

中所述的警告和版权信息。请注意，尽管该

结果为

“< /p>

类

JSON”

，但它并非严格意义上的

JSON

，因为该结果间接包含了

LatLng

对象。

属性

属性

说明

DirectionsRoute

数组，其中每一个都包含自己 所含路

程和路段的相关信息。除非创建

DirectionsR equest

时

routes

Array.<

DirectionsRoute

>

provideRouteAlternatives

设置为

true

，否则将只

< p>
有一条路线。（此属性以前称为

“trips”

。 ）

类型

ionsRoute

对象规范

在

DirectionsResult

中包 含一组路程的单个路线（此对象以前称为

“DirectionsTrip”

< p>
）。请注

意，尽管该对象为

“

类

JSON”

，但它并非严格意义上的

JSON

，因为该对象直接且间接包含了

LatLng

对象。

属性

属性

类型

说明

-

-

-

-

-

-

-

-

本文更新与2021-02-19 02:23，由作者提供，不代表本网站立场，转载请注明出处：https://www.bjmy2z.cn/gaokao/666496.html

返回列表：英语

上一篇：白居易长恨歌什么意思
下一篇：SlickEdit使用技巧整理