Map 类
google.maps.Map 类
此类扩展了 MVCObject。
通过调用 const {Map} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
Map |
Map(mapDiv[, opts])参数：
在指定的 HTML 容器（通常为 DIV 元素）内创建新的地图。 |
常量 | |
|---|---|
DEMO_MAP_ID |
地图 ID，可用于需要地图 ID 的代码示例。此地图 ID 不用于生产应用，也不能用于需要云端配置的功能（例如云端样式设置）。 |
属性 | |
|---|---|
controls |
类型：
Array<MVCArray<HTMLElement>>附加到地图的其他控件。如需向地图添加控件，请将控件的 <div> 添加到与应渲染它的 ControlPosition 相对应的 MVCArray。 |
data |
类型：
Data绑定到地图的 Data 实例。向此 Data 对象添加地图项，以便方便地在此地图上显示它们。 |
mapTypes |
MapType 实例的注册表（按字符串 ID）。 |
overlayMapTypes |
要叠加的其他地图类型。叠加层地图类型将按照在 overlayMapTypes 数组中出现的顺序，在其附加到的基本地图之上显示（索引值较高的叠加层会显示在索引值较低的叠加层前面）。 |
方法 | |
|---|---|
fitBounds |
fitBounds(bounds[, padding])参数：
返回值：None
用于设置视口，使其包含指定边界。 注意：当地图设置为 display: none 时，fitBounds 函数会将地图的大小读取为 0x0，因此不会执行任何操作。要在地图隐藏时更改视口，请将地图设置为 visibility: hidden，以确保地图 div 具有实际尺寸。对于矢量地图，此方法会将地图的倾斜度和朝向设置为默认零值。调用此方法可以使动画在地图平移和缩放以适应边界时呈现平滑的动画。此方法是否添加动画效果取决于内部启发法。 |
getBounds |
getBounds()参数：无
返回值：
LatLngBounds|undefined 当前视口的纬度/经度边界。用于返回当前视口的纬度/经度范围。如果世界有多个副本可见，则经度的边界范围在 -180 度（含）到 180 度（含）之间。如果地图尚未初始化，或者尚未设置中心和缩放功能，则结果为 undefined。对于倾斜或朝向非零的矢量地图，返回的纬度/经度边界表示包含地图视口可见区域的最小边界框。如需获取地图视口的确切可见区域，请参阅 MapCanvasProjection.getVisibleRegion。 |
getCenter |
getCenter()参数：无
返回值：
LatLng|undefined |
getClickableIcons |
getClickableIcons()参数：无
返回值：
boolean|undefined返回地图图标的可点击性。地图图标表示地图注点，也称为地图注点。如果返回的值为 true，则图标在地图上是可点击的。 |
|
getDatasetFeatureLayer(datasetId)参数：
返回值：
FeatureLayer返回指定 datasetId 的 FeatureLayer。数据集 ID 必须在 Google Cloud 控制台中配置。如果数据集 ID 未与地图样式相关联，或者数据驱动型样式不可用（没有地图 ID、没有矢量图块、没有在地图样式中配置数据驱动型样式地图项图层或数据集），则系统会记录错误，并且生成的 FeatureLayer.isAvailable 将为 false。 |
getDiv |
getDiv()参数：无
返回值：
HTMLElement 地图的 mapDiv。 |
getFeatureLayer |
getFeatureLayer(featureType)参数：
返回值：
FeatureLayer返回特定 FeatureType 的 FeatureLayer。必须在 Google Cloud 控制台中启用 FeatureLayer。如果此地图上不存在指定 FeatureType 的 FeatureLayer，或者数据驱动型样式不可用（没有地图 ID、矢量图块且地图样式未启用 FeatureLayer），则系统会记录错误，并且生成的 FeatureLayer.isAvailable 将为 false。 |
getHeading |
getHeading()参数：无
返回值：
number|undefined返回地图的罗盘方向角。方向角值以度（顺时针）为单位，基本方向为北方。如果地图尚未初始化，则结果为 undefined。 |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled()参数：无
返回值：
boolean|null返回是否启用标题互动。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
getMapCapabilities |
getMapCapabilities()参数：无
返回值：
MapCapabilities根据提供的地图 ID 告知调用方地图当前可用的功能。 |
getMapTypeId |
getMapTypeId()参数：无
返回值：
MapTypeId|string|undefined |
getProjection |
getProjection()参数：无
返回值：
Projection|undefined返回当前的 Projection。如果地图尚未初始化，则结果为 undefined。监听 projection_changed 事件并检查其值，以确保其不是 undefined。 |
getRenderingType |
getRenderingType()参数：无
返回值：
RenderingType返回地图的当前 RenderingType。 |
getStreetView |
getStreetView()参数：无
返回值：
StreetViewPanorama 绑定到地图的全景图片。返回绑定到地图的默认 StreetViewPanorama（可能是嵌入地图的默认全景图片，也可以是使用 setStreetView() 设置的全景图片）。对地图的 streetViewControl 所做的更改将反映在此类边界全景图片的显示中。 |
getTilt |
getTilt()参数：无
返回值：
number|undefined返回地图的当前入射角，以度为单位，从视口平面到地图平面。对于光栅地图，对于直接俯拍的图像，结果将为 0；对于 45° 角航拍图像，结果将为 45。此方法不会返回 setTilt 设置的值。如需了解详情，请参阅 setTilt。 |
getTiltInteractionEnabled |
getTiltInteractionEnabled()参数：无
返回值：
boolean|null返回是否启用倾斜交互。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
getZoom |
getZoom()参数：无
返回值：
number|undefined返回地图的缩放级别。如果未设置缩放，则结果为 undefined。 |
moveCamera |
moveCamera(cameraOptions)参数：
返回值：None
立即将地图的镜头设置为目标镜头选项，而不使用动画。 |
panBy |
panBy(x, y)参数：
返回值：None
将地图中心移动一段指定的距离（以像素为单位）。如果这段距离既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。请注意，地图坐标系的 x 值从西向东增加，y 值从北向南增加。 |
panTo |
panTo(latLng)参数：
返回值：None
将地图中心更改为指定的 LatLng。如果更改幅度既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。 |
panToBounds |
panToBounds(latLngBounds[, padding])参数：
返回值：None
将地图平移所需的最小距离来包含指定 LatLngBounds。它无法保证边界在地图上的位置，除了会平移地图，以显示 {currentMapSizeInPx} - {padding} 内尽可能多的边界。对于光栅地图和矢量地图，地图的缩放、倾斜度和朝向都不会更改。 |
setCenter |
setCenter(latlng)参数：
返回值：None
|
setClickableIcons |
setClickableIcons(value)参数：
返回值：None
控制地图图标是否可点击。地图图标表示地图注点，也称为地图注点。要停用地图图标的可点击性，请将 false 值传递给此方法。 |
setHeading |
setHeading(heading)参数：
返回值：None
用于设置地图的罗盘方向角（以度为单位），基本方向为北方。对于光栅地图，此方法仅适用于航拍图像。 |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled)参数：
返回值：None
设置是否启用标题互动。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
setMapTypeId |
setMapTypeId(mapTypeId)参数：
返回值：None
|
setOptions |
setOptions(options)参数：
返回值：None
|
setRenderingType |
setRenderingType(renderingType)参数：
返回值：None
设置地图的当前 RenderingType。 |
setStreetView |
setStreetView(panorama)参数：
返回值：None
将 StreetViewPanorama 绑定到地图。此全景图片会覆盖默认的 StreetViewPanorama，从而允许地图绑定到地图外的外部全景。将全景图片设置为 null 可将默认的嵌入式全景图片绑定回地图。 |
setTilt |
setTilt(tilt)参数：
返回值：None
对于矢量地图，设置地图的入射角。允许的值取决于地图的缩放级别。 对于光栅地图，控制地图入射角的自动切换行为。只允许使用 0 和 45 值。setTilt(0) 会使地图始终使用 0° 俯视图，无论缩放级别和视口是多少。setTilt(45) 会使倾斜角度自动切换为 45，以便在当前缩放级别和视口范围内有 45° 图像时使用，没有 45° 图像时则切换回 0（这是默认行为）。45° 角航拍图像仅适用于部分位置和某些缩放级别的 satellite 和 hybrid 地图类型。注意：getTilt 会返回当前倾斜角度，而不是 setTilt 设置的值。由于 getTilt 和 setTilt 引用不同的内容，因此请勿对 tilt 属性执行 bind() 操作；这样做可能会产生不可预知的影响。 |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled)参数：
返回值：None
设置是否启用倾斜交互。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
setZoom |
setZoom(zoom)参数：
返回值：None
设置地图的缩放比例。 |
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
活动 | |
|---|---|
bounds_changed |
function()参数：None
当可视区域范围更改时会触发此事件。 |
center_changed |
function()参数：None
当地图中心属性更改时会触发此事件。 |
click |
function(event)参数：
用户点击地图时会触发此事件。除非用户点击地点图标，否则会返回带有所点击位置的属性的 MapMouseEvent，在这种情况下，会返回具有地点 ID 的 IconMouseEvent。IconMouseEvent 和 MapMouseEvent 完全相同，只是 IconMouseEvent 具有地点 ID 字段。当地点 ID 不重要时，系统始终可将该事件视为 MapMouseEvent。如果用户点击标记或信息窗口，则不会触发点击事件。 |
contextmenu |
function(event)参数：
在地图容器中触发 DOM contextmenu 事件时会触发此事件。 |
dblclick |
function(event)参数：
当用户双击地图时会触发此事件。请注意，点击事件有时会在触发前触发一次，有时触发两次。 |
drag |
function()参数：None
当用户拖动地图时会反复触发此事件。 |
dragend |
function()参数：None
当用户停止拖动地图时会触发此事件。 |
dragstart |
function()参数：None
当用户开始拖动地图时会触发此事件。 |
heading_changed |
function()参数：None
当地图方向属性更改时会触发此事件。 |
idle |
function()参数：None
如果地图在平移或缩放之后变为闲置状态，则会触发此事件。 |
isfractionalzoomenabled_changed |
function()参数：None
当 isFractionalZoomEnabled 属性更改时会触发此事件。 |
mapcapabilities_changed |
function()参数：None
当地图功能发生更改时会触发此事件。 |
maptypeid_changed |
function()参数：None
当 mapTypeId 属性更改时会触发此事件。 |
mousemove |
function(event)参数：
只要用户的鼠标在地图容器上移动，就会触发此事件。 |
mouseout |
function(event)参数：
当用户的鼠标从地图容器上退出时会触发此事件。 |
mouseover |
function(event)参数：
当用户的鼠标进入地图容器时会触发此事件。 |
projection_changed |
function()参数：None
当投影更改时会触发此事件。 |
renderingtype_changed |
function()参数：None
当 renderType 更改时会触发此事件。 |
tilesloaded |
function()参数：None
可见图块载入完成后会触发此事件。 |
tilt_changed |
function()参数：None
当地图倾斜属性更改时会触发此事件。 |
zoom_changed |
function()参数：None
当地图缩放属性更改时会触发此事件。 |
|
function(event)参数：
当用户右键点击地图时会触发此事件。 |
MapOptions 接口
google.maps.MapOptions 接口
MapOptions 对象，用于定义可在 Map 上设置的属性。
属性 | |
|---|---|
backgroundColor optional |
类型：
string optional用于地图 div 的背景颜色。当用户进行平移时，如果图块尚未加载，则会显示此颜色。仅在启动地图时，才能设置此选项。 |
center optional |
类型：
LatLng|LatLngLiteral optional初始的地图中心。 |
clickableIcons optional |
类型：
boolean optional默认值：
true为 false 时，地图图标无法点击。地图图标表示地图注点，也称为地图注点。 |
controlSize optional |
类型：
number optional在地图上显示的控件的大小（以像素为单位）。创建地图时必须直接提供此值，以后更新此值可能会使控件处于 undefined 状态。仅管理由 Maps API 本身创建的控件。不能扩缩开发者创建的自定义控件。 |
disableDefaultUI optional |
类型：
boolean optional启用/停用所有默认界面按钮。可以单独替换。不会停用由 MapOptions.keyboardShortcuts 选项单独控制的键盘控件。不会停用由 MapOptions.gestureHandling 选项单独控制的手势控件。 |
disableDoubleClickZoom optional |
类型：
boolean optional启用/停用在双击时缩放并居中。默认处于启用状态。 注意：不建议使用此属性。如需停用双击缩放，您可以使用 |
|
类型：
boolean optional如果为 false，则阻止拖动地图。默认情况下启用拖动。 |
draggableCursor optional |
类型：
string optional将鼠标悬停在可拖动地图上时要显示的光标的名称或网址。此属性使用 CSS cursor 属性来更改图标。与 CSS 属性一样，您必须至少指定一个非网址后备游标。例如：draggableCursor: 'url(http://www.example.com/icon.png), auto;'。 |
draggingCursor optional |
类型：
string optional拖动地图时要显示的光标的名称或网址。此属性使用 CSS cursor 属性来更改图标。与 CSS 属性一样，您必须至少指定一个非网址后备游标。例如：draggingCursor: 'url(http://www.example.com/icon.png), auto;'。 |
fullscreenControl optional |
类型：
boolean optional全屏控件的启用/停用状态。 |
fullscreenControlOptions optional |
类型：
FullscreenControlOptions optional全屏控件的显示选项。 |
gestureHandling optional |
类型：
string optional此设置用于控制 API 处理地图上的手势的方式。允许使用的值：
|
heading optional |
类型：
number optional航拍图像的方向值按顺时针方向计算（以度为单位），基本方向为北方。方向会与可以查看到图像的距离最近的可用角度相对齐。 |
headingInteractionEnabled optional |
类型：
boolean optional默认值：
false地图是否应允许用户控制镜头朝向（旋转）。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
isFractionalZoomEnabled optional |
类型：
boolean optional默认值：
true（对于矢量地图）和 false（对于光栅地图）地图是否应允许使用小数缩放级别。监听 isfractionalzoomenabled_changed，了解默认值何时设置。 |
keyboardShortcuts optional |
类型：
boolean optional如果为 false，则禁止通过键盘控制地图。默认情况下启用键盘快捷键。 |
mapId optional |
类型：
string optional地图的地图 ID。将地图实例化后，您将无法设置或更改此参数。 Map.DEMO_MAP_ID 可用于试用需要地图 ID 但不需要云端启用的地图项。 |
mapTypeControl optional |
类型：
boolean optional地图类型控件的初始启用/停用状态。 |
mapTypeControlOptions optional |
类型：
MapTypeControlOptions optional地图类型控件的初始显示选项。 |
mapTypeId optional |
类型：
MapTypeId|string optional初始地图 mapTypeId。默认为 ROADMAP。 |
maxZoom optional |
类型：
number optional将会在地图上显示的最大缩放级别。如果省略或设置为 null，则系统会改为使用当前地图类型的最大缩放级别。有效的缩放值为从 0 到支持的最大缩放级别的数字。 |
minZoom optional |
类型：
number optional将会在地图上显示的最小缩放级别。如果省略或设置为 null，则系统会改为使用当前地图类型的最小缩放级别。有效的缩放值为从 0 到支持的最大缩放级别的数字。 |
noClear optional |
类型：
boolean optional如果为 true，则不会清除地图 div 的内容。 |
|
类型：
boolean optional平移控件的启用/停用状态。 |
|
类型：
PanControlOptions optional平移控件的显示选项。 |
renderingType optional |
类型：
RenderingType optional地图应该是光栅地图还是矢量地图。将地图实例化后，您将无法设置或更改此参数。如果未设置此字段，则地图 ID 的云配置将决定渲染类型（如果有）。请注意，并非所有设备和浏览器都支持矢量地图，且地图会根据需要回退为使用光栅地图。 |
restriction optional |
类型：
MapRestriction optional定义边界，限制用户可访问的地图区域。设置后，用户只能在镜头视图保持在边界内时进行平移和缩放。 |
rotateControl optional |
类型：
boolean optional旋转控件的启用/停用状态。 |
rotateControlOptions optional |
类型：
RotateControlOptions optional旋转控件的显示选项。 |
scaleControl optional |
类型：
boolean optional比例控件的初始启用/停用状态。 |
scaleControlOptions optional |
类型：
ScaleControlOptions optional比例控件的初始显示选项。 |
scrollwheel optional |
类型：
boolean optional如果为 false，则停用使用鼠标滚轮缩放地图的功能。滚轮默认处于启用状态。注意：不建议使用此属性。如需停用使用滚轮缩放功能，您可以使用 |
streetView optional |
类型：
StreetViewPanorama optional将街景小人拖放到地图上时显示的 StreetViewPanorama。如果未指定全景图片，当用户放下街景小人时，默认的 StreetViewPanorama 将显示在地图的 div 中。 |
streetViewControl optional |
类型：
boolean optional街景小人控件的初始启用/停用状态。该控件是默认界面的一部分，并且在显示不应显示街景道路叠加层的地图类型（例如，非地球地图类型）时，应将其设置为 false。 |
streetViewControlOptions optional |
类型：
StreetViewControlOptions optionalStreet View 街景小人控件的初始显示选项。 |
styles optional |
类型：
Array<MapTypeStyle> optional要应用到各个默认地图类型的样式。请注意，对于 satellite/hybrid 和 terrain 模式，这些样式将仅应用于标签和几何图形。使用地图 ID 或矢量地图（请改用云端地图样式设置）时，无法使用此功能。 |
tilt optional |
类型：
number optional对于矢量地图，设置地图的入射角。允许的值取决于地图的缩放级别。对于光栅地图，控制地图入射角的自动切换行为。只允许使用 0 和 45 值。无论缩放级别和视口是多少，0 值都会使地图始终使用 0° 俯视图。值 45 会在当前缩放级别和视口范围内，每当有 45° 角航拍图像时，自动切换为 45，在没有 45° 图像时切换回 0（这是默认行为）。45° 角航拍图像仅适用于部分位置和某些缩放级别的 satellite 和 hybrid 地图类型。注意：getTilt 会返回当前倾斜角度，而不是此选项指定的值。由于 getTilt 和此选项表示不同的内容，因此请勿对 tilt 属性执行 bind() 操作；这样做可能会产生不可预知的影响。 |
tiltInteractionEnabled optional |
类型：
boolean optional默认值：
false地图是否应允许用户控制镜头倾斜度。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。 |
zoom optional |
类型：
number optional初始地图缩放级别。有效的缩放值为从 0 到支持的最大缩放级别的数字。变焦值越大，则分辨率越高。 |
zoomControl optional |
类型：
boolean optional缩放控件的启用/停用状态。 |
zoomControlOptions optional |
类型：
ZoomControlOptions optional缩放控件的显示选项。 |
MapElement 类
google.maps.MapElement 类
MapElement 是用于渲染地图的 HTMLElement 子类。加载 maps 库后，您便可使用 HTML 创建地图。例如：
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>在内部，它使用
Map，可以通过 innerMap 属性访问。
自定义元素：
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
此类扩展了 HTMLElement。
此类实现 MapElementOptions。
通过调用 const {MapElement} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
MapElement |
MapElement([options])参数：
|
属性 | |
|---|---|
center |
类型：
LatLng|LatLngLiteral optional地图中心纬度/经度。
HTML 属性：
|
headingInteractionDisabled |
类型：
boolean optional默认值：
false地图是否应允许用户控制镜头朝向（旋转）。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。
HTML 属性：
|
innerMap |
类型：
Map对 MapElement 在内部使用的 Map 的引用。 |
mapId |
类型：
string optional地图的地图 ID。将地图实例化后，您将无法设置或更改此参数。
Map.DEMO_MAP_ID 可用于试用需要地图 ID 但不需要云端启用的地图项。HTML 属性：
|
renderingType |
类型：
RenderingType optional地图应该是光栅地图还是矢量地图。将地图实例化后，您将无法设置或更改此参数。如果未设置此字段，则地图 ID 的云配置将决定渲染类型（如果有）。请注意，并非所有设备和浏览器都支持矢量地图，且地图会根据需要回退为使用光栅地图。
HTML 属性：
|
tiltInteractionDisabled |
类型：
boolean optional默认值：
false地图是否应允许用户控制镜头倾斜度。仅当地图为矢量地图时，此选项才有效。如果未在代码中设置，系统将使用地图 ID 的云配置（如果有）。
HTML 属性：
|
zoom |
类型：
number optional地图的缩放级别。有效的缩放值为从 0 到支持的最大缩放级别的数字。变焦值越大，则分辨率越高。
HTML 属性：
|
方法 | |
|---|---|
|
addEventListener(type, listener[, options])参数：
返回值：
void设置每当指定事件传送至目标时调用的函数。请参阅 addEventListener。 |
|
removeEventListener(type, listener[, options])参数：
返回值：
void从目标中移除之前通过 addEventListener 注册的事件监听器。请参阅 removeEventListener |
活动 | |
|---|---|
gmp-zoomchange |
function(event)参数：
当地图缩放属性更改时会触发此事件。 |
MapElementOptions 接口
google.maps.MapElementOptions 接口
MapElementOptions 对象用于定义可在 MapElement 上设置的属性。
属性 | |
|---|---|
center optional |
类型：
LatLng|LatLngLiteral optional |
headingInteractionDisabled optional |
类型：
boolean optional |
mapId optional |
类型：
string optional请参阅 MapElement.mapId。 |
renderingType optional |
类型：
RenderingType optional |
tiltInteractionDisabled optional |
类型：
boolean optional |
zoom optional |
类型：
number optional请参阅 MapElement.zoom。 |
ZoomChangeEvent 类
google.maps.ZoomChangeEvent 类
此事件是通过监控缩放变化而创建的。
此类扩展了 Event。
通过调用 const {ZoomChangeEvent} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
MapTypeStyle 接口
google.maps.MapTypeStyle 接口
MapTypeStyle 是定义如何设置地图样式的选择器和样式器的集合。选择器指定受影响的地图项和/或元素，而样式器指定应如何修改这些地图项和元素。如需了解详情，请参阅样式参考。
属性 | |
|---|---|
stylers |
要应用于所选地图项和元素的样式规则。系统会按照您在此数组中指定的顺序应用这些规则。有关用法和允许的值的准则，请参阅样式参考。 |
elementType optional |
类型：
string optional要应用样式器的元素。元素是地图上地图项的视觉元素。示例：标签、图标、应用于几何图形的描边或填充等。可选。如果未指定 elementType，则假定值为 'all'。如需详细了解用法和允许的值，请参阅样式参考。 |
featureType optional |
类型：
string optional |
MapMouseEvent 接口
google.maps.MapMouseEvent 接口
此对象由地图和叠加层上的各种鼠标事件返回，包含如下所示的所有字段。
属性 | |
|---|---|
domEvent |
对应的原生 DOM 事件。开发者不应依赖 target、currentTarget、relatedTarget 和 path 属性的定义和一致性。此外，开发者还不应依赖 Maps API 内部实现的 DOM 结构。由于内部事件映射，domEvent 的语义可能与 MapMouseEvent 不同（例如，MapMouseEvent“点击”的 domEvent 的类型为 KeyboardEvent）。 |
latLng optional |
类型：
LatLng optional发生事件时在光标下方显示的纬度/经度。 |
方法 | |
|---|---|
stop |
stop()参数：无
返回值：
void阻止此事件进一步传播。 |
IconMouseEvent 接口
google.maps.IconMouseEvent 接口
当用户点击地图上的图标时，系统会在事件中发送此对象。此地点的地点 ID 存储在 placeId 成员中。要阻止显示默认信息窗口，请针对此事件调用 stop() 方法，以阻止该窗口的传播。如需详细了解地点 ID，请参阅 Places API 开发者指南。
此接口扩展了 MapMouseEvent。
属性 | |
|---|---|
placeId optional |
类型：
string optional获得点击的地点的地点 ID。此地点 ID 可用于查询有关所点击地图项的更多信息。 如需详细了解地点 ID，请参阅 Places API 开发者指南。 |
已继承：domEvent、latLng
| |
方法 | |
|---|---|
已继承：
stop
|
MapTypeId 常量
google.maps.MapTypeId 常量
常用 MapType 的标识符。通过值或使用常量名称来指定这些变量。例如，'satellite' 或 google.maps.MapTypeId.SATELLITE。
通过调用 const {MapTypeId} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
HYBRID |
该地图类型显示卫星图像上的主要街道透明层。 |
ROADMAP |
该地图类型显示普通的街道地图。 |
SATELLITE |
该地图类型显示卫星图像。 |
TERRAIN |
该地图类型显示带有自然特征（如地形和植被）的地图。 |
MapTypeRegistry 类
google.maps.MapTypeRegistry 类
MapType 实例的注册表，以 MapType ID 键控。
此类扩展了 MVCObject。
通过调用 const {MapTypeRegistry} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
MapTypeRegistry |
MapTypeRegistry()参数：无
MapTypeRegistry 存储了可供地图使用的自定义地图类型集合。例如，在提供控件内的可用地图类型列表时，API 将参考此注册表。 |
方法 | |
|---|---|
set |
set(id, mapType)参数：
返回值：None
设置注册表以将传递的字符串标识符与传递的 MapType 相关联。 |
已继承：addListener、bindTo、get、notify、setValues、unbind、unbindAll
| |
MapRestriction 接口
google.maps.MapRestriction 接口
可应用于地图的限制。地图的视口不会超过这些限制。
属性 | |
|---|---|
latLngBounds |
设置后，用户只能在给定边界内平移和缩放。边界可以限制经度和纬度，也可以仅限制纬度。对于仅含纬度的边界，请分别使用西经和东经度值 -180 和 180，例如 latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}。 |
strictBounds optional |
类型：
boolean optional将 strictBounds 标志设置为 true 可以进一步限制边界。这会减少用户的缩小幅度，确保受限边界以外的所有内容都会保持隐藏状态。默认值为 false，表示用户可以缩小，直到整个边界区域显示在视图中，可能包括边界区域之外的区域。 |
TrafficLayer 类
google.maps.TrafficLayer 类
路况图层。
此类扩展了 MVCObject。
通过调用 const {TrafficLayer} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
TrafficLayer |
TrafficLayer([opts])参数：
显示当前路况的图层。 |
方法 | |
|---|---|
getMap |
getMap()参数：无
返回值：
Map传回在其上显示此图层的地图。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此图层。如果地图设置为 null，该图层将被移除。 |
setOptions |
setOptions(options)参数：
返回值：None
|
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
TrafficLayerOptions 接口
google.maps.TrafficLayerOptions 接口
TrafficLayerOptions 对象，用于定义可在 TrafficLayer 上设置的属性。
属性 | |
|---|---|
autoRefresh optional |
类型：
boolean optional默认值：
true是否使用更新后的信息自动更新路况图层。 |
map optional |
类型：
Map optional要在其上显示路况图层的地图。 |
TransitLayer 类
google.maps.TransitLayer 类
公交图层。
此类扩展了 MVCObject。
通过调用 const {TransitLayer} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
TransitLayer |
TransitLayer()参数：无
显示公交线路的图层。 |
方法 | |
|---|---|
getMap |
getMap()参数：无
返回值：
Map传回在其上显示此图层的地图。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此图层。如果地图设置为 null，该图层将被移除。 |
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
BicyclingLayer 类
google.maps.BicyclingLayer 类
显示自行车道和路径的图层。
此类扩展了 MVCObject。
通过调用 const {BicyclingLayer} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
构造函数 | |
|---|---|
BicyclingLayer |
BicyclingLayer()参数：无
显示自行车道和路径并表示大型道路的图层。 |
方法 | |
|---|---|
getMap |
getMap()参数：无
返回值：
Map传回在其上显示此图层的地图。 |
setMap |
setMap(map)参数：
返回值：None
在指定地图上渲染此图层。如果地图设置为 null，该图层将被移除。 |
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
| |
CameraOptions 接口
google.maps.CameraOptions 接口
用于设置地图的镜头选项。
属性 | |
|---|---|
center optional |
类型：
LatLngLiteral|LatLng optional |
heading optional |
类型：
number optional |
tilt optional |
类型：
number optional |
zoom optional |
类型：
number optional |
VisibleRegion 接口
google.maps.VisibleRegion 接口
包含用于定义四边形多边形（即地图的可见区域）的四个点。在矢量地图上，如果矢量地图有倾斜度，则此多边形可以是梯形，而不是矩形。
属性 | |
|---|---|
farLeft |
类型：
LatLng |
farRight |
类型：
LatLng |
latLngBounds |
类型：
LatLngBounds包含可见区域的最小边界框。 |
nearLeft |
类型：
LatLng |
nearRight |
类型：
LatLng |
RenderingType 常量
google.maps.RenderingType 常量
通过调用 const {RenderingType} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
常量 | |
|---|---|
RASTER |
表示地图为光栅地图。 |
UNINITIALIZED |
表示尚未知地图是矢量地图还是光栅地图，因为地图尚未完成初始化。 |
VECTOR |
表示地图是矢量地图。 |
MapCapabilities 接口
google.maps.MapCapabilities 接口
对象，包含地图当前可用功能的快照。请注意，这并不一定意味着相关模块已加载或初始化，而是表示当前地图有权使用这些 API。请参阅属性，了解可能的功能列表。
属性 | |
|---|---|
isAdvancedMarkersAvailable optional |
类型：
boolean optional如果为 true，则表示此地图已正确配置，允许使用高级标记。请注意，您仍必须导入 marker 库，才能使用高级标记。如需了解详情，请参阅 https://goo.gle/gmp-isAdvancedMarkersAvailable。 |
isDataDrivenStylingAvailable optional |
类型：
boolean optional如果为 true，则表示此地图已正确配置，可允许至少一个 FeatureLayer 使用数据驱动型样式。如需了解详情，请访问 https://goo.gle/gmp-data-driven-styling 和 https://goo.gle/gmp-FeatureLayerIsAvailable。 |
isWebGLOverlayViewAvailable optional |
类型：
boolean optional如果为 true，则表示此地图已正确配置，允许使用 WebGLOverlayView。 |