Image overlays

Geo 介面

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])
參數：
傳回值：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。

ImageGeo 類別

google.maps.ImageMapType 類別

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

此類別會擴充 MVCObject。

這個類別會實作 MapType。

使用 v=beta 時，可透過呼叫 const {ImageMapType} = await google.map.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 要釋出的動態磚。
傳回值：無
setOpacity
setOpacity(opacity)
參數：
  • opacity：number新的透明度。
傳回值：無
將 ImageMapType 圖塊的不透明度等級 (0 (透明) 設為 1.0)。
繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
tilesloaded
function()
引數：無
所有可見的地圖方塊完成載入之後，就會引發這個事件。

ImageGeoOptions 介面

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。

使用 v=beta 時，可透過呼叫 const {GroundOverlay} = await google.map.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 之間的數字表示。選用。

StyledGeo 類別

google.maps.StyledMapType 類別

使用自訂樣式建立 MapType。

此類別會擴充 MVCObject。

這個類別會實作 MapType。

使用 v=beta 時，可透過呼叫 const {StyledMapType} = await google.map.importLibrary("maps") 來存取請參閱 Maps JavaScript API 中的程式庫。
StyledMapType
StyledMapType(styles[, options])
參數：
使用指定選項建立樣式化 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

StyledGeoOptions 介面

google.maps.StyledMapTypeOptions 介面

這個類別會在建立 StyledMapType 時用來指定選項。StyledMapType 執行個體化後即無法變更這些選項。
alt optional
類型：string optional
在地圖類型控制項中，將滑鼠遊標懸停在 MapType 按鈕上時顯示的文字。
maxZoom optional
類型：number optional
顯示這個 MapType 時地圖的最大縮放等級。選用。
minZoom optional
類型：number optional
顯示這個 MapType 時地圖的最低縮放等級。選用。
name optional
類型：string optional
地圖類型控制項中顯示的名稱。