Maps

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，可通过 MapElement.innerMap 属性访问。

自定义元素：
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" 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 属性：
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
类型：  boolean optional
默认值： false
地图是否应允许用户控制相机朝向（旋转）。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
HTML 属性：
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
类型：  Map
对 MapElement 在内部使用的 Map 的引用。
internalUsageAttributionIds
类型：  Iterable<string> optional
默认值： null
向初始化程序添加了使用情况归因 ID，这有助于 Google 了解哪些库和示例对开发者有帮助，例如标记聚类库的使用情况。如需选择不发送使用情况归因 ID，可以安全地删除此属性或将该值替换为空字符串。系统只会发送唯一值。实例化后对此值所做的更改可能会被忽略。
HTML 属性：
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
类型：  string optional
地图的地图 ID。实例化地图后，无法设置或更改此参数。Map.DEMO_MAP_ID 可用于试用需要地图 ID 但不需要启用云的功能。
HTML 属性：
  • <gmp-map map-id="string"></gmp-map>
renderingType
类型：  RenderingType optional
默认值： RenderingType.VECTOR
地图应为光栅地图还是矢量地图。实例化地图后，无法设置或更改此参数。如果未设置，则地图 ID 的云配置将确定渲染类型（如果可用）。请注意，矢量地图可能不适用于所有设备和浏览器，并且地图会根据需要回退为光栅地图。
HTML 属性：
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
类型：  boolean optional
默认值： false
地图是否应允许用户控制相机倾斜度。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
HTML 属性：
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
类型：  number optional
地图的缩放级别。有效的缩放值是介于 0 到支持的最大缩放级别之间的数字。缩放值越大，分辨率越高。
HTML 属性：
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
将带 slot 的元素放置在 ControlPosition.BLOCK_END_INLINE_CENTER 位置。
control-block-end-inline-end
将带 slot 的元素放置在 ControlPosition.BLOCK_END_INLINE_END 位置。
control-block-end-inline-start
将带 slot 的元素放置在 ControlPosition.BLOCK_END_INLINE_START 位置。
control-block-start-inline-center
将带 slot 的元素放置在 ControlPosition.BLOCK_START_INLINE_CENTER 位置。
control-block-start-inline-end
将带 slot 的元素放置在 ControlPosition.BLOCK_START_INLINE_END 位置。
control-block-start-inline-start
将带 slot 的元素放置在 ControlPosition.BLOCK_START_INLINE_START 位置。
control-inline-end-block-center
将带 slot 的元素放置在 ControlPosition.INLINE_END_BLOCK_CENTER 位置。
control-inline-end-block-end
将带 slot 的元素放置在 ControlPosition.INLINE_END_BLOCK_END 位置。
control-inline-end-block-start
将带 slot 的元素放置在 ControlPosition.INLINE_END_BLOCK_START 位置。
control-inline-start-block-center
将带 slot 的元素放置在 ControlPosition.INLINE_START_BLOCK_CENTER 位置。
control-inline-start-block-end
将带 slot 的元素放置在 ControlPosition.INLINE_START_BLOCK_END 位置。
control-inline-start-block-start
将带 slot 的元素放置在 ControlPosition.INLINE_START_BLOCK_START 位置。
default
您可以使用自定义元素围绕 Maps JavaScript Web 组件（例如 AdvancedMarkerElement）创建可重复使用的组件。默认情况下，直接添加到 MapElement 的任何自定义元素都将插入到 MapPanes.overlayMouseTarget 中并在此处呈现。不过，Maps JavaScript API Web 组件可能会重新插入到 MapElement 的内部 slot 中。
addEventListener
addEventListener(type, listener[, options])
参数： 
  • type：string一个区分大小写的字符串，表示要监听的事件类型。
  • listener：EventListener|EventListenerObject 接收通知的对象。必须是函数或具有 handleEvent 方法的对象
  • options：boolean|AddEventListenerOptions optional 请参阅选项。自定义事件仅支持 capture 和 passive。
返回值：  void
设置一个函数，每当指定事件传递到目标时，系统都会调用该函数。请参阅 addEventListener。
removeEventListener
removeEventListener(type, listener[, options])
参数： 
返回值：  void
从目标中移除之前通过 addEventListener 注册的事件监听器。请参阅 removeEventListener。
gmp-zoomchange
function(event)
实参： 
当地图缩放属性更改时会触发此事件。

MapElementOptions 接口

google.maps.MapElementOptions 接口

用于定义可在 MapElement 上设置的属性的 MapElementOptions 对象。
center optional
类型：  LatLng|LatLngLiteral optional
请参阅 MapElement.center。
headingInteractionDisabled optional
类型：  boolean optional
请参阅 MapElement.headingInteractionDisabled。
internalUsageAttributionIds optional
类型：  Iterable<string> optional
请参阅 MapElement.internalUsageAttributionIds。
mapId optional
类型：  string optional
请参阅 MapElement.mapId。
renderingType optional
类型：  RenderingType optional
请参阅 MapElement.renderingType。
tiltInteractionDisabled optional
类型：  boolean optional
请参阅 MapElement.tiltInteractionDisabled。
zoom optional
类型：  number optional
请参阅 MapElement.zoom。

ZoomChangeEvent 类

google.maps.ZoomChangeEvent 类

此事件是从监控缩放更改创建的。

此类扩展了 Event。

通过调用 const {ZoomChangeEvent} = await google.maps.importLibrary("maps") 进行访问。
请参阅 Maps JavaScript API 中的库。

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
类型：  MapTypeRegistry
按字符串 ID 注册的 MapType 实例。
overlayMapTypes
类型：  MVCArray<MapType optional>
要叠加的其他地图类型。叠加层地图类型将按照在 overlayMapTypes 数组中出现的顺序，在其附加到的基本地图上叠加显示（叠加层的索引值越高，显示位置就越靠前）。
fitBounds
fitBounds(bounds[, padding])
参数： 
  • bounds：要显示的LatLngBounds|LatLngBoundsLiteral边界。
  • padding：number|Padding optional 内边距（以像素为单位）。边界将适合移除内边距后剩余的地图部分。如果提供的是数值，则所有 4 个边的内边距都相同。在此处提供 0，以使 fitBounds 在 getBounds 的结果上具有幂等性。
返回值：无
用于设置视口，使其包含指定边界。
注意：当地图设置为 display: none 时，fitBounds 函数会将地图的大小读取为 0x0，因此不会执行任何操作。如需在地图处于隐藏状态时更改视口，请将地图设置为 visibility: hidden，从而确保地图 div 具有实际大小。对于矢量地图，此方法会将地图的倾斜度和航向设置为默认的零值。调用此方法可能会导致地图平移和缩放以适应边界，从而产生流畅的动画效果。此方法是否会进行动画处理取决于内部启发式方法。
getBounds
getBounds()
参数：无
返回值：  LatLngBounds|undefined 当前视口的纬度和经度范围。
用于返回当前视口的纬度/经度范围。如果显示了多个世界副本，则经度范围为 -180 到 180 度（含）。如果地图尚未初始化或尚未设置中心和缩放级别，则结果为 undefined。对于倾斜度或航向不为零的矢量地图，返回的纬度/经度边界表示包含地图视口可见区域的最小边界框。如需获取地图视口的精确可见区域，请参阅 MapCanvasProjection.getVisibleRegion。
getCenter
getCenter()
参数：无
返回值：  LatLng|undefined
返回显示在地图中心的地理位置。请注意，此 LatLng 对象未封装。如需了解详情，请参阅 LatLng。如果未设置中心或边界，则结果为 undefined。
getClickableIcons
getClickableIcons()
参数：无
返回值：  boolean|undefined
返回地图图标的可点击性。地图图标表示地图注点 (POI)。如果返回的值为 true，则地图上的图标可点击。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
参数： 
  • datasetId：string
返回值：  FeatureLayer
返回指定 datasetId 的 FeatureLayer。必须在 Google Cloud 控制台中配置数据集 ID。如果数据集 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 的云配置（如果有）。
getInternalUsageAttributionIds
getInternalUsageAttributionIds()
参数：无
返回值：  Iterable<string>|null
返回使用情况归因 ID 的列表，这些 ID 可帮助 Google 了解哪些库和示例对开发者有帮助，例如标记聚类库的使用情况。
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，该 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)
参数： 
返回值：无
立即将地图的相机设置为目标相机选项，不使用动画。
panBy
panBy(x, y)
参数： 
  • x：number 在 x 方向上移动地图的像素数。
  • y：number 在 y 方向上移动地图的像素数。
返回值：无
将地图中心移动一段指定的距离（以像素为单位）。如果这段距离既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。请注意，地图坐标系的 x 值从西向东增加，y 值从北向南增加。
panTo
panTo(latLng)
参数： 
返回值：无
将地图的中心更改为给定的 LatLng。如果更改幅度既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。
panToBounds
panToBounds(latLngBounds[, padding])
参数： 
  • latLngBounds：LatLngBounds|LatLngBoundsLiteral 要平移到的地图边界。
  • padding：number|Padding optional 内边距（以像素为单位）。如果提供的是数值，则所有 4 个边的内边距都相同。默认值为 0。
返回值：无
平移地图，使地图包含给定的 LatLngBounds，平移的幅度为所需的最小值。它不保证边界在地图上的位置，但会平移地图，以便在 {currentMapSizeInPx} - {padding} 内尽可能多地显示边界。对于光栅地图和矢量地图，地图的缩放、倾斜度和方向都不会改变。
setCenter
setCenter(latlng)
参数： 
返回值：无
setClickableIcons
setClickableIcons(value)
参数： 
  • value：boolean
返回值：无
控制地图图标是否可点击。地图图标表示地图注点 (POI)。如需停用地图图标的可点击性，请向此方法传递值 false。
setHeading
setHeading(heading)
参数： 
  • heading：number
返回值：无
设置地图的罗盘航向，以相对于正北方的角度（以度为单位）来表示。对于栅格地图，此方法仅适用于航空影像。
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
参数： 
  • headingInteractionEnabled：boolean
返回值：无
设置是否启用标题互动。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
setMapTypeId
setMapTypeId(mapTypeId)
参数： 
返回值：无
setOptions
setOptions(options)
参数： 
返回值：无
setRenderingType
setRenderingType(renderingType)
参数： 
返回值：无
设置地图的当前 RenderingType。
setStreetView
setStreetView(panorama)
参数： 
返回值：无
将 StreetViewPanorama 绑定到地图。此全景会替换默认的 StreetViewPanorama，从而允许地图绑定到地图外部的外部全景。将全景设置为 null 会将默认嵌入式全景重新绑定到地图。
setTilt
setTilt(tilt)
参数： 
  • tilt：number
返回值：无
对于矢量地图，设置地图的入射角。允许的值会根据地图的缩放级别受到限制。

对于光栅地图，控制地图入射角的自动切换行为。唯一允许的值是 0 和 45。setTilt(0) 会使地图始终使用 0° 俯视图，无论缩放级别和视口如何。setTilt(45) 会导致倾斜角度在当前缩放级别和视口有 45° 角航拍图像时自动切换到 45，在没有 45° 角航拍图像时切换回 0（这是默认行为）。45° 角航拍图像仅适用于 satellite 和 hybrid 地图类型，且仅在部分位置和部分缩放级别下提供。注意： getTilt 返回的是当前倾斜角度，而不是由 setTilt 设置的值。由于 getTilt 和 setTilt 指的是不同的事物，因此请勿对 tilt 属性进行 bind()；这样做可能会产生不可预测的影响。
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
参数： 
  • tiltInteractionEnabled：boolean
返回值：无
设置是否启用倾斜互动。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
setZoom
setZoom(zoom)
参数： 
  • zoom：number 缩放值越大，分辨率越高。
返回值：无
设置地图的缩放级别。
继承自： 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
当用户停止拖动地图时触发此事件。注意：当用户使用键盘停止平移地图时，不会触发 dragend。请改用 Map.idle 事件来确定用户何时停止平移或拖动地图。
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
当 renderingType 发生变化时，系统会触发此事件。
tilesloaded
function()
参数：None
可见图块载入完成后会触发此事件。
tilt_changed
function()
参数：None
当地图倾斜属性更改时会触发此事件。
zoom_changed
function()
参数：None
当地图缩放属性更改时会触发此事件。
rightclick
function(event)
实参： 
当用户在地图上点击鼠标右键时，系统会触发此事件。

MapOptions 接口

google.maps.MapOptions 接口

用于定义可在地图上设置的属性的 MapOptions 对象。
backgroundColor optional
类型：  string optional
用于地图 div 背景的颜色。在用户平移地图时，如果图块尚未完成加载，则会显示此颜色。仅在启动地图时，才能设置此选项。
cameraControl optional
类型：  boolean optional
摄像头控件的启用/停用状态。
cameraControlOptions optional
类型：  CameraControlOptions optional
相机控件的显示选项。
center optional
类型：  LatLng|LatLngLiteral optional
初始的地图中心。
clickableIcons optional
类型：  boolean optional
默认值： true
当值为 false 时，地图图标不可点击。地图图标表示地图注点 (POI)。
colorScheme optional
类型：  ColorScheme|string optional
默认值： ColorScheme.LIGHT
初始地图配色方案。仅在启动地图时，才能设置此选项。
controlSize optional
类型：  number optional
地图上显示的控件的大小（以像素为单位）。创建地图时必须直接提供此值，稍后更新此值可能会使控件进入 undefined 状态。仅控制由 Maps API 本身创建的控件。不会缩放开发者创建的自定义控件。
disableDefaultUI optional
类型：  boolean optional
启用/停用所有默认界面按钮。可以单独替换。不会停用键盘控件，键盘控件由 MapOptions.keyboardShortcuts 选项单独控制。不会停用手势控制，手势控制由 MapOptions.gestureHandling 选项单独控制。
disableDoubleClickZoom optional
类型：  boolean optional
启用/停用在双击时缩放并居中。默认处于启用状态。

注意：不建议使用此属性。如需停用双击缩放功能，您可以使用 gestureHandling 属性，并将其设置为 "none"。
draggable 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 如何处理地图上的手势。允许的值：
  • "cooperative"：滚动事件和单指触摸手势会滚动网页，而不会缩放或平移地图。双指触摸手势可平移和缩放地图。按住 Ctrl 键或 ⌘ 键滚动鼠标滚轮可缩放地图。
    在此模式下，地图会与网页协同工作。
  • "greedy"：所有触摸手势和滚动事件都会平移或缩放地图。
  • "none"：用户无法通过手势平移或缩放地图。
  • "auto"：（默认）手势处理是协作式还是贪婪式，具体取决于网页是否可滚动或是否位于 iframe 中。
heading optional
类型：  number optional
航拍图像的方向值按顺时针方向计算（以度为单位），基本方向为北方。方向会与可以查看到图像的距离最近的可用角度相对齐。
headingInteractionEnabled optional
类型：  boolean optional
默认值： false
地图是否应允许用户控制相机朝向（旋转）。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
internalUsageAttributionIds optional
类型：  Iterable<string> optional
默认值： null
向初始化程序添加了使用情况归因 ID，这有助于 Google 了解哪些库和示例对开发者有帮助，例如标记聚类库的使用情况。如需选择不发送使用情况归因 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
初始 Map 的 mapTypeId。默认为 ROADMAP。
maxZoom optional
类型：  number optional
将会在地图上显示的最大缩放级别。如果省略此参数或将其设置为 null，则系统会改用当前地图类型的最大缩放级别。有效的缩放值是介于 0 到支持的最大缩放级别之间的数字。
minZoom optional
类型：  number optional
将会在地图上显示的最小缩放级别。如果省略此参数或将其设置为 null，则改用当前地图类型的最小缩放级别。有效的缩放值是介于 0 到支持的最大缩放级别之间的数字。
noClear optional
类型：  boolean optional
如果为 true，则不清除 Map div 的内容。
panControl optional
类型：  boolean optional
平移控件的启用/停用状态。
panControlOptions optional
类型：  PanControlOptions optional
平移控件的显示选项。
renderingType optional
类型：  RenderingType optional
默认值： RenderingType.RASTER
地图应为光栅地图还是矢量地图。实例化地图后，无法设置或更改此参数。如果未设置，则地图 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，则禁止使用鼠标滚轮缩放地图。滚轮默认处于启用状态。

注意：不建议使用此属性。如需停用使用滚轮进行的缩放，您可以使用 gestureHandling 属性，并将其设置为 "cooperative" 或 "none"。
streetView optional
类型：  StreetViewPanorama optional
当街景小人放置在地图上时显示的 StreetViewPanorama。如果未指定全景图，则在放置 Pegman 时，地图的 div 中会显示默认的 StreetViewPanorama。
streetViewControl optional
类型：  boolean optional
街景小人控件的初始启用/停用状态。此控件是默认界面的一部分，在显示不应显示街景道路叠加层的地图类型（例如非地球地图类型）时，应将其设置为 false。
streetViewControlOptions optional
类型：  StreetViewControlOptions optional
Street View 街景小人控件的初始显示选项。
styles optional
类型：  Array<MapTypeStyle> optional
要应用于每种默认地图类型的样式。请注意，对于 satellite/hybrid 和 terrain 模式，这些样式仅适用于标签和几何图形。使用地图 ID 或矢量地图时，此功能不可用（请改用云端地图样式设置）。
tilt optional
类型：  number optional
对于矢量地图，设置地图的入射角。允许的值会根据地图的缩放级别受到限制。对于光栅地图，控制地图入射角的自动切换行为。唯一允许的值是 0 和 45。值 0 会使地图始终使用 0° 俯视图，无论缩放级别和视口如何。值 45 会导致倾斜角度在以下情况下自动切换到 45：当前缩放级别和视口有 45° 角航拍图像可用；在以下情况下自动切换回 0：没有 45° 角航拍图像可用（这是默认行为）。45° 角航拍图像仅适用于 satellite 和 hybrid 地图类型，且仅在部分位置和部分缩放级别下提供。注意： getTilt 返回的是当前倾斜角度，而不是此选项指定的值。由于 getTilt 和此选项指的是不同的内容，因此请勿 bind() tilt 属性；这样做可能会产生不可预测的效果。
tiltInteractionEnabled optional
类型：  boolean optional
默认值： false
地图是否应允许用户控制相机倾斜度。此选项仅在地图为矢量地图时有效。如果未在代码中设置，则使用地图 ID 的云配置（如果有）。
zoom optional
类型：  number optional
初始地图缩放级别。有效的缩放值是介于 0 到支持的最大缩放级别之间的数字。缩放值越大，分辨率越高。
zoomControl optional
类型：  boolean optional
缩放控件的启用/停用状态。
zoomControlOptions optional
类型：  ZoomControlOptions optional
缩放控件的显示选项。

MapTypeStyle 接口

google.maps.MapTypeStyle 接口

MapTypeStyle 是选择器和样式器的集合，用于定义地图的样式设置方式。选择器用于指定应受影响的地图项和/或元素，而样式器用于指定应如何修改这些地图项和元素。如需了解详情，请参阅样式参考文档。
stylers
类型：  Array<Object>
要应用于所选地图项和元素的样式规则。系统会按照您在此数组中指定的顺序应用规则。如需了解使用指南和允许的值，请参阅样式参考。
elementType optional
类型：  string optional
应应用样式的元素。元素是地图上地图项的视觉方面。例如，标签、图标、应用于几何图形的描边或填充等等。可选。如果未指定 elementType，系统会假定该值为 'all'。如需详细了解用法和允许的值，请参阅样式参考。
featureType optional
类型：  string optional
应应用样式的地图项或地图项组。可选。如果未指定 featureType，系统会假定该值为 'all'。如需详细了解用法和允许的值，请参阅样式参考。

MapMouseEvent 接口

google.maps.MapMouseEvent 接口

此对象由地图和叠加层上的各种鼠标事件返回，包含如下所示的所有字段。
domEvent
对应的原生 DOM 事件。开发者不应依赖于 target、currentTarget、relatedTarget 和 path 属性的定义和一致性。开发者也不应依赖 Maps API 内部实现的 DOM 结构。由于内部事件映射，domEvent 可能与 MapMouseEvent 具有不同的语义（例如，MapMouseEvent“点击”可能具有 KeyboardEvent 类型的 domEvent）。
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

ColorScheme 常量

google.maps.ColorScheme 常量

地图配色方案的标识符。您可以通过值或使用常量的名称来指定这些参数。例如，'FOLLOW_SYSTEM' 或 google.maps.ColorScheme.FOLLOW_SYSTEM。

通过调用 const {ColorScheme} = await google.maps.importLibrary("core") 进行访问。
请参阅 Maps JavaScript API 中的库。
DARK 地图的深色配色方案。
FOLLOW_SYSTEM 颜色方案是根据系统偏好设置选择的，系统偏好设置会在方法执行时检查一次。
LIGHT 地图的浅色主题。旧版 Maps JavaScript 的默认值。

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)
参数： 
  • id：string 要添加到注册表中的 MapType 的标识符。
  • mapType：要添加到注册表中的 MapType 对象。MapType|?
返回值：无
设置注册表以将传递的字符串标识符与传递的 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|null
传回在其上显示此图层的地图。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：无
在指定地图上渲染此图层。如果将地图设置为 null，则会移除相应图层。
setOptions
setOptions(options)
参数： 
返回值：无
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

TrafficLayerOptions 接口

google.maps.TrafficLayerOptions 接口

用于定义可在 TrafficLayer 上设置的属性的 TrafficLayerOptions 对象。
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|null
传回在其上显示此图层的地图。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：  void
在指定地图上渲染此图层。如果将地图设置为 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|null
传回在其上显示此图层的地图。
setMap
setMap(map)
参数： 
  • map：Map optional
返回值：  void
在指定地图上渲染此图层。如果将地图设置为 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。