Image overlays

MapType 接口

google.maps.MapType 接口

此接口定义了地图类型,通常用于自定义地图类型。固定不变。

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

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 图块的不透明度级别(0 [透明] 到 1.0)。
getTile
getTile(tileCoord, zoom, ownerDocument)
参数: 
  • tileCoordPoint图块坐标。
  • zoomnumber 平铺缩放。
  • ownerDocumentDocument 拥有相应图块的文档。
返回值:  Element|null 生成的图块。
releaseTile
releaseTile(tileDiv)
参数: 
  • tileDiv:要释放的 Element optional Tile。
返回值:无
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 将相同的 MapTypeStyler 应用于与之前的 MapTypeStyle 相同的选择器,则会替换之前的 MapTypeStyle

请注意,设置地图 ID 后,系统不支持 StyledMapType。如果同时使用这两个参数,您会收到控制台警告。
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 Tile。
返回值:无
继承自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
要在地图类型控件中显示的名称。