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)
參數: 
  • tileCoordPoint圖塊座標。
  • zoomnumber 圖塊縮放。
  • ownerDocumentDocument這個圖塊的擁有者文件。
傳回值:  Element|null圖塊。
為指定的方塊座標 (x, y) 和縮放等級傳回一個方塊。此資訊方塊會附加在指定的 ownerDocument 上。不適用於基本地圖類型。
releaseTile
releaseTile(tile)
參數: 
  • tileElement optional 要釋出的動態磚。
傳回值:
釋出指定的方塊,執行任何必要的清除作業。提供的方塊已從文件移除。選用。

投影介面

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

ImageGeo 類別

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()
引數:
所有可見的地圖方塊完成載入之後,就會引發這個事件。

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

呼叫 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 點擊事件時,會觸發此事件。
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

呼叫 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

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
地圖類型控制項中顯示的名稱。