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)
参数
  • tileCoordPoint 图块坐标。
  • zoomnumber 图块缩放。
  • ownerDocumentDocument 拥有此图块的文档。
返回值Element|null 生成的图块。
传回指定图块坐标 (x, y) 和缩放级别的图块。此图块将附加到指定的 ownerDocument。不适用于基本地图类型。
releaseTile
releaseTile(tile)
参数
  • tile:要释放的图块。Element optional
返回值:无
释放指定图块,并执行全部所需的清理。已从文档中删除了提供的图块。可选。

Projection 接口

google.maps.Projection接口

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
参数
返回值Point|null
从 LatLng 圆柱转换为 Point 平面。此接口指定一个函数,该函数实现从给定 LatLng 值到地图投影上的世界坐标的转换。Google Maps API 在需要在屏幕上绘制位置时调用此方法。Projection 对象必须实现此方法,但如果投影无法计算 Point,则可能会返回 null
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
参数
  • pixelPoint
  • noClampNoWrapboolean 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 不透明度 当前的不透明度。
返回 ImageMapType 图块的不透明度(从 01.0)。
getTile
getTile(tileCoord, zoom, ownerDocument)
参数
  • tileCoordPoint 图块坐标。
  • zoomnumber 图块缩放。
  • ownerDocumentDocument 拥有此图块的文档。
返回值Element|null 生成的图块。
releaseTile
releaseTile(tileDiv)
参数
  • tileDiv:要释放的图块。Element optional
返回值:无
setOpacity
setOpacity(opacity)
参数
  • opacitynumber 新的不透明度。
返回值:无
ImageMapType 图块的不透明度级别(0 (透明)设置为 1.0)。
继承的设置addListenerbindTogetnotifysetsetValuesunbindunbindAll
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)
参数
返回值:无
在指定地图上渲染此地面叠加层。如果地图设置为null,系统会移除叠加层。
setOpacity
setOpacity(opacity)
参数
  • opacitynumber
返回值:无
设置此地面叠加层的不透明度。
继承的设置addListenerbindTogetnotifysetsetValuesunbindunbindAll
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])
参数
使用指定选项创建带样式的 MapTypeStyledMapType 接受一个 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)
参数
  • tileCoordPoint 图块坐标。
  • zoomnumber 图块缩放。
  • ownerDocumentDocument 拥有此图块的文档。
返回值Element|null 生成的图块。
releaseTile
releaseTile(tile)
参数
  • tile:要释放的图块。Element optional
返回值:无
继承的设置addListenerbindTogetnotifysetsetValuesunbindunbindAll

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
要在地图类型控件中显示的名称。