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)
参数： 
  • tileCoord：Point图块坐标。
  • zoom：number 平铺缩放。
  • ownerDocument：Document 拥有相应图块的文档。
返回值：  Element|null 生成的图块。
传回指定图块坐标 (x, y) 和缩放级别的图块。相应图块将附加到给定的 ownerDocument。不适用于基本地图类型。
releaseTile
releaseTile(tile)
参数： 
  • tile：要释放的 Element optional Tile。
返回值：  void
释放指定图块，并执行全部所需的清理。已从文档中删除了提供的图块。可选。

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 透明度 当前透明度。
返回 ImageMapType 图块的不透明度级别（0 [透明] 到 1.0）。
getTile
getTile(tileCoord, zoom, ownerDocument)
参数： 
  • tileCoord：Point图块坐标。
  • zoom：number 平铺缩放。
  • ownerDocument：Document 拥有相应图块的文档。
返回值：  Element|null 生成的图块。
releaseTile
releaseTile(tileDiv)
参数： 
  • tileDiv：要释放的 Element optional Tile。
返回值：无
setOpacity
setOpacity(opacity)
参数： 
  • opacity：number 新的不透明度。
返回值：无
设置 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)
参数： 
返回值：无
在指定地图上渲染此地面叠加层。如果将地图设置为 null，则会移除叠加层。
setOpacity
setOpacity(opacity)
参数： 
  • opacity：number
返回值：无
设置相应地面叠加层的不透明度。
继承自： 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 将相同的 MapTypeStyler 应用于与之前的 MapTypeStyle 相同的选择器，则会替换之前的 MapTypeStyle。

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