Image overlays

MapType 介面

google.maps.MapType 介面

這個介面會定義地圖類型,通常用於自訂地圖類型。不可變更。

maxZoom
類型:  number
顯示這個 MapType 時地圖的最大縮放等級。在基礎 MapType 為必要,疊加層 MapType 則忽略。
minZoom
類型:  number
顯示這個 MapType 時地圖的最小縮放等級。選用,預設為 0。
radius
類型:  number
地圖上地球的半徑 (單位為公尺)。選用,預設為地球的赤道半徑 (6378137 公尺)。
tileSize
類型:  Size
每個方塊大小。這是必填欄位。
alt optional
類型:  string optional
在 MapTypeControl 中將滑鼠游標停留在這個 MapType 按鈕時,所顯示的 Alt 文字。選用。
name optional
類型:  string optional
在 MapTypeControl 中顯示的名稱。選用。
projection optional
類型:  Projection optional
用來呈現這個 MapType 的投影。選用,預設為麥卡托。
getTile
getTile(tileCoord, zoom, ownerDocument)
參數: 
  • tileCoordPoint圖塊座標。
  • zoomnumber圖塊縮放。
  • ownerDocumentDocument擁有這個圖塊的文件。
傳回值:  Element|null 產生的圖塊。
為指定的方塊座標 (x, y) 和縮放等級傳回一個方塊。這個圖塊會附加至指定的 OwnerDocument。不適用於基本地圖類型。
releaseTile
releaseTile(tile)
參數: 
  • tileElement optional 圖塊即可發布。
傳回值:
釋出指定的方塊,執行任何必要的清除作業。提供的方塊已從文件移除。選用。

Projection 介面

google.maps.Projection 介面

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
參數: 
傳回值:  Point|null
從 LatLng 圓柱轉譯為點平面。這個介面會指定一個函式,將指定的 LatLng 值轉譯為地圖投影上的世界座標。當 Google Maps API 需要在螢幕上繪製位置時,就會呼叫這個方法。Projection 物件必須實作這個方法,但如果投影無法計算 Point,則可能傳回 null
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
參數: 
  • pixelPoint
  • noClampNoWrapboolean optional
傳回值:  LatLng|null
這個介面會指定一個函式,將地圖投影中的世界座標轉譯為 LatLng 值。當 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)
參數: 
  • tileDivElement optional 圖塊即可發布。
傳回值:
setOpacity
setOpacity(opacity)
參數: 
  • opacitynumber新的不透明度。
傳回值:
ImageMapType 圖塊的不透明度等級 (0 (透明) 設為 1.0)。
沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll
tilesloaded
function()
引數:
所有可見的地圖方塊完成載入之後,就會引發這個事件。

ImageMapTypeOptions 介面

google.maps.ImageMapTypeOptions 介面

這個類別是用來製作呈現圖片方塊的 MapType。

alt optional
類型:  string optional
在 MapTypeControl 中將滑鼠游標停留在這個 MapType 按鈕時,所顯示的 Alt 文字。
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 click 事件時,會引發此事件。
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
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)
參數: 
  • tileElement 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
地圖類型控制項中顯示的名稱。