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 不透明度 - 当前不透明度。
返回 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
在指定地图上渲染此地面叠加层。如果将 map 设置为 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 双击事件时，系统会触发此事件。

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。

请注意，设置地图 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 功能块。
返回值：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
要在地图类型控件中显示的名称。