映射 类别
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 |
按字符串 ID 划分的 MapType 实例的注册表。 |
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 指的是不同的对象,因此请不要 bind() 属性 tilt ,这样做可能会产生不可预知的影响。 |
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 包含地点 ID 字段外,IconMouseEvent 和 MapMouseEvent 完全相同。当地点 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 ,地图图标不可点击。地图图标表示感兴趣的地点,也称为地图注点。 |
|
类型:
ColorScheme|string optional 初始地图配色方案。仅在启动地图时,才能设置此选项。 |
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 ,则改用当前地图类型的最大缩放级别。有效缩放值是指从零到支持的最大缩放级别之间的数字。 |
minZoom optional |
类型:
number optional 将会在地图上显示的最小缩放级别。如果省略或设置为 null ,则改用当前地图类型的最小缩放级别。有效缩放值是指从零到支持的最大缩放级别之间的数字。 |
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 。如果未指定全景图片,则拖动街景小人时,地图的 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,并在没有 45° 图像时切换回 0(这是默认行为)。45° 角航拍图像仅适用于某些位置和采用某些缩放级别的 satellite 和 hybrid 地图类型。注意:getTilt 会返回当前的倾斜角度,而不是此选项指定的值。由于 getTilt 和此选项所指的内容不同,因此请勿对 tilt 属性执行 bind() 操作;这样做可能会产生不可预知的影响。 |
tiltInteractionEnabled optional |
类型:
boolean optional 默认值:
false 地图是否应允许用户控制镜头倾斜度。此选项仅在地图为矢量地图时有效。如果在代码中未设置,系统将使用地图 ID 的云配置(如果有)。 |
zoom optional |
类型:
number optional 初始地图缩放级别。有效缩放值是指从零到支持的最大缩放级别之间的数字。缩放值越大,分辨率越高。 |
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 地图的缩放级别。有效缩放值是指从零到支持的最大缩放级别之间的数字。缩放值越大,分辨率越高。
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 请参阅 MapElement.center 。 |
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 属性。开发者不应依赖 Google 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 JS 的默认值。 |
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 。 |