Image overlays

MapType 接口

google.maps.MapType 接口

此接口可定义地图类型，通常用于自定义地图类型。固定不变。
maxZoom
类型：number
显示此 MapType 时地图的最大缩放级别。对于基本 MapType，为必填项。而对于叠加层 MapType，则将其忽略。
minZoom
类型：number
显示此 MapType 时地图的最小缩放级别。可选；默认值为 0。
radius
类型：number
地图的行星半径（以米为单位）。可选；默认为地球的赤道半径（6378137 米）。
tileSize
类型：Size
每个图块的尺寸。必填。
alt optional
类型：string optional
当此 MapType 的按钮悬停在 MapTypeControl 中时显示的备选文本。可选。
name optional
类型：string optional
要在 MapTypeControl 中显示的名称。可选。
projection optional
类型：Projection optional
用于渲染此 MapType 的投影。可选；默认值为 Mercator。
getTile
getTile(tileCoord, zoom, ownerDocument)
参数：
  • tileCoord：Point 图块坐标。
  • zoom：number 图块缩放。
  • ownerDocument：Document 拥有此图块的文档。
返回值：Element|null 结果图块。
传回指定图块坐标 (x, y) 和缩放级别的图块。此图块将附加到指定的 ownerDocument。不适用于基本地图类型。
releaseTile
releaseTile(tile)
参数：
  • tile：要释放的 Element optional 图块。
返回值：None
释放指定图块，并执行全部所需的清理。已从文档中删除了提供的图块。可选。

Projection 接口

google.maps.Projection 接口

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
参数：
返回值：Point|null
从 LatLng 圆柱转换为 Point 平面。此接口会指定一个函数，该函数实现从指定 LatLng 值到地图投影上的世界坐标的转换。Google Maps API 在需要在屏幕上绘制位置时调用此方法。Projection 对象必须实现此方法，但如果投影无法计算 Point，则可能会返回 null。
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
参数：
  • pixel：Point
  • noClampNoWrap：boolean optional
返回值：LatLng|null
此接口指定一个函数，该函数实现从地图投影上的世界坐标到 LatLng 值的转换。Google Maps API 在需要将屏幕上的操作转换为地图上的位置时调用此方法。Projection 对象必须实现此方法，但如果投影无法计算 LatLng，则可能会返回 null。

ImageMapType 类

google.maps.ImageMapType 类

此类实现 MapType 接口并提供用于渲染图像图块。

此类扩展了 MVCObject。

此类实现 MapType。

通过调用 const {ImageMapType} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
ImageMapType
ImageMapType(opts)
参数：
使用提供的 ImageMapTypeOptions 构造 ImageMapType
alt
类型：string optional
maxZoom
类型：number
minZoom
类型：number
name
类型：string optional
projection
类型：Projection
radius
类型：number
tileSize
类型：Size
getOpacity
getOpacity()
参数：无
返回值：number opacity 当前的不透明度。
返回 ImageMapType 图块的不透明度级别（从 0 到 1.0）。
getTile
getTile(tileCoord, zoom, ownerDocument)
参数：
  • tileCoord：Point 图块坐标。
  • zoom：number 图块缩放。
  • ownerDocument：Document 拥有此图块的文档。
返回值：Element|null 结果图块。
releaseTile
releaseTile(tileDiv)
参数：
  • tileDiv：要释放的 Element optional 图块。
返回值：None
setOpacity
setOpacity(opacity)
参数：
  • opacity：number新的不透明度。
返回值：None
将 ImageMapType 图块的不透明度级别（0（透明）设为 1.0）。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
tilesloaded
function()
参数：None
可见图块载入完成后会触发此事件。

ImageMapTypeOptions 接口

google.maps.ImageMapTypeOptions 接口

此类用于创建可渲染图像图块的 MapType。
alt optional
类型：string optional
当此 MapType 的按钮悬停在 MapTypeControl 中时显示的备选文本。
getTileUrl optional
类型：function(Point, number): (string optional) optional
传回指定图块坐标 (x, y) 和缩放级别的字符串（网址）。
maxZoom optional
类型：number optional
显示此 MapType 时地图的最大缩放级别。
minZoom optional
类型：number optional
显示此 MapType 时地图的最小缩放级别。可选。
name optional
类型：string optional
要在 MapTypeControl 中显示的名称。
opacity optional
类型：number optional
应用到图块的不透明度。应将不透明度指定为介于 0 和 1.0 之间的浮动值，其中 0 表示完全透明，而 1 表示完全不透明。
tileSize optional
类型：Size optional
图块大小。

GroundOverlay 类

google.maps.GroundOverlay 类

地图上的矩形图像叠加层。

此类扩展了 MVCObject。

通过调用 const {GroundOverlay} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
GroundOverlay
GroundOverlay(url, bounds[, opts])
参数：
根据提供的图片网址及其 LatLngBounds 创建地面叠加层。图像会进行缩放以适应当前的范围，并使用当前的地图投影进行投影。
getBounds
getBounds()
参数：无
返回值：LatLngBounds
获取此叠加层的 LatLngBounds。
getMap
getMap()
参数：无
返回值：Map
传回在其上显示此地面叠加层的地图。
getOpacity
getOpacity()
参数：无
返回值：number
用于返回该地面叠加层的不透明度。
getUrl
getUrl()
参数：无
返回值：string
获取投影图象的网址。
setMap
setMap(map)
参数：
返回值：None
在指定地图上渲染此地面叠加层。如果地图设置为 null，则会移除叠加层。
setOpacity
setOpacity(opacity)
参数：
  • opacity：number
返回值：None
设置此地面叠加层的不透明度。
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
click
function(event)
参数：
对 GroundOverlay 触发 DOM 点击事件时会触发此事件。
dblclick
function(event)
参数：
对 GroundOverlay 触发 DOM dblclick 事件时会触发此事件。

GroundOverlayOptions 接口

google.maps.GroundOverlayOptions 接口

此对象定义了可在 GroundOverlay 对象上设置的属性。
clickable optional
类型：boolean optional
如果为 true，则地面叠加层可以接收鼠标事件。
map optional
类型：Map optional
要在其上显示叠加层的地图。
opacity optional
类型：number optional
默认值：1.0
叠加层的不透明度，以 0 到 1 之间的数字表示。可选。

StyledMapType 类

google.maps.StyledMapType 类

使用自定义样式创建 MapType。

此类扩展了 MVCObject。

此类实现 MapType。

通过调用 const {StyledMapType} = await google.maps.importLibrary("maps") 进行访问。请参阅 Maps JavaScript API 中的库。
StyledMapType
StyledMapType(styles[, options])
参数：
使用指定选项创建样式化 MapType。StyledMapType 接受一个 MapTypeStyle 数组，其中每个 MapTypeStyle 会连续应用到地图。如果后续 MapTypeStyle 与前一个 MapTypeStyle 将相同的 MapTypeStyler 应用于同一选择器，则会替换之前的 MapTypeStyle。
alt
类型：string
maxZoom
类型：number
minZoom
类型：number
name
类型：string
projection
类型：Projection
radius
类型：number
tileSize
类型：Size
getTile
getTile(tileCoord, zoom, ownerDocument)
参数：
  • tileCoord：Point 图块坐标。
  • zoom：number 图块缩放。
  • ownerDocument：Document 拥有此图块的文档。
返回值：Element|null 结果图块。
releaseTile
releaseTile(tile)
参数：
  • tile：要释放的 Element optional 图块。
返回值：None
继承的样式：addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

StyledMapTypeOptions 接口

google.maps.StyledMapTypeOptions 接口

此类用于在创建 StyledMapType 时指定选项。待 StyledMapType 实例化后，便无法更改这些选项。
alt optional
类型：string optional
当此 MapType 的按钮悬停在地图类型控件中时显示的文本。
maxZoom optional
类型：number optional
显示此 MapType 时地图的最大缩放级别。可选。
minZoom optional
类型：number optional
显示此 MapType 时地图的最小缩放级别。可选。
name optional
类型：string optional
要在地图类型控件中显示的名称。