Maps

MapElement 类

class google.maps.MapElement extends HTMLElement implements MapElementOptions
library "maps"

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>

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>

const {MapElement} = await google.maps.importLibrary("maps");

MapElementOptions 接口

接口 google.maps.MapElementOptions
由 MapElement 实现

MapElementOptions 对象，用于定义可在 MapElement 上设置的属性。

ZoomChangeEvent 类

class google.maps.ZoomChangeEvent extends Event
library "maps"

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

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

Map 类

class google.maps.Map extends MVCObject
library "maps"

const {Map} = await google.maps.importLibrary("maps");

方法
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，则图标在地图上可点击。
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) 参数： datasetId: string 返回值：FeatureLayer 返回指定 datasetId 的 FeatureLayer。数据集 ID 必须在 Google Cloud 控制台中配置。如果数据集 ID 未与地图的地图样式相关联，或者数据驱动型样式不可用（地图样式中未配置地图 ID、矢量图块、数据驱动型样式地图项图层或数据集），则会记录错误，并且生成的 FeatureLayer.isAvailable 将为 false。
getDiv	getDiv() 参数：无 返回值： HTMLElement地图的 mapDiv。
getFeatureLayer	getFeatureLayer(featureType) 参数： featureType: 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，这可能是嵌入在地图中的默认全景图片，也可能是使用 setStreetView() 设置的全景图片。对地图的 streetViewControl 所做的更改将反映在此类绑定全景图片的显示中。
getTilt	getTilt() 参数：无 返回值：number|undefined 返回地图的当前倾斜角度，即视口平面与地图平面之间的夹角（以度为单位）。对于光栅地图，如果图像是直接从上方拍摄的，则结果为 0；如果是 45° 角航拍图像，则结果为 45。此方法不会返回由 setTilt 设置的值。如需了解详情，请参阅 setTilt。
getTiltInteractionEnabled	getTiltInteractionEnabled() 参数：无 返回值：boolean|null 返回是否已启用倾斜互动。此选项仅在地图为矢量地图时生效。如果未在代码中设置，则系统将使用地图 ID 的云配置（如果有）。
getZoom	getZoom() 参数：无 返回值：number|undefined 返回地图的缩放级别。如果未设置缩放级别，则结果为 undefined。
moveCamera	moveCamera(cameraOptions) 参数： cameraOptions: CameraOptions 返回值：无 立即将地图的镜头设置为目标镜头选项，不使用动画。
panBy	panBy(x, y) 参数： x: number 地图在 x 方向上移动的像素数。 y: number 地图在 y 方向上移动的像素数。 返回值：无 将地图中心移动一段指定的距离（以像素为单位）。如果这段距离既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。请注意，地图坐标系的 x 值从西向东增加，y 值从北向南增加。
panTo	panTo(latLng) 参数： latLng: LatLng|LatLngLiteral 地图的新中心纬度/经度。 返回值：无 将地图中心更改为给定的 LatLng。如果更改幅度既小于地图的宽度，又小于地图的高度，那么移动的动画效果将会十分流畅。
panToBounds	panToBounds(latLngBounds[, padding]) 参数： latLngBounds: LatLngBounds|LatLngBoundsLiteral 地图要平移到的边界。 padding: number|Padding optional内边距（以像素为单位）。一个数字值将在所有 4 个边上产生相同的内边距。默认值为 0。 返回值：无 以包含给定 LatLngBounds 所需的最小量平移地图。它不保证边界在地图上的位置，但会平移地图，以在 {currentMapSizeInPx} - {padding} 内尽可能多地显示边界。对于光栅地图和矢量地图，地图的缩放、倾斜和方向都不会改变。
setCenter	setCenter(latlng) 参数： latlng: LatLng|LatLngLiteral 返回值：无
setClickableIcons	setClickableIcons(value) 参数： value: boolean 返回值：无 控制地图图标是否可点击。地图图标代表地图注点（也称为 POI）。如需停用地图图标的可点击性，请向此方法传递 false 值。
setHeading	setHeading(heading) 参数： heading: number 返回值：无 设置地图的罗盘航向角，以相对于正北方的角度来表示。对于光栅地图，此方法仅适用于航拍图像。
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) 参数： headingInteractionEnabled: boolean 返回值：无 设置是否启用标题互动。此选项仅在地图为矢量地图时生效。如果未在代码中设置，则系统将使用地图 ID 的云配置（如果有）。
setMapTypeId	setMapTypeId(mapTypeId) 参数： mapTypeId: MapTypeId|string 返回值：无
setOptions	setOptions(options) 参数： options: MapOptions optional 返回值：无
setRenderingType	setRenderingType(renderingType) 参数： renderingType: RenderingType 返回值：无 设置地图的当前 RenderingType。
setStreetView	setStreetView(panorama) 参数： panorama: StreetViewPanorama optional 要绑定到地图的全景图片。 返回值：无 将 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 指代不同的内容，因此请勿 bind() tilt 属性；否则可能会产生不可预测的影响。
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) 参数： tiltInteractionEnabled: boolean 返回值：无 设置是否启用倾斜互动。此选项仅在地图为矢量地图时生效。如果未在代码中设置，则系统将使用地图 ID 的云配置（如果有）。
setZoom	setZoom(zoom) 参数： zoom: number缩放值越大，分辨率越高。 返回值：无 设置地图的缩放级别。
继承的方法： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

MapOptions 接口

接口 google.maps.MapOptions

MapOptions 对象，用于定义可在地图上设置的属性。

MapTypeStyle 接口

接口 google.maps.MapTypeStyle

MapTypeStyle 是选择器和样式器的集合，用于定义应如何设置地图样式。选择器指定应受影响的地图项和/或元素，而样式器指定应如何修改这些地图项和元素。如需了解详情，请参阅样式参考文档。

MapMouseEvent 接口

接口 google.maps.MapMouseEvent
由 Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent 扩展

此对象由地图和叠加层上的各种鼠标事件返回，包含如下所示的所有字段。

IconMouseEvent 接口

interface google.maps.IconMouseEvent extends MapMouseEvent

当用户点击地图上的图标时，系统会在事件中发送此对象。此地点的地点 ID 存储在 placeId 成员中。如需阻止默认信息窗口显示，请对此事件调用 stop() 方法，以防止其传播。如需详细了解地点 ID，请参阅 Places API 开发者指南。

ColorScheme 常量

常量 google.maps.ColorScheme
库 "core"

地图配色方案的标识符。按值或使用常量名称指定这些值。例如，'FOLLOW_SYSTEM' 或 google.maps.ColorScheme.FOLLOW_SYSTEM。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 ColorSchemeString 类型定义。

const {ColorScheme} = await google.maps.importLibrary("core");

MapTypeId 常量

常量 google.maps.MapTypeId
库 "maps"

常见 MapType 的标识符。按值或使用常量名称指定这些值。例如，'satellite' 或 google.maps.MapTypeId.SATELLITE。

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 MapTypeIdString 类型定义。

const {MapTypeId} = await google.maps.importLibrary("maps");

MapTypeRegistry 类

class google.maps.MapTypeRegistry extends MVCObject
library "maps"

MapType 实例的注册表，以 MapType ID 为键。

const {MapTypeRegistry} = await google.maps.importLibrary("maps");

MapRestriction 接口

接口 google.maps.MapRestriction

可应用于地图的限制。地图的视口不会超出这些限制。

TrafficLayer 类

class google.maps.TrafficLayer extends MVCObject
library "maps"

路况图层。

const {TrafficLayer} = await google.maps.importLibrary("maps");

TrafficLayerOptions 接口

接口 google.maps.TrafficLayerOptions

TrafficLayerOptions 对象，用于定义可在 TrafficLayer 上设置的属性。

TransitLayer 类

class google.maps.TransitLayer extends MVCObject
library "maps"

公交图层。

const {TransitLayer} = await google.maps.importLibrary("maps");

BicyclingLayer 类

class google.maps.BicyclingLayer extends MVCObject
library "maps"

显示自行车道和路径的图层。

const {BicyclingLayer} = await google.maps.importLibrary("maps");

CameraOptions 接口

接口 google.maps.CameraOptions
由 CameraParams 扩展

用于设置地图的相机选项。

VisibleRegion 接口

接口 google.maps.VisibleRegion

包含四个点，用于定义作为地图可见区域的四边形。在矢量地图上，如果矢量地图具有倾斜度，则此多边形可以是梯形，而不是矩形。

RenderingType 常量

常量 google.maps.RenderingType
库 "maps"

这些常量也可以用作字符串。在 TypeScript 中，字符串字面量由 RenderingTypeString 类型定义。

const {RenderingType} = await google.maps.importLibrary("maps");

MapCapabilities 接口

接口 google.maps.MapCapabilities

包含地图当前可用功能快照的对象。请注意，这并不一定意味着相关模块已加载或初始化，而是表示当前地图有权使用这些 API。如需查看可能的功能列表，请参阅属性。