Maps

對應 類別

google.maps.Map 類別

這個類別 MVCObject

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

Map
Map(mapDiv[, opts])
參數: 
在指定的 HTML 容器中建立新地圖,通常是 DIV 元素。
DEMO_MAP_ID 地圖 ID,可用於需要地圖 ID 的程式碼範例。這組地圖 ID 不適用於正式版應用程式,無法用於需要雲端設定的功能 (例如雲端樣式)。
controls
類型:  Array<MVCArray<HTMLElement>>
附加至地圖的其他控制項。如要在地圖中新增控制項,請將控制項的 <div> 新增至與 ControlPosition 相對應的 MVCArray,後者應算繪。
data
類型:  Data
與地圖的 Data 例項。在這個 Data 物件中新增地圖項目,以便在地圖上輕鬆顯示。
mapTypes
類型:  MapTypeRegistry
MapType 執行個體的登錄檔 (依字串 ID)。
overlayMapTypes
類型:  MVCArray<MapType optional>
要疊加的其他地圖類型。疊加層地圖類型會顯示在所附加的基本地圖上方,順序與在 overlayMapTypes 陣列中的顯示順序相同 (索引值較高的疊加層會顯示在索引值較低的疊加層前面)。
fitBounds
fitBounds(bounds[, padding])
參數: 
  • boundsLatLngBounds|LatLngBoundsLiteral 要顯示的界限。
  • paddingnumber|Padding optional 邊框間距 (以像素為單位)。移除邊框間距後,邊界將可以包含在地圖中。數字值會在 4 邊產生相同的邊框間距。請在此提供 0,讓 getBounds 結果產生 FitBounds 冪等值。
傳回值:
設定檢視區包含指定的界限。
注意:當地圖設為 display: none 時,fitBounds 函式會將地圖的大小讀取為 0x0,因此不會執行任何操作。如要在隱藏地圖時變更可視區域,請將地圖設為 visibility: hidden,確保地圖 div 設有實際大小。對於向量地圖,此方法會將地圖的傾斜和方向角度設為預設的零值。呼叫這個方法可能會讓地圖在平移及縮放符合邊界時,可能會呈現平滑的動畫。這個方法的動畫效果是否取決於內部經驗法則。
getBounds
getBounds()
參數:
傳回值:  LatLngBounds|undefined 目前可視區域的經緯度邊界。
傳回目前檢視區的經、緯界限。如果可以看到世界上的多個副本,則從經度到 180 度的範圍介於經度之間 (包括 -180 到 180 度)。如果尚未初始化或置中,且尚未設定縮放功能,則結果為 undefined。如果是具有非零傾斜或方向的向量地圖,傳回的 lat/lng 邊界代表最小的邊框,範圍包含地圖可視區域的可見區域。如要瞭解地圖可視區域的確切顯示區域,請參閱 MapCanvasProjection.getVisibleRegion
getCenter
getCenter()
參數:
傳回值:  LatLng|undefined
傳回顯示在地圖中央的位置。請注意,這個 LatLng 物件「不會」包裝。詳情請參閱 LatLng。如果尚未設定中心或邊界,則結果為 undefined
getClickableIcons
getClickableIcons()
參數:
傳回值:  boolean|undefined
傳回地圖圖示的可點擊性。地圖圖示代表搜尋點,又稱為搜尋點。如果傳回值為 true,則圖示可在地圖上點選。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
參數: 
  • datasetIdstring
傳回值:  FeatureLayer
傳回指定 datasetIdFeatureLayer。您必須在 Google Cloud 控制台中設定資料集 ID。如果資料集 ID 未與地圖的地圖樣式建立關聯,或者無法使用資料導向樣式 (沒有地圖 ID、沒有向量圖塊、沒有地圖樣式中的地圖項目圖層或資料集),則此記錄就會記錄錯誤,而產生的 FeatureLayer.isAvailable 為 false。
getDiv
getDiv()
參數:
傳回值:  HTMLElement地圖的 mapDiv.
getFeatureLayer
getFeatureLayer(featureType)
參數: 
傳回值:  FeatureLayer
傳回特定 FeatureTypeFeatureLayer。您必須在 Google Cloud 控制台中啟用 FeatureLayer。如果這個地圖上沒有指定 FeatureTypeFeatureLayer,或是無法使用資料導向樣式 (沒有地圖 ID、向量圖塊,以及在地圖樣式中啟用 FeatureLayer),系統就會記錄錯誤,且產生的 FeatureLayer.isAvailable 會是 false。
getHeading
getHeading()
參數:
傳回值:  number|undefined
傳回地圖的指南針方向。方向值是以北基線方向順時針方向測量為度數 (順時針方向)。如果地圖尚未初始化,結果會是 undefined
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
參數:
傳回值:  boolean|null
傳回是否已啟用標題互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
getMapCapabilities
getMapCapabilities()
參數:
傳回值:  MapCapabilities
根據所提供的地圖 ID,告知地圖目前可用功能的呼叫者。
getMapTypeId
getMapTypeId()
參數:
傳回值:  MapTypeId|string|undefined
getProjection
getProjection()
參數:
傳回值:  Projection|undefined
傳回目前的 Projection。如果地圖尚未初始化,結果會是 undefined。監聽 projection_changed 事件並檢查其值,確認其並非 undefined
getRenderingType
getRenderingType()
參數:
傳回值:  RenderingType
傳回地圖目前的 RenderingType。
getStreetView
getStreetView()
參數:
Return Value (傳回值):  StreetViewPanorama 與地圖繫結的全景。
傳回與地圖繫結的預設 StreetViewPanorama,這可能是內嵌在地圖中的預設全景,或使用 setStreetView() 的全景集。地圖的 streetViewControl 變更會反映在此類繫結全景的顯示中。
getTilt
getTilt()
參數:
傳回值:  number|undefined
傳回地圖目前的入射角度 (以度為單位,從檢視區平面到地圖平面)。如果是光柵地圖,直接拍攝圖像的結果為 0,如果為 45° 圖像,結果會是 45。這個方法不會傳回 setTilt 設定的值。詳情請參閱 setTilt
getTiltInteractionEnabled
getTiltInteractionEnabled()
參數:
傳回值:  boolean|null
傳回是否要啟用傾斜互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
getZoom
getZoom()
參數:
傳回值:  number|undefined
傳回地圖的縮放等級。如未設定縮放,則結果為 undefined
moveCamera
moveCamera(cameraOptions)
參數: 
傳回值:
立即將地圖的相機設為目標攝影機選項,不含動畫。
panBy
panBy(x, y)
參數: 
  • xnumber地圖往 x 方向移動的像素數量。
  • ynumber 往 y 方向移動地圖的像素數量。
傳回值:
根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度,移動時會產生平順的動畫感。請注意,地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。
panTo
panTo(latLng)
參數: 
傳回值:
將地圖的中心變更為指定的 LatLng。如果所進行的變動同時小於地圖的寬度和高度,移動時會產生平順的動畫感。
panToBounds
panToBounds(latLngBounds[, padding])
參數: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral地圖的平移範圍。
  • paddingnumber|Padding optional 邊框間距 (以像素為單位)。數字值會在 4 邊產生相同的邊框間距。預設值為 0。
傳回值:
以包含指定 LatLngBounds 所需的最低門檻平移地圖。這樣做無法保證地圖上的邊界會位於何處,但地圖會平移以盡可能顯示在 {currentMapSizeInPx} - {padding} 中的邊界。在光柵地圖和向量地圖上,地圖的縮放、傾斜度和方向都將維持不變。
setCenter
setCenter(latlng)
參數: 
傳回值:
setClickableIcons
setClickableIcons(value)
參數: 
  • valueboolean
傳回值:
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點,又稱為搜尋點。如要停用地圖圖示的可點擊性,請將 false 的值傳遞至此方法。
setHeading
setHeading(heading)
參數: 
  • headingnumber
傳回值:
設定地圖的指南針方向,以度為單位從北方位角度測量所得的結果。針對光柵地圖,此方法僅適用於空照圖像。
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
參數: 
  • headingInteractionEnabledboolean
傳回值:
設定是否啟用標題互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
setMapTypeId
setMapTypeId(mapTypeId)
參數: 
傳回值:
setOptions
setOptions(options)
參數: 
傳回值:
setRenderingType
setRenderingType(renderingType)
參數: 
傳回值:
設定地圖目前的 RenderingType。
setStreetView
setStreetView(panorama)
參數: 
傳回值:
StreetViewPanorama 繫結至地圖。此全景會覆寫預設的 StreetViewPanorama,讓地圖可以繫結至地圖外的外部全景。將全景設定為 null,會將預設的內嵌全景繫結回地圖。
setTilt
setTilt(tilt)
參數: 
  • tiltnumber
傳回值:
針對向量地圖,設定地圖的入射角。允許的值視地圖的縮放等級而定。

針對光柵地圖,控制地圖方位角的自動切換行為。唯一允許的值為 045setTilt(0) 會一律使用 0° 的俯視檢視畫面,無論縮放等級和可視區域為何。setTilt(45) 會使目前的縮放等級和可視區域有 45° 圖像時,將傾斜角度自動切換為 45,且當 45° 圖像無法使用時,會切換回 0 (預設行為)。45° 圖像僅適用於部分地點內及特定縮放等級的 satellitehybrid 地圖類型,注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTiltsetTilt 參照不同內容,因此請勿對 tilt 屬性執行 bind()。這可能會產生無法預期的影響。
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
參數: 
  • tiltInteractionEnabledboolean
傳回值:
設定是否要啟用傾斜互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
setZoom
setZoom(zoom)
參數: 
  • zoomnumber 較大的變焦值會對應到較高的解析度。
傳回值:
設定地圖的縮放等級。
沿用: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
引數:
當檢視區界限變更時,會引發此事件。
center_changed
function()
引數:
當地圖中心的屬性變更時,會引發此事件。
click
function(event)
引數: 
使用者在地圖上按一下時,會引發此事件。除非使用者點選地點圖示,否則會傳回包含屬性的 MapMouseEvent,其中傳回包含地點 ID 的 IconMouseEvent。IconMouseEvent 和 MapMouseEvent 相同,但 IconMouseEvent 具有地點 ID 欄位。當地點 ID 不重要時,該事件一定可以視為 MapMouseEvent。如果按下標記或資訊視窗,則不會觸發點擊事件。
contextmenu
function(event)
引數: 
地圖容器引發 DOM contextmenu 事件時,會引發此事件。
dblclick
function(event)
引數: 
使用者在地圖上按兩下時,會引發此事件。請注意,點擊事件有時會在這個事件之前觸發一次,有時甚至兩次。
drag
function()
引數:
當使用者拖曳地圖時,會重複引發此事件。
dragend
function()
引數:
使用者停止拖曳地圖時,會引發此事件。
dragstart
function()
引數:
使用者開始拖曳地圖時,會引發此事件。
heading_changed
function()
引數:
當地圖方向屬性變更後,會引發此事件。
idle
function()
引數:
當地圖在平移或縮放後閒置時,會引發此事件。
isfractionalzoomenabled_changed
function()
引數:
當 isFractionalZoomEnabled 屬性變更時,會引發此事件。
mapcapabilities_changed
function()
引數:
當地圖功能變更時,會引發此事件。
maptypeid_changed
function()
引數:
當 mapTypeId 屬性變更後,會引發此事件。
mousemove
function(event)
引數: 
當使用者的滑鼠移動至地圖容器時,會引發此事件。
mouseout
function(event)
引數: 
當使用者的滑鼠離開地圖容器時,會引發此事件。
mouseover
function(event)
引數: 
當使用者的滑鼠進入地圖容器時,會引發此事件。
projection_changed
function()
引數:
當投影變更後,會引發此事件。
renderingtype_changed
function()
引數:
當 renderType 變更時,會引發此事件。
tilesloaded
function()
引數:
所有可見的地圖方塊完成載入之後,就會引發這個事件。
tilt_changed
function()
引數:
當地圖斜率屬性變更後,會引發此事件。
zoom_changed
function()
引數:
當地圖縮放等級的屬性變更後,會引發此事件。
rightclick
function(event)
引數: 
當使用者在地圖上按一下右鍵時,會引發此事件。

MapOptions 介面

google.maps.MapOptions 介面

MapOptions 物件,用來定義可以在地圖上設定的屬性。

backgroundColor optional
類型:  string optional
用於 Map div 的背景顏色。當使用者平移而尚未載入圖塊時,就會看到這個顏色。這個選項需在地圖初始化後才能設定。
center optional
類型:  LatLng|LatLngLiteral optional
初始的地圖中心。
clickableIcons optional
類型:  boolean optional
預設: true
如果設為 false,地圖圖示將無法點選。地圖圖示代表搜尋點,又稱為搜尋點。
BetacolorScheme optional
類型:  ColorScheme|string optional
初始的地圖色彩配置。這個選項需在地圖初始化後才能設定。
controlSize optional
類型:  number optional
地圖上顯示控制項的大小 (以像素為單位)。建立地圖時必須直接提供這個值,之後更新這個值可能會導致控制項進入 undefined 狀態。僅管理 Maps API 本身建立的控制項。不會調整開發人員建立自訂控制項的資源。
disableDefaultUI optional
類型:  boolean optional
啟用/停用所有預設 UI 按鈕。可以個別覆寫。系統不會停用鍵盤控制項 (由 MapOptions.keyboardShortcuts 選項個別控制)。不會停用手勢控制項,這由 MapOptions.gestureHandling 選項另外控制。
disableDoubleClickZoom optional
類型:  boolean optional
連按兩下啟用/停用縮放和中心。預設啟用。

注意:我們不建議使用這項屬性。如要停用按兩下縮放功能,可以使用 gestureHandling 屬性,並將其設為 "none"

draggable optional
類型:  boolean optional
如果為 false,則禁止拖曳地圖。預設會啟用拖曳的功能。
draggableCursor optional
類型:  string optional
將滑鼠遊標懸停在可拖曳的地圖上時,要顯示的遊標名稱或網址。這個屬性會使用 css cursor 屬性來變更圖示。與 css 屬性相同,您必須指定至少一個非網址的備用遊標。例如:draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional
類型:  string optional
拖曳地圖時,要顯示的遊標名稱或網址。這個屬性會使用 css cursor 屬性來變更圖示。與 css 屬性相同,您必須指定至少一個非網址的備用遊標。例如:draggingCursor: 'url(http://www.example.com/icon.png), auto;'
fullscreenControl optional
類型:  boolean optional
全螢幕控制項的啟用/停用狀態。
fullscreenControlOptions optional
類型:  FullscreenControlOptions optional
全螢幕控制項的顯示選項。
gestureHandling optional
類型:  string optional
這項設定會控制 API 如何處理地圖上的手勢。允許的值:
  • "cooperative":捲動事件和單指觸控手勢可捲動頁面,且不會縮放或平移地圖。雙指觸控手勢會平移和縮放地圖。使用 Ctrl 鍵或按下 ⌘ 鍵的捲動事件來縮放地圖。
    在這個模式下,地圖與頁面「合作」
  • "greedy":所有觸控手勢和捲動事件,都會平移或縮放地圖。
  • "none":無法以使用者手勢平移或縮放地圖。
  • "auto":(預設) 手勢處理為合作或貪婪,這取決於網頁是可捲動還是 iframe。
heading optional
類型:  number optional
由北方位基點以順時針方向繞某一角度所取得的空照圖像方向。方向會貼齊包含圖像的最近可用角度。
headingInteractionEnabled optional
類型:  boolean optional
預設: false
地圖是否應允許使用者控制攝影機方向 (旋轉)。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
isFractionalZoomEnabled optional
類型:  boolean optional
預設:向量地圖為 true,光柵地圖則為 false
是否要允許地圖使用小數縮放比例。監聽 isfractionalzoomenabled_changed 以瞭解是否已設定預設值。
keyboardShortcuts optional
類型:  boolean optional
如果設為 false,則禁止使用鍵盤控制地圖。預設會啟用鍵盤捷徑。
mapId optional
類型:  string optional
地圖的地圖 ID。在地圖例項化之後,無法設定或變更此參數。Map.DEMO_MAP_ID 可用於試用需要地圖 ID,但不需要雲端啟用的功能。
mapTypeControl optional
類型:  boolean optional
地圖類型控制項的初始啟用/停用狀態。
mapTypeControlOptions optional
類型:  MapTypeControlOptions optional
地圖類型控制項的初始顯示選項。
mapTypeId optional
類型:  MapTypeId|string optional
初始的 MapTypeId。預設值為 ROADMAP
maxZoom optional
類型:  number optional
將可在地圖上顯示的最大縮放等級。如果省略這個引數或設為 null,系統會改用目前地圖類型的最大縮放等級。有效的縮放值是從零到支援的最大縮放等級數字,
minZoom optional
類型:  number optional
將可在地圖上顯示的最小縮放等級。如果省略或設為 null,系統會改用目前地圖類型中的最小縮放等級。有效的縮放值是從零到支援的最大縮放等級數字,
noClear optional
類型:  boolean optional
如果為 true,則不要清除 Map div 的內容。
panControl optional
類型:  boolean optional
「平移」控制項的啟用/停用狀態。

panControlOptions optional
類型:  PanControlOptions optional
「平移」控制項的顯示選項。

renderingType optional
類型:  RenderingType optional
地圖必須是光柵地圖或向量地圖。在地圖例項化之後,無法設定或變更此參數。如未設定,地圖 ID 的雲端設定會決定算繪類型 (如果有的話)。請注意,部分裝置和瀏覽器可能無法使用向量地圖,因此如有需要,地圖會改回使用光柵地圖。
restriction optional
類型:  MapRestriction optional
定義界線,用來限制使用者可以存取的地圖區域。設定完成後,使用者就只能平移和縮放鏡頭,而且相機檢視畫面超出邊界限制。
rotateControl optional
類型:  boolean optional
旋轉控制項的啟用/停用狀態。
rotateControlOptions optional
類型:  RotateControlOptions optional
旋轉控制項的顯示選項。
scaleControl optional
類型:  boolean optional
比例控制項的初始啟用/停用狀態。
scaleControlOptions optional
類型:  ScaleControlOptions optional
比例控制項的初始顯示選項。
scrollwheel optional
類型:  boolean optional
如果設為 false,會停用使用滑鼠滾輪縮放地圖的功能。系統預設會啟用滾輪。

注意:我們不建議使用這項屬性。如要停用滾輪縮放功能,您可以使用 gestureHandling 屬性,並將其設為 "cooperative""none"

streetView optional
類型:  StreetViewPanorama optional
在地圖上拖放街景服務衣夾人時,會顯示 StreetViewPanorama。如果未指定全景,當拖曳衣夾人時,預設的 StreetViewPanorama 會顯示在地圖的 div 中。
streetViewControl optional
類型:  boolean optional
街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設 UI 的一部分,而且在顯示地圖類型時,應設為 false,但不應顯示街景服務道路疊加層 (例如非 Google 地球地圖類型)。
streetViewControlOptions optional
類型:  StreetViewControlOptions optional
街景服務衣夾人控制項的初始顯示選項。
styles optional
類型:  Array<MapTypeStyle> optional
要套用至各個預設地圖類型的樣式。請注意,針對 satellite/hybridterrain 模式,這些樣式只會套用至標籤和幾何圖形。使用地圖 ID 或使用向量地圖時,無法使用這項功能 (請改用雲端式地圖樣式設定)。
tilt optional
類型:  number optional
針對向量地圖,設定地圖的入射角。允許的值視地圖的縮放等級而定。至於光柵地圖,控制自動切換行為以地圖方位角為準。唯一允許的值為 045。無論縮放等級和可視區域為何,0 值都會使地圖一律使用 0° 的俯視檢視畫面。當目前的縮放等級和可視區域有 45° 圖像可用時,45 值會導致傾斜角度自動切換為 45。此外,當 45° 圖像沒有可用時,傾斜角度會變回 0 (預設行為)。45° 圖像僅適用於部分地點內及特定縮放等級的 satellitehybrid 地圖類型,注意: getTilt 會傳回目前的傾斜角度,而非這個選項所指定的值。由於 getTilt 和這個選項會參照不同的內容,因此請勿對 tilt 屬性進行 bind() 屬性。這可能會產生無法預期的影響。
tiltInteractionEnabled optional
類型:  boolean optional
預設: false
指出地圖是否應允許使用者控制攝影機傾斜。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
zoom optional
類型:  number optional
初始的地圖縮放等級。有效的縮放值是從零到支援的最大縮放等級數字,較大的縮放值對應較高的解析度。
zoomControl optional
類型:  boolean optional
縮放控制項的啟用/停用狀態。
zoomControlOptions optional
類型:  ZoomControlOptions optional
縮放控制項的顯示選項。

MapElement 類別

google.maps.MapElement 類別

MapElement 是用來呈現地圖的 HTMLElement 子類別。載入 maps 程式庫後,即可在 HTML 中建立地圖。例如:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

在內部使用 Map,可透過 innerMap 屬性存取。

自訂元素:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

這個類別 HTMLElement

這個類別會實作 MapElementOptions

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

MapElement
MapElement([options])
參數: 
center
類型:  LatLng|LatLngLiteral optional
地圖的中心緯度/經度。
HTML 屬性:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
類型:  boolean optional
預設: false
地圖是否應允許使用者控制攝影機方向 (旋轉)。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
HTML 屬性:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
類型:  Map
MapElement 內部使用的 Map 參照。
mapId
類型:  string optional
地圖的地圖 ID。在地圖例項化之後,無法設定或變更此參數。Map.DEMO_MAP_ID 可用於試用需要地圖 ID,但不需要雲端啟用的功能。
HTML 屬性:
  • <gmp-map map-id="string"></gmp-map>
renderingType
類型:  RenderingType optional
地圖必須是光柵地圖或向量地圖。在地圖例項化之後,無法設定或變更此參數。如未設定,地圖 ID 的雲端設定會決定算繪類型 (如果有的話)。請注意,部分裝置和瀏覽器可能無法使用向量地圖,因此如有需要,地圖會改回使用光柵地圖。
HTML 屬性:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
類型:  boolean optional
預設: false
指出地圖是否應允許使用者控制攝影機傾斜。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
HTML 屬性:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
類型:  number optional
地圖的縮放等級。有效的縮放值是從零到支援的最大縮放等級數字,較大的縮放值對應較高的解析度。
HTML 屬性:
  • <gmp-map zoom="number"></gmp-map>
control-block-end-inline-center
將運算單元元素放在 ControlPosition.BLOCK_END_INLINE_CENTER 位置。
control-block-end-inline-end
將運算單元元素放在 ControlPosition.BLOCK_END_INLINE_END 位置。
control-block-end-inline-start
將運算單元元素放在 ControlPosition.BLOCK_END_INLINE_START 位置。
control-block-start-inline-center
將運算單元元素放在 ControlPosition.BLOCK_START_INLINE_CENTER 位置。
control-block-start-inline-end
將運算單元元素放在 ControlPosition.BLOCK_START_INLINE_END 位置。
control-block-start-inline-start
將運算單元元素放在 ControlPosition.BLOCK_START_INLINE_START 位置。
control-inline-end-block-center
將運算單元元素放在 ControlPosition.INLINE_END_BLOCK_CENTER 位置。
control-inline-end-block-end
將運算單元元素放在 ControlPosition.INLINE_END_BLOCK_END 位置。
control-inline-end-block-start
將運算單元元素放在 ControlPosition.INLINE_END_BLOCK_START 位置。
control-inline-start-block-center
將運算單元元素放在 ControlPosition.INLINE_START_BLOCK_CENTER 位置。
control-inline-start-block-end
將運算單元元素放在 ControlPosition.INLINE_START_BLOCK_END 位置。
control-inline-start-block-start
將運算單元元素放在 ControlPosition.INLINE_START_BLOCK_START 位置。
default
您可以使用自訂元素,在 Maps JavaScript 網頁元件 (例如 AdvancedMarkerElement) 周圍建立可重複使用的元件。根據預設,直接新增至 MapElement 的自訂元素都會在 MapPanes.overlayMouseTarget 中配置並顯示。但 Maps JavaScript API 網頁元件可能會重新安排到 MapElement 的內部版位。
BetaaddEventListener
addEventListener(type, listener[, options])
參數: 
  • typestring 區分大小寫的字串,代表要監聽的事件類型。
  • listenerEventListener|EventListenerObject 接收通知的物件。這必須是函式或含有 handleEvent 方法的物件
  • optionsboolean|AddEventListenerOptions optional查看選項。自訂事件僅支援 capturepassive
傳回值:  void
設定每次指定事件傳送至目標時要呼叫的函式。請參閱 addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
參數: 
傳回值:  void
從目標中移除先前以 addEventListener 註冊的事件監聽器。請參閱 removeEventListener
gmp-zoomchange
function(event)
引數: 
當地圖縮放等級的屬性變更後,會引發此事件。

MapElementOptions 介面

google.maps.MapElementOptions 介面

用來定義可在 MapElement 上設定的屬性的 MapElementOptions 物件。

center optional
類型:  LatLng|LatLngLiteral optional
詳情請參閱《MapElement.center》。
headingInteractionDisabled optional
類型:  boolean optional
mapId optional
類型:  string optional
詳情請參閱《MapElement.mapId》。
renderingType optional
類型:  RenderingType optional
詳情請參閱《MapElement.renderingType》。
tiltInteractionDisabled optional
類型:  boolean optional
詳情請參閱《MapElement.tiltInteractionDisabled》。
zoom optional
類型:  number optional
詳情請參閱《MapElement.zoom》。

ZoomChangeEvent 類別

google.maps.ZoomChangeEvent 類別

此事件是透過監控縮放變更而建立。

這個類別 Event

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

MapTypeStyle 介面

google.maps.MapTypeStyle 介面

MapTypeStyle 是選取器和樣式工具集合,可定義地圖的樣式。選取器會指定受影響的地圖項目和/或元素,樣式工具則指定如何修改這些地圖項目和元素。詳情請參閱樣式參考資料

stylers
類型:  Array<Object>
要套用至所選地圖項目和元素的樣式規則。系統會依照您在這個陣列中指定的順序套用規則。如需使用和允許值的規範,請參閱樣式參考資料
elementType optional
類型:  string optional
樣式工具應套用的元素。元素是地圖上地圖項目的視覺元素,例如:標籤、圖示、套用到幾何圖形的筆觸或填滿等。選用設定。如未指定 elementType,系統會假設該值為 'all'。如要進一步瞭解用法和允許值,請參閱樣式參考資料
featureType optional
類型:  string optional
樣式工具適用的功能或功能群組。選用設定。如未指定 featureType,系統會假設該值為 'all'。如要進一步瞭解用法和允許值,請參閱樣式參考資料

MapMouseEvent 介面

google.maps.MapMouseEvent 介面

這個物件是從地圖以及疊加層上的各種 mouse 事件傳回的,而且包含以下顯示的所有欄位。

domEvent
對應的原生 DOM 事件。開發人員不應仰賴 targetcurrentTargetrelatedTargetpath 屬性的定義並保持一致。開發人員也不應該依賴 Maps API 內部實作的 DOM 結構。由於內部事件對應,domEvent 可能有與 MapMouseEvent 不同的語意 (例如 MapMouseEvent「點擊」的 domEvent 類型可能為 KeyboardEvent)。
latLng optional
類型:  LatLng optional
當事件發生時,游標底下的經、緯度。
stop
stop()
參數:
傳回值:  void
防止這個事件進一步傳播。

IconMouseEvent 介面

google.maps.IconMouseEvent 介面

使用者點選地圖上的圖示時,系統會透過事件傳送這個物件。這個地點的地點 ID 會儲存在 placeId 成員中。若要防止預設的資訊視窗顯示,請針對此事件呼叫 stop() 方法,防止它傳播。如要進一步瞭解地點 ID,請參閱 Places API 開發人員指南。

這個介面 MapMouseEvent

placeId optional
類型:  string optional
點按的地點 ID。這個地點 ID 可用來查詢所點選地圖項目的詳細資訊,

如要進一步瞭解地點 ID,請參閱 Places API 開發人員指南。

沿用: domEvent, latLng
沿用: stop

ColorScheme 常數

google.maps.ColorScheme 常數

地圖色彩配置的 ID。透過值或常數名稱指定這些值。例如 'FOLLOW_SYSTEM'google.maps.ColorScheme.FOLLOW_SYSTEM

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

DARK 地圖的深色配置。
FOLLOW_SYSTEM 根據系統偏好設定選取色彩配置。
LIGHT 地圖的淺色配置。舊版 Maps JS 的預設值。

MapTypeId 常數

google.maps.MapTypeId 常數

一般 MapType 的 ID。透過值或常數名稱指定這些值。例如 'satellite'google.maps.MapTypeId.SATELLITE

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

HYBRID 這個地圖類型會在衛星圖片上顯示主要街道的透明層。
ROADMAP 這個地圖類型會顯示一般街道地圖。
SATELLITE 這個地圖類型會顯示衛星圖片。
TERRAIN 這個地圖類型會以實際圖徵 (例如地形和植被) 顯示地圖。

MapTypeRegistry 類別

google.maps.MapTypeRegistry 類別

MapType 例項的註冊資料庫,由 MapType ID 指定索引鍵。

這個類別 MVCObject

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

MapTypeRegistry
MapTypeRegistry()
參數:
MapTypeRegistry 包含地圖可用的自訂地圖類型集合。舉例來說,API 提供控制項中可用的地圖類型清單時,會參考這個登錄。
set
set(id, mapType)
參數: 
  • idstring要新增至登錄檔的 MapType 的 ID。
  • mapType:要新增至登錄檔的 MapType|* MapType 物件。
傳回值:
設定登錄檔,以建立傳送的字串識別項與傳送的 MapType 關聯。
沿用: addListener, bindTo, get, notify, setValues, unbind, unbindAll

MapRestriction 介面

google.maps.MapRestriction 介面

可套用至地圖的限制。地圖的可視區域不會超過這些限制。

latLngBounds
設定後,使用者只能在指定的邊界內平移和縮放。界限可以限制經緯度,或只能限制緯度。如果是僅限緯度,則分別使用西經度和 -180 和 180 的西經度值,例如 latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}
strictBounds optional
類型:  boolean optional
只要將 strictBounds 標記設為 true,即可進一步限制範圍。這項設定會減少使用者縮小的範圍,確保限制範圍外的所有內容維持隱藏狀態。預設值為 false,表示使用者可以縮小畫面,直到整個邊界區域都出現在檢視畫面中,其中可能包含邊界區域以外的區域。

TrafficLayer 類別

google.maps.TrafficLayer 類別

路況圖層。

這個類別 MVCObject

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

TrafficLayer
TrafficLayer([opts])
參數: 
顯示目前路況的圖層。
getMap
getMap()
參數:
傳回值:  Map
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數: 
傳回值:
在指定的地圖上呈現圖層。如果地圖設為 null,系統就會移除圖層。
setOptions
setOptions(options)
參數: 
傳回值:
沿用: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

TrafficLayerOptions 介面

google.maps.TrafficLayerOptions 介面

TrafficLayerOptions 物件可用來定義可設定在 TrafficLayer 上的屬性。

autoRefresh optional
類型:  boolean optional
預設: true
車流量圖層是否會自動重新整理最新資訊。
map optional
類型:  Map optional
要顯示車流量圖層的地圖。

TransitLayer 類別

google.maps.TransitLayer 類別

大眾運輸圖層。

這個類別 MVCObject

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

TransitLayer
TransitLayer()
參數:
顯示大眾運輸路線的圖層。
getMap
getMap()
參數:
傳回值:  Map
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數: 
傳回值:
在指定的地圖上呈現圖層。如果地圖設為 null,系統就會移除圖層。
沿用: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

BicyclingLayer 類別

google.maps.BicyclingLayer 類別

顯示單車道的疊加層。

這個類別 MVCObject

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

BicyclingLayer
BicyclingLayer()
參數:
顯示單車道並降低大道路等級的圖層。
getMap
getMap()
參數:
傳回值:  Map
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數: 
傳回值:
在指定的地圖上呈現圖層。如果地圖設為 null,系統就會移除圖層。
沿用: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

CameraOptions 介面

google.maps.CameraOptions 介面

用於設定地圖的攝影機選項。

center optional
類型:  LatLngLiteral|LatLng optional
heading optional
類型:  number optional
tilt optional
類型:  number optional
zoom optional
類型:  number optional

VisibleRegion 介面

google.maps.VisibleRegion 介面

包含定義四面多邊形,也就是地圖的可見區域的四個點。在向量地圖上,如果向量地圖有傾斜角度,這個多邊形的形狀會是梯形地圖,而不是矩形。

farLeft
類型:  LatLng
farRight
類型:  LatLng
latLngBounds
類型:  LatLngBounds
包含可見區域的最小定界框。
nearLeft
類型:  LatLng
nearRight
類型:  LatLng

RenderingType 常數

google.maps.RenderingType 常數

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

RASTER 表示地圖為光柵地圖。
UNINITIALIZED 表示地圖本身是向量或光柵地圖,因為地圖尚未完成初始化。
VECTOR 表示地圖為向量地圖。

MapCapabilities 介面

google.maps.MapCapabilities 介面

內含地圖目前可用功能快照的物件。請注意,這不一定代表相關模組已載入或初始化,而是目前的地圖擁有使用這些 API 的權限。如需可用功能的清單,請參閱屬性。

isAdvancedMarkersAvailable optional
類型:  boolean optional
如果為 true,此地圖已正確設定,允許使用進階標記。請注意,您仍需匯入 marker 程式庫,才能使用進階標記。詳情請參閱 https://goo.gle/gmp-isAdvancedMarkersAvailable
isDataDrivenStylingAvailable optional
類型:  boolean optional
如果為 true,此地圖已正確設定,允許至少一個 FeatureLayer 使用資料導向樣式。詳情請參閱 https://goo.gle/gmp-data-driven-stylinghttps://goo.gle/gmp-FeatureLayerIsAvailable
isWebGLOverlayViewAvailable optional
類型:  boolean optional
如果為 true,此地圖已正確設定,允許使用 WebGLOverlayView