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 MapPanes
· Marker:
· Polyline:
· Polygon:
· InfoWindow:
· Geocoder:
· 叠加层和地图类型:
o MapType
o Circle
· 图层:
o KmlLayer
· 街景视图:
o StreetViewAddressControlOptions
· 事件:
o 事件
· Base:
o LatLng
o Point
o Size
· MVC:
o MVCArray
此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Map(mapDiv:Node, opts?:MapOptions) | 在指定的 HTML 容器中创建新的地图,该容器通常是一个 DIV 元素。 |
方法
方法 | 返回值 | 说明 |
fitBounds(bounds:LatLngBounds) | None | 设置地图,使其与指定范围相符。 |
getBounds() | 返回当前视口的纬度/经度范围。如果还未启动地图(即 mapType 仍为 Null),或者没有设置中心和缩放,则结果为 Null。 | |
getCenter() | ||
getDiv() | Node | |
getMapTypeId() | ||
getProjection() | 传回当前的 Projection。如果还未启动地图(即 mapType 仍为 Null),则结果为 Null。侦听 projection_changed 并检查它的值以确保它的值不为 Null。 | |
getStreetView() | 将默认 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 | 按字符串 ID 划分的 MapType 实例的注册表。 | |
overlayMapTypes | 要叠加的其他地图类型。 |
事件
事件 | 参数 | 说明 |
bounds_changed | None | 当可视区域范围更改时会触发此事件。 |
center_changed | None | 当地图中心属性更改时会触发此事件。 |
click | 当用户点击地图(但不是点击标记或信息窗口)时会触发此事件。 | |
dblclick | 当用户双击地图时会触发此事件。请注意,触发此事件前还会触发点击事件。 | |
drag | None | 当用户拖动地图时会反复触发此事件。 |
dragend | None | 当用户停止拖动地图时会触发此事件。 |
dragstart | None | 当用户开始拖动地图时会触发此事件。 |
idle | None | 如果地图在平移或缩放之后变为闲置状态,则会触发此事件。 |
maptypeid_changed | None | 当 mapTypeId 属性更改时会触发此事件。 |
mousemove | 只要用户的鼠标在地图容器上移动,就会触发此事件。 | |
mouseout | 当用户的鼠标从地图容器上退出时会触发此事件。 | |
mouseover | 当用户的鼠标进入地图容器时会触发此事件。 | |
projection_changed | None | 当投影更改时会触发此事件。 |
resize | None | 当 div 更改大小时,开发人员应在地图上触发此事件:google.maps.event.trigger(map, 'resize')。 |
rightclick | 在地图容器中触发 DOM contextmenu 事件时会触发此事件。 | |
tilesloaded | None | 可见图块载入完成后会触发此事件。 |
zoom_changed | None | 当地图缩放属性更改时会触发此事件。 |
属性
属性 | 类型 | 说明 |
backgroundColor | string | 用作地图 div 的背景颜色。当用户进行平移时,如果尚未载入图块,则显示此颜色。仅在启动地图时,才能设置此选项。 |
center | 初始的地图中心。必填。 | |
disableDefaultUI | boolean | 启用/停用所有默认的用户界面。该属性可以单独进行重写。 |
disableDoubleClickZoom | boolean | 启用/停用在双击时缩放并居中。默认情况下处于启用状态。 |
draggable | boolean | 如果为 False,则禁止拖动地图。默认情况下启用拖动。 |
draggableCursor | string | 要在可拖动对象上显示的光标的名称或网址。 |
draggingCursor | string | 要在拖动对象时显示的光标的名称或网址。 |
keyboardShortcuts | boolean | 如果为 False,则禁止通过键盘控制地图。默认情况下启用键盘快捷键。 |
mapTypeControl | boolean | 地图类型控件的初始启用/停用状态。 |
mapTypeControlOptions | 地图类型控件的初始显示选项。 | |
mapTypeId | 初始的地图 mapTypeId。必填。 | |
navigationControl | boolean | 导航控件的初始启用/停用状态。 |
navigationControlOptions | 导航控件的初始显示选项。 | |
noClear | boolean | 如果为 true,则不会清除地图 div 的内容。 |
scaleControl | boolean | 缩放控件的初始启用/停用状态。 |
scaleControlOptions | 缩放控件的初始显示选项。 | |
scrollwheel | boolean | 如果为 False,则停用通过滚轮缩放地图的功能。默认情况下启用滚轮功能。 |
streetView | 将街景视图街景小人置于地图上时显示的 StreetViewPanorama。如果未指定全景图,则拖动街景小人时,默认 StreetViewPanorama 将显示在地图的 div中。 | |
streetViewControl | boolean | 街景视图街景小人控件的初始启用/停用状态。 |
zoom | number | 初始的地图缩放级别。必填。 |
常见 MapTypes的标识符。
常数
常数 | 说明 |
HYBRID | 该地图类型显示卫星图像上的主要街道透明层。 |
ROADMAP | 该地图类型显示普通的街道地图。 |
SATELLITE | 该地图类型显示卫星图像。 |
TERRAIN | 该地图类型显示带有自然特征(如地形和植被)的地图。 |
用于渲染地图类型控件的选项。
属性
属性 | 类型 | 说明 |
mapTypeIds | Array.<MapTypeId>|Array.<string> | 要在控件中显示的地图类型的 ID。 |
position | 位置 ID。用于指定控件在地图上的位置。默认位置为 TOP_RIGHT。 | |
style | 样式 ID。用于选择要显示的地图类型控件的样式。 |
常见 MapTypesControls的标识符。
常数
常数 | 说明 |
DEFAULT | 使用默认的地图类型控件。地图默认使用的控件会因窗口大小和其他因素而有所不同。该控件可能在该 API 以后的版本中有所更改。 |
DROPDOWN_MENU | 反映屏幕实际使用面积的下拉菜单。 |
HORIZONTAL_BAR | 标准的水平单选按钮栏。 |
用于渲染导航控件的选项。
属性
属性 | 类型 | 说明 |
position | 位置 ID。用于指定控件在地图上的位置。默认位置为 TOP_LEFT。 | |
style | 样式 ID。用于选择要显示的导航控件的样式。 |
导航控件常见类型的标识符。
常数
常数 | 说明 |
ANDROID | 这是一种小型缩放控件,与 Android 上的本机地图应用程序所用的控件相似。 |
DEFAULT | 默认的导航控件。地图默认使用的控件会因窗口大小和其他因素而有所不同。该控件可能在该 API 以后的版本中有所更改。 |
SMALL | 只具有缩放功能的小型控件。 |
ZOOM_PAN | 较大控件,具有缩放滑块和平移方向柄。 |
用于渲染比例控件的选项。
属性
属性 | 类型 | 说明 |
position | 位置 ID。用于指定控件在地图上的位置。默认位置为 BOTTOM_LEFT。 | |
style | 样式 ID。用于选择要显示的缩放控件的样式。 |
缩放控件 ID的标识符。
常数
常数 | 说明 |
DEFAULT | 标准缩放控件。 |
用于指定控件在地图上的位置的标识符。控件相对于同一布局位置中的其他控件而定位。首先添加的控件将定位在靠近地图边缘的位置。
+---------------+
+ TL T TR +
+ +
+ L R +
+ +
+ +
+ +
+ BL B BR +
+---------------+
顶部或底部行中的元素将向中间流动。左侧或右侧的元素向下流动。
常数
常数 | 说明 |
BOTTOM | 元素定位在底部行的中间。 |
BOTTOM_LEFT | 元素定位在左下角并向中间流动。元素定位在 Google 徽标的右侧。 |
BOTTOM_RIGHT | 元素定位在右下角并向中间流动。元素定位在版权的左侧。 |
LEFT | 元素定位在左侧,位于左上角的元素下面,并向下流动。 |
RIGHT | 元素定位在右侧,位于右上角的元素下面,并向下流动。 |
TOP | 元素定位在顶部行的中间。 |
TOP_LEFT | 元素定位在左上角并向中间流动。 |
TOP_RIGHT | 元素定位在右上角并向中间流动。 |
此对象包含渲染叠加层的 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)。 |
方法
方法 | 返回值 | 说明 |
fromContainerPixelToLatLng(pixel:Point) | 根据地图容器中的像素坐标计算地理坐标。 | |
fromDivPixelToLatLng(pixel:Point) | 根据存放可拖动地图的 div 中的像素坐标计算地理坐标。 | |
fromLatLngToContainerPixel(latLng:LatLng) | 计算地图外部容器的 DOM 元素中指定地理位置的像素坐标。 | |
fromLatLngToDivPixel(latLng:LatLng) | 计算存放可拖动地图的 DOM 元素中指定地理位置的像素坐标。 | |
getWorldWidth() | number | 当前缩放级别下世界地图的宽度(以像素为单位)。 |
此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Marker(opts?:MarkerOptions) | 创建带有指定选项的标记。如果已指定地图,则标记会在构造完成后立即添加到该地图。请注意,您必须设置标记的显示位置。 |
方法
方法 | 返回值 | 说明 |
getClickable() | boolean | |
getCursor() | string | |
getDraggable() | boolean | |
getFlat() | boolean | |
getIcon() | string|MarkerImage | |
getMap() | ||
getPosition() | ||
getShadow() | string|MarkerImage | |
getShape() | ||
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 | 当用户拖动标记时会反复触发此事件。 | |
dragend | 当用户停止拖动标记时会触发此事件。 | |
draggable_changed | None | 当标记的可拖动属性更改时会触发此事件。 |
dragstart | 当用户开始拖动标记时会触发此事件。 | |
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 属性更改时会触发此事件。 |
属性
属性 | 类型 | 说明 |
clickable | boolean | 如果为 true,则标记会收到鼠标事件和触摸事件。默认值为 true。 |
cursor | string | 鼠标悬停时显示的光标。 |
draggable | boolean | 如果为 true,则可拖动标记。默认值为 false。 |
flat | boolean | 如果为 true,则不会显示标记阴影。 |
icon | string|MarkerImage | 前景的图标 |
map | 待显示标记的地图。 | |
position | 标记位置。必填。 | |
shadow | string|MarkerImage | 阴影图像 |
shape | 用于拖动/点击的图像地图区域定义。 | |
title | string | 滚动文本 |
visible | boolean | 如果为 true,则显示标记。 |
zIndex | number | 所有标记按其 zIndex 值的大小顺序在地图上显示,zIndex 值较大的标记显示在值较小的标记之前。默认情况下,标记是按纬度显示的,纬度较低的标记显示在纬度较高的标记前。 |
构造函数
构造函数 | 说明 |
MarkerImage(url:string,size?:Size,origin?:Point,anchor?:Point,scaledSize?:Size) | 定义一张用作标记图标或者阴影的图像。“origin”和“size”用于选择拼合图像的图块,“anchor”用于重写锚点默认所处的底部中间位置。图像的锚点是系统在跟踪图像位置时引用的像素。默认情况下,锚点设置为图像的底部中间位置 (坐标宽度/2, 高度)。因此,当标记放置在指定的 LatLng 上时,定义为锚点的像素就定位于指定的 LatLng 上。要缩放图像,无论该图像是否为拼合图像,都请将 scaledSize 的值设置为整个图像的大小,并用换算值设置大小、原点和锚点。MarkerImage 在构造完成后就无法更改。 |
此对象定义用于确定标记的可点击区域的标记形状。该形状包括两个属性(type 和 coord),这两个属性定义该类型的标记特有的常规类型的标记和坐标。
属性
属性 | 类型 | 说明 |
coord | Array.<number> | 此属性的格式取决于 type 的值,并且遵循 http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords 上的 w3 AREA coords 规范。 |
type | string | 描述形状的类型,并且可以是 circle、poly 或 rectangle。 |
折线是地图上的连接线段的线性叠加层。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Polyline(opts?:PolylineOptions) | 使用传递的 Polyline options 创建折线,这些选项可以指定折线的路径以及绘制折线时要使用的笔触样式。您可以在构造折线时传递 LatLng 数组或 LatLng 的 MVCArray,但在实例化时,简单的数组会在折线中转换为 MVCArray。 |
方法
方法 | 返回值 | 说明 |
getMap() | 传回已附加此折线或多边形的地图。 | |
getPath() | 检索第一条路径。 | |
setMap(map:Map) | None | 在指定地图上渲染此折线或多边形。如果地图设置为 Null,则会删除此折线或多边形。 |
setOptions(options:PolylineOptions) | None | |
None | 设置第一条路径。有关详细信息,请参见 Polyline options。 |
事件
事件 | 参数 | 说明 |
click | 对折线触发 DOM click 事件时会触发此事件。 | |
dblclick | 对折线触发 DOM dblclick 事件时会触发此事件。 | |
mousedown | 对折线触发 DOM mousedown 事件时会触发此事件。 | |
mousemove | 对折线触发 DOM mousemove 事件时会触发此事件。 | |
mouseout | 此事件针对折线 mouseout 触发。 | |
mouseover | 此事件针对折线 mouseover 触发。 | |
mouseup | 对折线触发 DOM mouseup 事件时会触发此事件。 | |
rightclick | 右键点击折线时会触发此事件。 |
属性
属性 | 类型 | 说明 |
clickable | boolean | 指示此 Polyline 是否处理 click 事件。默认值为 true。 |
geodesic | boolean | 将每条边渲染为测地线(“大圆”的一段)。测地线是沿地球表面的两点之间的最短路径。 |
map | 要在其上显示折线的地图。 | |
path | 折线坐标的有序序列。可以使用一个简单的 LatLng 数组或者 LatLng 的 MVCArray 指定此路径。请注意,如果您传递简单的数组,则它会转换为 MVCArray。在 MVCArray 中插入或删除 LatLng 将自动更新地图上的折线。 | |
strokeColor | string | 采用 HTML 十六进制样式的笔触颜色,即“#FFAA00” |
strokeOpacity | number | 介于 0.0 和 1.0 之间的笔触不透明度 |
strokeWeight | number | 笔触宽度(以像素为单位)。 |
zIndex | number | 相对于其他折线的 zIndex。 |
多边形(类似于折线)可在一个有序序列中定义一系列连接坐标;此外,多边形会形成一个闭合环并定义一个填充区域。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Polygon(opts?:PolygonOptions) | 使用传递的 Polygon options 创建多边形,这些选项可以指定多边形的路径、多边形边缘的笔触样式,以及多边形内部区域的填充样式。一个多边形可以包含一条或多条路径,其中每条路径由一个 LatLng 数组组成。您可以在构造这些路径时传递一个 LatLng 数组或 LatLng 的 MVCArray。实例化时,数组会在多边形中转换为 MVCArray。 |
方法
方法 | 返回值 | 说明 |
getMap() | 传回已附加此折线或多边形的地图。 | |
getPath() | 检索第一条路径。 | |
getPaths() | 检索此多边形的路径。 | |
setMap(map:Map) | None | 在指定地图上渲染此折线或多边形。如果地图设置为 Null,则会删除此折线或多边形。 |
setOptions(options:PolygonOptions) | None | |
None | 设置第一条路径。有关详细信息,请参见 Polyline options。 | |
setPaths(paths: | None | 设置此多边形的路径。 |
事件
事件 | 参数 | 说明 |
click | 对多边形触发 DOM click 事件时会触发此事件。 | |
dblclick | 对多边形触发 DOM dblclick 事件时会触发此事件。 | |
mousedown | 对多边形触发 DOM mousedown 事件时会触发此事件。 | |
mousemove | 对多边形触发 DOM mousemove 事件时会触发此事件。 | |
mouseout | 此事件针对多边形 mouseout 触发。 | |
mouseover | 此事件针对多边形 mouseover 触发。 | |
mouseup | 对多边形触发 DOM mouseup 事件时会触发此事件。 | |
rightclick | 右键点击多边形时会触发此事件。 |
属性
属性 | 类型 | 说明 |
clickable | boolean | 指示此 Polygon 是否处理 click 事件。默认值为 true。 |
fillColor | string | 采用 HTML 十六进制样式的填充颜色,即“#00AAFF” |
fillOpacity | number | 介于 0.0 和 1.0 之间的填充不透明度 |
geodesic | boolean | 将每条边渲染为测地线(“大圆”的一段)。测地线是沿地球表面的两点之间的最短路径。 |
map | 要在其上显示多边形的地图。 | |
paths | MVCArray.<MVCArray.<LatLng>>| | 用于指定闭合环的坐标的有序序列。不同于折线,一个多边形由一条或多条路径组成。因此,路径属性可以指定一个或多个 LatLng 坐标数组。可以使用一个 LatLng 数组定义简单的多边形。多个复杂的多边形可以指定一系列数组。任何简单数组都可以转换为 MVCArray。在 MVCArray 中插入或删除 LatLng 将自动更新地图上的多边形。 |
strokeColor | string | 采用 HTML 十六进制样式的笔触颜色,即“#FFAA00” |
strokeOpacity | number | 介于 0.0 和 1.0 之间的笔触不透明度 |
strokeWeight | number | 笔触宽度(以像素为单位)。 |
zIndex | number | 相对于其他折线的 zIndex。 |
叠加层外观与提示框类似,通常会连接到某个标记。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
InfoWindow(opts?:InfoWindowOptions) | 创建带有指定选项的信息窗口。信息窗口可以放置在地图的特定位置,也可以位于标记上方,具体取决于选项中指定的内容。除非停用自动平移,否则,信息窗口会在打开后平移地图,以便让自己显示出来。信息窗口构建完成后,您需要调用 open 函数,才能在地图上显示该窗口。用户可以点击信息窗口上的关闭按钮将其从地图中关闭,开发人员也可以调用 close() 函数实现同样的效果。 |
方法
方法 | 返回值 | 说明 |
close() | None | 关闭此信息窗口,方法是将其从 DOM 结构中删除。 |
getContent() | string|Node | |
getPosition() | ||
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 更改时会触发此事件。 |
属性
属性 | 类型 | 说明 |
content | string|Node | 要在信息窗口中显示的内容。该内容可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。信息窗口将会根据相应内容调整大小。要设置内容的具体大小,请将内容设置为相应大小的 HTML 元素。 |
disableAutoPan | boolean | 停用在打开时自动平移的功能。默认情况下,信息窗口会在打开后平移地图,以便让自己完全显示出来。 |
maxWidth | number | 信息窗口的最大宽度(不考虑内容的宽度)。仅在已调用 open 函数前设置了该值时,才考虑使用这个值。在更改内容时,如果要更改最大宽度,请调用 close 函数、setOptions 函数,然后调用 open 函数。 |
pixelOffset | 信息窗口的箭头距离信息窗口在地图上所锚定地理坐标点的偏移量(以像素为单位)。如果信息窗口是通过锚点打开的,则从锚点范围的顶部中心开始计算 pixelOffset。 | |
position | 用于显示此信息窗口的 LatLng。如果信息窗口是通过锚点打开的,则使用锚点的位置。 | |
zIndex | number | 所有信息窗口按 zIndex 值的大小顺序在地图上显示,zIndex 值较大的信息窗口显示在值较小的信息窗口之前。默认情况下,信息窗口是按纬度显示的,纬度较低的信息窗口显示在纬度较高的信息窗口前。信息窗口始终在标记前面显示。 |
用于在地址和 LatLng 之间进行转换的服务。
构造函数
构造函数 | 说明 |
Geocoder() | 创建可将地址解析请求发送到 Google 服务器的新 Geocoder 实例。 |
方法
方法 | 返回值 | 说明 |
geocode(request:GeocoderRequest, callback:function(Array.<GeocoderResult>,GeocoderStatus))) | None | 对请求内容进行地址解析。 |
要发送到 Geocoder 的地址解析请求的规范。
属性
属性 | 类型 | 说明 |
address | string | 地址。可选。 |
bounds | 要在其中进行搜索的 LatLngBounds。可选。 | |
language | string | 用于显示结果的首选语言。可选。 |
location | 要搜索的 LatLng。可选。 | |
region | string | 要在其中进行搜索的国家/地区代码的顶级域名。可选。 |
完成对 geocode() 的调用时由 Geocoder 传回的状态。
常数
常数 | 说明 |
ERROR | 连接 Google 服务器时出错。 |
INVALID_REQUEST | GeocoderRequest 无效。 |
OK | 响应包含有效的 GeocoderResponse。 |
OVER_QUERY_LIMIT | 网页发出请求的频率过高,超过了最短时间限制。 |
REQUEST_DENIED | 不允许网页使用地址解析器。 |
UNKNOWN_ERROR | 由于服务器错误而无法处理地址解析请求。如果您再试一次,该请求可能会成功。 |
ZERO_RESULTS | 未找到此 GeocoderRequest 的结果。 |
一个地址解析器将生成从地址解析服务器检索的 JSON格式。请注意,地址解析可能会传回多个结果对象。
属性
属性 | 类型 | 说明 |
address_components | Array.<GeocoderAddressComponent> | 一个 GeocoderAddressComponent 数组 |
geometry | 一个 GeocoderGeometry 对象 | |
types | Array.<string> | 一个字符串数组,这些字符串表示传回的地址解析元素的类型。一种类型,由标识地址解析结果的唯一字符串组成。(例如,“administrative_area_level_1”、“country”等等。) |
GeocoderResult 中的一个地址组件。一个完整地址可能由多个地址组件组成。
属性
属性 | 类型 | 说明 |
long_name | string | 地址组件的完整文本 |
short_name | string | 指定地址组件的简短缩写文本 |
types | Array.<string> | 一个字符串数组,这些字符串指示此地址组件的类型 |
有关此 GeocoderResult 的几何信息
属性
属性 | 类型 | 说明 |
bounds | 此 GeocodeResult 的精确范围(如果有) | |
location | 此结果的纬度/经度坐标 | |
location_type | 在 location 中传回的位置类型 | |
viewport | 用于显示此 GeocodeResult 的建议可视区域的范围 |
描述地址解析返回的位置类型。
常数
常数 | 说明 |
APPROXIMATE | 传回的结果是近似值。 |
GEOMETRIC_CENTER | 传回的结果是线(例如街道)或多边形(区域)等结果的几何中心。 |
RANGE_INTERPOLATED | 返回的结果反映了通过插值取得的近似地址(通常在某条道路上),该地址处于两个精确点(如十字路口)之间。当无法对街道地址进行公开的地址解析时,通常会返回插值结果。 |
ROOFTOP | 传回的结果反映了精确的地址解析。 |
以从 DirectionsService 检索的 DirectionsResult 对象的形式渲染检索的路线。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
DirectionsRenderer(opts?:DirectionsRendererOptions) | 使用指定选项创建渲染程序。路线可以渲染在地图(作为可视叠加层)上,也可以渲染在 <div> 面板(作为文本说明)上。 |
方法
方法 | 返回值 | 说明 |
getDirections() | 传回渲染程序的当前路线集。 | |
getMap() | 传回在其上渲染 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 对象中设置要渲染的路线的(基于零的)索引。默认情况下,将渲染数组中的第一条路线。 |
此对象定义可在 DirectionsRenderer 对象上设置的属性。
属性
属性 | 类型 | 说明 |
directions | 要在地图上和/或 <div> 面板中显示的路线,作为 DirectionsResult 对象从DirectionsService 中检索。 | |
hideRouteList | boolean | 此属性指示渲染程序是否应提供用户界面以在备选路线中进行选择。默认情况下,此标记为 false,并且用户可选择的路线列表将显示在路线的关联面板中。要隐藏该列表,请将hideRouteList 设置为 true。 |
map | 要在其上显示路线的地图。 | |
markerOptions | 标记的选项。由 DirectionsRenderer 渲染的所有标记都将使用这些选项。 | |
panel | Node | 要在其中显示路线路段的 <div>。 |
polylineOptions | 折线的选项。由 DirectionsRenderer 渲染的所有折线都将使用这些选项。 | |
preserveViewport | boolean | 默认情况下,输入地图会居中并缩放以适应此组路线的边框。如果此选项设置为 true,则可视区域将保持不变,但如果从未设置地图的中心和缩放则例外。 |
routeIndex | number | DirectionsResult 对象中路线的索引。默认值为 0。 |
suppressBicyclingLayer | boolean | 当请求骑车路线时,取消 BicyclingLayer 的渲染。 |
suppressInfoWindows | boolean | 取消信息窗口的渲染。 |
suppressMarkers | boolean | 取消标记的渲染。 |
suppressPolylines | boolean | 取消折线的渲染。 |
用于计算两个或多个位置之间路线的服务。
构造函数
构造函数 | 说明 |
DirectionsService() | 创建可将路线查询发送到 Google 服务器的新 DirectionsService 实例。 |
方法
方法 | 返回值 | 说明 |
route(request:DirectionsRequest, callback:function(DirectionsResult, DirectionsStatus))) | None | 发出路线搜索请求。 |
将发送到 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 | 请求的路线类型。必填。 | |
unitSystem | 显示距离时要使用的首选单位制。默认为原点所在国家/地区使用的单位制。 | |
waypoints | Array.<DirectionsWaypoint> | 中间路标的数组。将通过此数组中的每个路标计算从原点到目标的路线。可选。 |
可在 DirectionsRequest 中指定的有效出行方式以及在 DirectionsStep 中传回的出行方式。
常数
常数 | 说明 |
BICYCLING | 指定骑车路线请求。 |
DRIVING | 指定行车路线请求。 |
WALKING | 指定步行路线请求。 |
可在 DirectionsRequest 中指定的有效单位制。
常数
常数 | 说明 |
IMPERIAL | 指定应以英制单位表示 DirectionsResult 中的距离。 |
METRIC | 指定应以公制单位表示 DirectionsResult 中的距离。 |
DirectionsWaypoint 表示介于原点和目标之间的位置,行程路线将通过该位置。
属性
属性 | 类型 | 说明 |
location | LatLng|string | 路标位置。可以是地址字符串或 LatLng。可选。 |
stopover | boolean | 如果为 true,则表示此路标是介于原点和目标之间的站点。这会导致将路线一分为二。默认情况下,此值为true。可选。 |
完成对 route() 的调用时由 DirectionsService 传回的状态。
常数
常数 | 说明 |
INVALID_REQUEST | 提供的 DirectionsRequest 无效。 |
MAX_WAYPOINTS_EXCEEDED | 在 DirectionsRequest 中提供的 DirectionsWaypoint 过多。允许的总路标数为 8 个,此外还包括原点和目标。 |
NOT_FOUND | 至少无法对原点、目标或路标之一进行地址解析。 |
OK | 响应包含有效的 DirectionsResult。 |
OVER_QUERY_LIMIT | 网页发出请求的频率过高,超过了最短时间限制。 |
REQUEST_DENIED | 不允许网页使用路线服务。 |
UNKNOWN_ERROR | 由于服务器错误而无法处理路线请求。如果您再试一次,该请求可能会成功。 |
ZERO_RESULTS | 在原点和目标之间找不到任何路线。 |
路线以从路线服务器检索的 JSON格式进行响应。您可以使用 DirectionsRenderer 渲染这些路线,也可以解析此对象并自行渲染它。您必须显示Google Maps API 服务条款中描述的警告和版权。
属性
属性 | 类型 | 说明 |
routes | Array.<DirectionsRoute> | DirectionsRoute 数组,其中每一个都包含自己所含路程和路段的相关信息。除非创建 DirectionsRequest时 provideRouteAlternatives 设置为 true,否则将只有一条路线。(此属性以前称为“trips”。) |
一条在 DirectionsResult 中包含一组JSON 格式的路程的路线。(此对象以前称为“DirectionsTrip”)。
属性
属性 | 类型 | 说明 |
bounds | 此路线的范围。 | |
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,则此字段将包含输入路标的重新排序的排列。例如,如果输入为: |
一个路程,在 DirectionsResult 中包含一组JSON 格式的路段。路程中的某些字段可能并不会针对所有请求都传回。(此对象以前称为“DirectionsRoute”)。
属性
属性 | 类型 | 说明 |
distance | 此路程覆盖的总距离。此属性可能未定义,因为距离可能未知。 | |
duration | 此路程的总持续时间。此属性可能未定义,因为持续时间可能未知。 | |
end_address | string | 此路程的目标地址。 |
end_location | DirectionsService 使用起始位置和结束位置处最近的交通选项(通常为道路)计算两个位置之间的路线。end_location 指示实际的地址解析目标,在诸如以下的情况下,该目标可能不同于最后一个路段的 end_location:道路距离此路程的目标较远。 | |
start_address | string | 此路程的原点地址。 |
start_location | DirectionsService 使用起始位置和结束位置处最近的交通选项(通常为道路)计算两个位置之间的路线。start_location 指示实际的地址解析原点,在诸如以下的情况下,该原点可能不同于第一个路段的 start_location:道路距离此路程的原点较远。 | |
steps | Array.<DirectionsStep> | DirectionsStep 数组,其中每个路段都包含有关此路程中各个路段的信息。 |
DirectionsResult 中的一个采用 JSON格式的 DirectionsStep。某些字段可能尚未定义。
属性
属性 | 类型 | 说明 |
distance | 此路段覆盖的距离。此属性可能未定义,因为距离可能未知。 | |
duration | 完成此路段通常所需的时间(以秒为单位,采用文本形式)。此属性可能未定义,因为持续时间可能未知。 | |
end_location | 此路段的结束位置。 | |
instructions | string | 此路段的说明。 |
path | Array.<LatLng> | LatLng 的序列,描述此路段的路程。 |
start_location | 此路段的起始位置。 |
距离的表示(采用数值和显示字符串的形式)。
属性
属性 | 类型 | 说明 |
text | string | 距离值的字符串表示,使用请求中指定的 DirectionsUnitSystem。 |
value | number | 距离(以米为单位)。 |
持续时间的表示(采用数值和显示字符串的形式)。
属性
属性 | 类型 | 说明 |
text | string | 持续时间值的字符串表示。 |
value | number | 持续时间(以秒为单位)。 |
定义可直接与 Google服务器对话以请求海拔数据的服务类。
构造函数
构造函数 | 说明 |
ElevationService() | 创建可将海拔查询发送到 Google 服务器的新 ElevationService 实例。 |
方法
方法 | 返回值 | 说明 |
getElevationAlongPath(request:PathElevationRequest,callback:function(Array.<ElevationResult>, ElevationStatus))) | None | 沿路径创建海拔请求,其中海拔数据作为基于距离的示例沿该路径传回。 |
getElevationForLocations(request:LocationElevationRequest,callback:function(Array.<ElevationResult>, ElevationStatus))) | None | 针对一系列离散位置创建海拔请求。 |
由包含一系列离散坐标 (LatLng)的 ElevationService 发送的海拔请求,将针对这些坐标传回海拔数据。
属性
属性 | 类型 | 说明 |
locations | Array.<LatLng> | 要为其检索海拔的离散位置。 |
由包含路径的 ElevationService 发送的海拔查询,沿该路径传回采样数据。此请求定义沿地球的连续路径,沿该路径,将等距离获取海拔示例。顶点间的所有路径都使用介于这两点间的大圆线段。
属性
属性 | 类型 | 说明 |
path | Array.<LatLng> | 要沿其收集海拔值的路径。 |
samples | Number | 必填。沿指定路径的等距点数,要针对该路径检索海拔数据,包括端点。示例数必须介于 2 和 1024 之间。 |
ElevationService 请求的结果,由一组海拔坐标及其海拔值组成。请注意,一个请求可以生成多个 ElevationResult。
属性
属性 | 类型 | 说明 |
elevation | Number | 地球上此点的海拔(以高于海平面的米数表示)。 |
location | 此海拔结果的位置。 |
完成海拔请求时由 ElevationService 传回的状态。
常数
常数 | 说明 |
INVALID_REQUEST | 请求无效。 |
OK | 请求没有遇到任何错误。 |
OVER_QUERY_LIMIT | 网页发出请求的频率过高,超过了最短时间限制。 |
REQUEST_DENIED | 出于某种原因,不允许网页使用海拔服务。 |
UNKNOWN_ERROR | 无法成功处理地址解析、路线或海拔请求,但是确切的失败原因未知。 |
如果想在地图上显示自定义类型的叠加层对象,则可以使用此类。此类扩展了 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() | ||
getPanes() | 返回可在其中显示此 OverlayView 的窗格。仅在调用 draw 函数后才可用。 | |
getProjection() | 返回与相应 OverlayView 相关联的 MapCanvasProjection 对象。仅在调用 draw 函数后才可用。 | |
onAdd() | None | 实现此方法可初始化叠加层 DOM 元素。对有效地图调用 setMap() 之后,调用该方法一次。此时将会初始化窗格和投影。 |
onRemove() | None | 实现此方法可将您的元素从 DOM 删除。调用 setMap(null) 之后立即调用此方法。 |
setMap(map:Map|StreetViewPanorama) | None | 将叠加层添加到地图或全景图。 |
此接口定义地图类型。此接口通常用于基本地图,如道路、卫星或混合地图。固定不变。
方法
方法 | 返回值 | 说明 |
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 | 用于渲染此 MapType 的投影。可选;默认值为 Mercator。 | |
radius | number | 地图的行星半径(以米为单位)。可选;默认为地球的赤道半径(6378137 米)。 |
tileSize | 每个图块的尺寸。必填。 |
此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
MapTypeRegistry() | MapTypeRegistry 拥有一组可用于地图以帮助它实现用途的自定义地图类型。例如,API 将在提供控件中的可用地图类型列表时参考此注册表。 |
方法
方法 | 返回值 | 说明 |
set(id:string, mapType:MapType) | None | 设置注册表以将传递的字符串标识符与传递的 MapType 相关联。 |
方法
方法 | 返回值 | 说明 |
从 LatLng 圆柱转换为 Point 平面。此接口指定一个函数,该函数实现从指定 LatLng 值到地图投影上的世界地图坐标的转换。Google Maps API 在需要在屏幕上绘制位置时调用此方法。Projection 对象必须实现此方法。 | ||
fromPointToLatLng(pixel:Point,nowrap?:boolean) | 此接口指定一个函数,该函数实现从地图投影上的世界地图坐标到 LatLng 值的转换。Google Maps API 在需要将屏幕上的操作转换为地图上的位置时调用此方法。Projection对象必须实现此方法。 |
此类实现 MapType接口并提供用于渲染图像图块。
构造函数
构造函数 | 说明 |
ImageMapType(opts:ImageMapTypeOptions) | 使用提供的 ImageMapTypeOptions 构造 ImageMapType |
此类用于创建可渲染图像图块的 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 | 图块大小。 |
使用自定义样式创建 MapType。
构造函数
构造函数 | 说明 |
StyledMapType(style:Array.<MapTypeStyle>,options?:StyledMapTypeOptions) | 使用指定选项创建带有样式的 MapType。StyledMapType 会获取一个 MapTypeStyle 数组,其中各个MapTypeStyle 会相继应用到地图。如果后一个 MapTypeStyle 像前一个 MapTypeStyle 一样将相同的MapTypeStyler 应用到相同的选择器,则它将覆盖前一个 MapTypeStyle。 |
此类用于在创建 StyledMapType 时指定选项。
属性
属性 | 类型 | 说明 |
alt | string | 当此 MapType 的按钮悬停在地图类型控件中时显示的备选文本。 |
baseMapType | StyledMapType,其样式应当用作定义 StyledMapType 样式时所基于的样式。MapTypeStyle 规则将附加到基础样式。 | |
maxZoom | number | 显示此 MapType 时地图的最大缩放级别。可选。 |
minZoom | number | 显示此 MapType 时地图的最小缩放级别。可选。 |
name | string | 要在地图类型控件中显示的名称。 |
MapTypeStyle 是定义如何为地图设置样式的选择器和样式器的集合。选择器指定哪些地图元素将受影响,而样式器指定应如何修改这些元素。
属性
属性 | 类型 | 说明 |
elementType | 选择将应用某样式器的元素类型。元素类型在特征的表示方面各具特色。可选;如果未指定elementType,则假设值为 'all'。 | |
featureType | 选择要应用样式器的单个特征或者特征组。可选;如果未指定 featureType,则假设值为'all'。 | |
stylers | Array.<MapTypeStyler> | 要应用到选择器的样式规则。规则按它们在此数组中列出的顺序应用到地图的元素。 |
特征类型的可能值。将这些值指定为字符串形式,即 '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 在特征的表示方面各具特色。
常数
常数 | 说明 |
all | 将规则应用到指定特征的所有元素。 |
geometry | 将规则应用到特征的几何体。 |
labels | 将规则应用到特征的标签。 |
样式器影响为地图元素设置样式的方式。每个 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 | 可见性:有效值:“打开”、“关闭”或“简化”。 |
矩形叠加层。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Rectangle(opts?:RectangleOptions) | 使用传递的 RectangleOptions(它指定范围和样式)创建矩形。 |
方法
方法 | 返回值 | 说明 |
getBounds() | 传回此矩形的范围。 | |
getMap() | 传回显示此矩形的地图。 | |
setBounds(bounds:LatLngBounds) | None | 设置此矩形的范围。 |
setMap(map:Map) | None | 在指定地图上渲染此矩形。如果地图设置为 Null,则会删除此矩形。 |
setOptions(options:RectangleOptions) | None |
事件
事件 | 参数 | 说明 |
click | 对矩形触发 DOM click 事件时会触发此事件。 | |
dblclick | 对矩形触发 DOM dblclick 事件时会触发此事件。 | |
mousedown | 对矩形触发 DOM mousedown 事件时会触发此事件。 | |
mousemove | 对矩形触发 DOM mousemove 事件时会触发此事件。 | |
mouseout | 此事件针对矩形 mouseout 触发。 | |
mouseover | 此事件针对矩形 mouseover 触发。 | |
mouseup | 对矩形触发 DOM mouseup 事件时会触发此事件。 | |
rightclick | 右键点击矩形时会触发此事件。 |
属性
属性 | 类型 | 说明 |
bounds | 范围。 | |
clickable | boolean | 指示此 Rectangle 是否处理 click 事件。默认值为 true。 |
fillColor | string | 采用 HTML 十六进制样式的填充颜色,即“#00AAFF” |
fillOpacity | number | 介于 0.0 和 1.0 之间的填充不透明度 |
map | 要在其上显示矩形的地图。 | |
strokeColor | string | 采用 HTML 十六进制样式的笔触颜色,即“#FFAA00” |
strokeOpacity | number | 介于 0.0 和 1.0 之间的笔触不透明度 |
strokeWeight | number | 笔触宽度(以像素为单位)。 |
zIndex | number | 相对于其他折线的 zIndex。 |
地球表面的圆;也称为“球冠”。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
Circle(opts?:CircleOptions) | 使用传递的 CircleOptions(它指定中心、半径和样式)创建圆。 |
方法
方法 | 返回值 | 说明 |
getBounds() | 获取此圆的 LatLngBounds。 | |
getCenter() | 传回此圆的中心。 | |
getMap() | 传回在其上显示此圆的地图。 | |
getRadius() | number | 传回此圆的半径(以米为单位)。 |
setCenter(center:LatLng) | None | 设置此圆的中心。 |
setMap(map:Map) | None | 在指定地图上渲染此圆。如果地图设置为 Null,则会删除此圆。 |
setOptions(options:CircleOptions) | None | |
setRadius(radius:number) | None | 设置此圆的半径(以米为单位)。 |
事件
事件 | 参数 | 说明 |
click | 对圆触发 DOM click 事件时会触发此事件。 | |
dblclick | 对圆触发 DOM dblclick 事件时会触发此事件。 | |
mousedown | 对圆触发 DOM mousedown 事件时会触发此事件。 | |
mousemove | 对圆触发 DOM mousemove 事件时会触发此事件。 | |
mouseout | 此事件针对圆 mouseout 触发。 | |
mouseover | 此事件针对圆 mouseover 触发。 | |
mouseup | 对圆触发 DOM mouseup 事件时会触发此事件。 | |
rightclick | 右键点击圆时会触发此事件。 |
属性
属性 | 类型 | 说明 |
center | 中心 | |
clickable | boolean | 指示此 Circle 是否处理 click 事件。默认值为 true。 |
fillColor | string | 采用 HTML 十六进制样式的填充颜色,即“#00AAFF” |
fillOpacity | number | 介于 0.0 和 1.0 之间的填充不透明度 |
map | 要在其上显示圆的地图。 | |
radius | number | 地球表面的半径(以米为单位)。 |
strokeColor | string | 采用 HTML 十六进制样式的笔触颜色,即“#FFAA00” |
strokeOpacity | number | 介于 0.0 和 1.0 之间的笔触不透明度 |
strokeWeight | number | 笔触宽度(以像素为单位)。 |
zIndex | number | 相对于其他折线的 zIndex。 |
地图上的矩形图像叠加层。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
GroundOverlay(url:string, bounds:LatLngBounds,opts?:GroundOverlayOptions) | 根据提供的图像网址及其 LatLngBounds 创建地面叠加层。图像会进行缩放以适应当前的范围,并使用当前的地图投影进行投影。 |
方法
方法 | 返回值 | 说明 |
getBounds() | 获取此叠加层的 LatLngBounds。 | |
getMap() | 传回在其上显示此地面叠加层的地图。 | |
getUrl() | string | 获取投影图象的网址。 |
setMap(map:Map) | None | 在指定地图上渲染此地面叠加层。如果地图设置为 Null,则会删除此叠加层。 |
事件
事件 | 参数 | 说明 |
click | 对 GroundOverlay 触发 DOM click 事件时会触发此事件。 |
此对象定义可在 GroundOverlay 对象上设置的属性。
属性
属性 | 类型 | 说明 |
clickable | boolean | 如果为 true,则地面叠加层可以收到 click 事件。 |
map | 要在其上显示叠加层的地图。 |
显示自行车道和路径的图层。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
BicyclingLayer() | 显示自行车道和路径并表示大型道路的图层。 |
方法
方法 | 返回值 | 说明 |
getMap() | 传回在其上显示此图层的地图。 | |
setMap(map:Map) | None | 在指定地图上渲染此图层。如果地图设置为 Null,则会删除此图层。 |
利用 FusionTablesLayer,可以在地图上将来自 Google Fusion Table的数据显示为渲染的图层。(有关 Fusion Table的详细信息,请访问 http://code.google.com/apis/fusiontables。)可以使用 Fusion Table API中所使用的相同查询语言查询表数据。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
FusionTablesLayer(tableId:string, opts?:FusionTablesLayerOptions) | 显示来自 Fusion Table 的数据的图层。 |
方法
方法 | 返回值 | 说明 |
getMap() | 传回在其上显示此图层的地图。 | |
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 | 点击图层中的特征时将会触发此事件。 |
此对象定义可在 FusionTablesLayer 对象上设置的属性。
属性
属性 | 类型 | 说明 |
heatmap | boolean | 默认情况下,表数据显示为地理特征。如果为 true,则使用此图层显示热图,该热图表示通过查询选定表传回的地理特征的密度。 |
map | 要在其上显示图层的地图。 | |
query | string | 选择要显示的数据时应用的 Fusion Table 查询。查询不得进行网址转义。 |
suppressInfoWindows | boolean | 取消点击图层特征时信息窗口的渲染。 |
FusionTablesLayer 的鼠标事件的属性。
属性
属性 | 类型 | 说明 |
infoWindowHtml | string | 预先渲染的 HTML 内容,由默认用户界面放置在信息窗口中。 |
pixelOffset | 要应用于锚定在所点击特征上的信息窗口的偏移量。 | |
position | 信息窗口在所点击特征上的锚定位置。 | |
row | Object | FusionTablesCell 对象的集合,按列名称编入索引,表示包括所点击特征的表行的内容。 |
描述 Fusion Table表中的一个单元格。
属性
属性 | 类型 | 说明 |
columnName | string | 单元格所在列的名称。 |
value | string | 单元格的内容。 |
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() | 获取在其上渲染 KML 图层的地图。 | |
getMetadata() | 获取与此图层相关联的元数据,如图层标记中所指定。 | |
getUrl() | string | 获取所显示的地理标记的网址。 |
setMap(map:Map) | None | 在指定地图上渲染该 KML 图层。如果地图设置为 Null,则会删除此图层。 |
事件
事件 | 参数 | 说明 |
click | 点击图层中的特征时将会触发此事件。 | |
defaultviewport_changed | None | 当 KML 图层默认可视区域改变时会触发此事件。 |
此对象定义可在 KmlLayer 对象上设置的属性。
属性
属性 | 类型 | 说明 |
map | 要在其上显示图层的地图。 | |
preserveViewport | boolean | 默认情况下,输入地图会居中并缩放以适应图层内容的边框。如果此选项设置为 true,则可视区域将保持不变,但如果从未设置地图的中心和缩放则例外。 |
suppressInfoWindows | boolean | 取消点击图层特征时信息窗口的渲染。 |
一个 KML图层的元数据(采用 JSON 格式)。
属性
属性 | 类型 | 说明 |
author | 图层的 <atom:author>,从图层标记中提取。 | |
description | string | 图层的 <description>,从图层标记中提取。 |
name | string | 图层的 <name>,从图层标记中提取。 |
snippet | string | 图层的 <Snippet>,从图层标记中提取。 |
KML/KMZ 或 GeoRSS文档的 click 事件的属性。
属性
属性 | 类型 | 说明 |
featureData | KmlFeatureData 对象,包含有关所点击特征的信息。 | |
pixelOffset | 要应用于锚定在所点击特征上的信息窗口的偏移量。 | |
position | 信息窗口在所点击特征上的锚定位置。 |
一个 JSON格式的 KML 特征数据,当点击 KML 特征时传回。此对象中包含的数据将镜像声明它时所在的 KML或 GeoRSS 标记中特征的关联数据。
属性
属性 | 类型 | 说明 |
author | 特征的 <atom:author>,从图层标记(如果已指定)中提取。 | |
description | string | 特征的 <description>,从图层标记中提取。 |
id | string | 特征的 <id>,从图层标记中提取。如果没有指定 <id>,则将为此特征生成唯一 ID。 |
infoWindowHtml | string | 特征的气球样式文本(如果已设置)。 |
name | string | 特征的 <name>,从图层标记中提取。 |
snippet | string | 特征的 <Snippet>,从图层标记中提取。 |
包含有关 KML文档或特征的作者的详细信息。
属性
属性 | 类型 | 说明 |
| string | 作者的电子邮件地址,或空字符串(如果未指定)。 |
name | string | 作者的姓名,或空字符串(如果未指定)。 |
uri | string | 作者的主页,或空字符串(如果未指定)。 |
路况图层。此类扩展了 MVCObject。
构造函数
构造函数 | 说明 |
TrafficLayer() | 显示当前路况的图层。 |
方法
方法 | 返回值 | 说明 |
getMap() | 传回在其上显示此图层的地图。 | |
setMap(map:Map) | None | 在指定地图上渲染此图层。如果地图设置为 Null,则会删除此图层。 |
显示指定 LatLng 的全景图或全景图 ID。StreetViewPanorama 对象提供街景视图“查看器”,该查看器可以独立位于单独的 <div> 中,也可绑定到 Map。此类扩展了MVCObject。
构造函数
构造函数 | 说明 |
StreetViewPanorama(container:Node, opts?:StreetViewPanoramaOptions) | 使用传递的 StreetViewPanoramaOptions 创建全景图。 |
方法
方法 | 返回值 | 说明 |
getLinks() | Array.<StreetViewLink> | 传回街景视图全景图的导航链接集。 |
getPano() | string | 传回街景视图全景图的当前全景图 ID。此 ID 仅在浏览器的当前会话中固定不变。 |
getPosition() | 传回街景视图全景图的当前LatLng 位置。 | |
getPov() | 传回街景视图全景图的当前视点。 | |
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()时,可见性会改变。 |
用于定义 StreetViewPanorama 对象的属性的选项。
属性
属性 | 类型 | 说明 |
addressControl | boolean | 地址控件的启用/停用状态。 |
addressControlOptions | 地址控件的显示选项。 | |
enableCloseButton | boolean | 如果为 true,则显示关闭按钮。默认情况下处于停用状态。 |
linksControl | boolean | 链接控件的启用/停用状态。 |
navigationControl | boolean | 导航控件的启用/停用状态。 |
navigationControlOptions | 导航控件的显示选项。 | |
pano | string | 全景图 ID,应在指定自定义全景图时设置。 |
panoProvider | Function(string):StreetViewPanoramaData | 自定义全景图提供程序,它获取字符串全景图 ID 并传回对象来定义使用该 ID 的全景图。必须定义此函数才可以指定自定义全景图图像。 |
position | 街景视图全景图的 LatLng 位置。 | |
pov | 镜头方向,指定为全景图的方向、倾斜度和缩放。 |
用于渲染街景视图地址控件的选项。
属性
属性 | 类型 | 说明 |
position | 位置 ID。此 ID 用于指定控件在地图上的位置。默认位置为 TOP_LEFT。 | |
style | Object.<string> | 要应用到街景视图地址控件的 CSS 样式。例如,{backgroundColor: 'red'}。 |
相邻街景视图全景图的参考集合。
属性
属性 | 类型 | 说明 |
description | string | 描述链接的本地化字符串。 |
heading | number | 链接的标题。 |
pano | string | 全景图的唯一标识符。此 ID 在某会话持续期间保持固定不变,但在各会话之间会改变。 |
roadColor | string | 链接的颜色 |
roadOpacity | number | 链接的不透明度 |
用于指定街景视图全景图位置处镜头方向的视点对象。将视点定义为方向、倾斜度和缩放。
属性
属性 | 类型 | 说明 |
heading | number | 相对于正北的镜头方向(以度为单位)。正北为 0°,正东为 90°,正南为 180°,正西为 270°。 |
pitch | number | 相对于街景视图工具的镜头倾斜度(以度为单位)。范围为 90°(朝正上方)到 -90°(朝正下方)。 |
zoom | number | 缩放级别。级别 0 为完全缩小,进行扩大可提高缩放级别。 |
从使用 registerPanoProvider 定义的提供程序传回的全景图的表示。
属性
属性 | 类型 | 说明 |
copyright | string | 指定此全景图的版权文本。 |
links | Array.<StreetViewLink> | 指定相邻全景图的导航链接。 |
location | 指定此全景图的位置元数据。 | |
tiles | 指定此全景图的自定义图块。 |
街景视图全景图中某个位置的表示。
属性
属性 | 类型 | 说明 |
description | string | 描述位置的本地化字符串。 |
latLng | 全景图的 latlng。 | |
pano | string | 全景图的唯一标识符。这在某会话持续期间保持固定不变,但在各会话之间会改变。 |
在街景视图全景图中使用的图块集的属性。
方法
方法 | 返回值 | 说明 |
getTileUrl(pano:string, tileZoom:number, tileX:number, tileY:number) | string | 获取指定图块的图块图像网址。 |
属性
属性 | 类型 | 说明 |
originHeading | number | 全景图图块的原点处的方向(以度为单位)。 |
tileSize | 图块的渲染大小(以像素为单位)。这可能不是本机图块图像大小。 | |
worldSize | 整个全景图“世界”的大小(以像素为单位)。 |
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 米,则传回最近的全景图。 |
完成街景视图请求时由 StreetViewService 传回的状态。
常数
常数 | 说明 |
OK | 请求已成功。 |
UNKNOWN_ERROR | 无法成功处理请求,但确切的失败原因是未知的。 |
ZERO_RESULTS | 没有附近的全景图。 |
此类是不透明的。它没有方法和构造函数。此类的实例从 addListener()、addDomListener()返回,并最终传递回 removeListener()。
静态方法
静态方法 | 返回值 | 说明 |
addDomListener(instance:Object,eventName:string, handler:Function) | 跨浏览器注册事件处理程序。通过调用该函数所返回句柄的 eventRemoveListener(handle) 删除此侦听器。 | |
addDomListenerOnce(instance:Object,eventName:string, handler:Function) | 将在第一个事件之后删除侦听器的 addDomListener 周围的包装。 | |
addListener(instance:Object,eventName:string, handler:Function) | 将指定侦听器函数添加到指定对象实例的指定事件名称。传回该侦听器的标识符,该标识符能够与 eventRemoveListener() 配合使用。 | |
addListenerOnce(instance:Object,eventName:string, handler:Function) | 类似于 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 后的所有参数都以参数的形式传递到侦听器。 |
此对象由地图和叠加层上的各种鼠标事件返回,包含如下所示的所有字段。
属性
属性 | 类型 | 说明 |
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 实例代表通过地理坐标表示的矩形,包含与 180度子午线相交的矩形。
构造函数
构造函数 | 说明 |
基于矩形的西南角和东北角处的点构造矩形。 |
方法
方法 | 返回值 | 说明 |
contains(latLng:LatLng) | boolean | 如果此范围包含指定的纬度/经度,则传回 true。 |
equals(other:LatLngBounds) | boolean | 如果此范围与指定范围大致相等,则传回 true。 |
extend(point:LatLng) | 延伸此范围以包含指定点。 | |
getCenter() | 计算该 LatLngBounds 的中心。 | |
getNorthEast() | 用于传回此范围的东北角。 | |
getSouthWest() | 用于传回此范围的西南角。 | |
intersects(other:LatLngBounds) | boolean | 如果此范围与另一范围共享任何点,则传回 true。 |
isEmpty() | boolean | 当范围为空时传回。 |
toSpan() | 将指定的地图范围转换为纬度/经度跨度。 | |
toString() | string | 转换为字符串。 |
toUrlValue(precision?:number) | string | 以“lat_lo,lng_lo,lat_hi,lng_hi”形式返回该范围的字符串,其中“lo”表示边界框的西南角,而“hi”表示边界框的东北角。 |
union(other:LatLngBounds) | 延伸此范围以包含此范围和指定范围的并集。 |
构造函数
构造函数 | 说明 |
Point(x:number, y:number) | 二维平面上的点。 |
方法
方法 | 返回值 | 说明 |
equals(other:Point) | boolean | 比较两个点 |
toString() | string | 传回该点的字符串表示。 |
属性
属性 | 类型 | 说明 |
x | number | X 坐标 |
y | number | Y 坐标 |
构造函数
构造函数 | 说明 |
Size(width:number, height:number, widthUnit?:string,heightUnit?:string) | 二维大小,其中宽度是指 x 轴上的距离,高度是指 y 轴上的距离。 |
方法
方法 | 返回值 | 说明 |
equals(other:Size) | boolean | 比较两个大小。 |
toString() | string | 传回该大小的字符串表示。 |
属性
属性 | 类型 | 说明 |
height | number | 沿 y 轴的高度(以像素为单位)。 |
width | number | 沿 X 轴的宽度(以像素为单位)。 |
构造函数
构造函数 | 说明 |
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 | 删除所有绑定。 |
此类扩展了 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 | 设置指定索引处的元素。 |