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) 參數：  tileCoord：Point 圖塊座標。 zoom：number 圖塊縮放。 ownerDocument：Document 擁有此圖塊的文件。 傳回值：  Element|null 產生的資訊方塊。 為指定的方塊座標 (x, y) 和縮放等級傳回一個方塊。這個圖塊會附加至指定的 ownerDocument。不適用於基本地圖類型。
releaseTile	releaseTile(tile) 參數：  tile：要釋出的 Element optional 資訊方塊。 傳回值：無 釋出指定的方塊，執行任何必要的清除作業。提供的方塊已從文件移除。選填。

投影介面

google.maps.Projection 介面

方法
fromLatLngToPoint	fromLatLngToPoint(latLng[, point]) 參數：  latLng：LatLng|LatLngLiteral point：Point optional 傳回值：  Point|null 從 LatLng 圓柱轉譯為點平面。這個介面會指定函式，實作從指定 LatLng 值到地圖投影的世界座標的轉譯。當 Google Maps API 需要在螢幕上繪製位置時，就會呼叫這個方法。Projection 物件必須實作此方法，但如果投影無法計算 Point，則可能會傳回 null。
fromPointToLatLng	fromPointToLatLng(pixel[, noClampNoWrap]) 參數：  pixel：Point noClampNoWrap：boolean optional 傳回值：  LatLng|null 這個介面會指定函式，實作從地圖投影的世界座標轉換為 LatLng 值的轉譯作業。當 Maps API 需要將螢幕上的動作轉譯為地圖上的位置時，就會呼叫這個方法。Projection 物件必須實作此方法，但如果投影無法計算 LatLng，則可能會傳回 null。

ImageMapType 類別

google.maps.ImageMapType class

這個類別會實作 MapType 介面，並能用來呈現圖片方塊。

這個類別會擴充 MVCObject。

這個類別會實作 MapType。

請呼叫 const {ImageMapType} = await google.maps.importLibrary("maps") 存取。請參閱「Maps JavaScript API 中的程式庫」。

建構函式
ImageMapType	ImageMapType(opts) 參數：  opts：ImageMapTypeOptions 使用提供的 ImageMapTypeOptions 建構 ImageMapType

屬性
alt	類型：  string optional
maxZoom	類型：  number
minZoom	類型：  number
name	類型：  string optional
projection	類型：  Projection
radius	類型：  number
tileSize	類型：  Size

方法
getOpacity	getOpacity() 參數：無 傳回值：  number opacity 目前的不透明度。 傳回 ImageMapType 圖塊的不透明度等級 (0 (透明) 到 1.0)。
getTile	getTile(tileCoord, zoom, ownerDocument) 參數：  tileCoord：Point 圖塊座標。 zoom：number 圖塊縮放。 ownerDocument：Document 擁有此圖塊的文件。 傳回值：  Element|null 產生的資訊方塊。
releaseTile	releaseTile(tileDiv) 參數：  tileDiv：要釋出的 Element optional 資訊方塊。 傳回值：無
setOpacity	setOpacity(opacity) 參數：  opacity：number 新的不透明度。 傳回值：無 設定 ImageMapType 圖塊的不透明度 (0 (透明) 到 1.0)。
繼承： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活動
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 class

地圖上的矩形圖片疊加層。

這個類別會擴充 MVCObject。

請呼叫 const {GroundOverlay} = await google.maps.importLibrary("maps") 存取。請參閱「Maps JavaScript API 中的程式庫」。

建構函式
GroundOverlay	GroundOverlay(url, bounds[, opts]) 參數：  url：string bounds：LatLngBounds|LatLngBoundsLiteral opts：GroundOverlayOptions optional 使用提供的圖片網址及其 LatLngBounds 建立地面覆蓋圖。圖片大小經過調整以符合目前界限的大小，並使用目前的地圖投射進行投射。

方法
getBounds	getBounds() 參數：無 傳回值：  LatLngBounds 取得此疊加層的 LatLngBounds。
getMap	getMap() 參數：無 傳回值：  Map 傳回顯示這個地面疊加層的地圖。
getOpacity	getOpacity() 參數：無 傳回值：  number 傳回此地形疊加層的不透明度。
getUrl	getUrl() 參數：無 傳回值：  string 取得這個投射圖片的網址。
setMap	setMap(map) 參數：  map：Map 傳回值：無 在指定的地圖上呈現地面疊加層。如果地圖設為 null，系統會移除疊加層。
setOpacity	setOpacity(opacity) 參數：  opacity：number 傳回值：無 設定此地圖疊加層的不透明度。
繼承： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll

活動
click	function(event) 引數：  event：MapMouseEvent 當 DOM 點擊事件在 GroundOverlay 上觸發時，系統會觸發此事件。
dblclick	function(event) 引數：  event：MapMouseEvent 當 DOM 雙擊事件在 GroundOverlay 上觸發時，系統就會觸發此事件。

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 class

建立具有自訂樣式的 MapType。

這個類別會擴充 MVCObject。

這個類別會實作 MapType。

請呼叫 const {StyledMapType} = await google.maps.importLibrary("maps") 存取。請參閱「Maps JavaScript API 中的程式庫」。

建構函式
StyledMapType	StyledMapType(styles[, options]) 參數：  styles：Array<MapTypeStyle> options：StyledMapTypeOptions optional 使用指定選項建立樣式化的 MapType。StyledMapType 會採用 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) 參數：  tileCoord：Point 圖塊座標。 zoom：number 圖塊縮放。 ownerDocument：Document 擁有此圖塊的文件。 傳回值：  Element|null 產生的資訊方塊。
releaseTile	releaseTile(tile) 參數：  tile：要釋出的 Element optional 資訊方塊。 傳回值：無
繼承： 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 地圖類型控制項中顯示的名稱。