Maps

Map 類別

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 度 (含首尾)。如果地圖尚未初始化或中心,而且未設定縮放,則結果為 undefined。對於具有非零傾斜或方向的向量地圖,傳回的經緯度邊界表示地圖檢視區域的最小定界框。如要瞭解地圖可視區域的確切可見區域,請參閱 MapCanvasProjection.getVisibleRegion
getCenter
getCenter()
參數:
傳回值:  LatLng|undefined
傳回地圖中央顯示的位置。請注意,系統「不會」包裝這個 LatLng 物件。詳情請參閱 LatLng。如果尚未設定中心點或邊界,則結果為 undefined
getClickableIcons
getClickableIcons()
參數:
傳回值:  boolean|undefined
傳回地圖圖示的可點擊性。地圖圖示代表搜尋點,又稱為 POI。如果傳回的值是 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()
參數:
傳回值:  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
傳回值:
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點,又稱為 POI。如要停用地圖圖示的可點擊性,請將 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
傳回值:
如果是向量地圖,請設定地圖的入射角。允許使用的值取決於地圖的縮放等級。

對於光柵地圖,控制地圖起始角度的自動切換行為。僅允許 045 值。setTilt(0) 會使地圖一律使用 0° 俯視檢視畫面,無論縮放等級和可視區域為何。setTilt(45) 會導致目前縮放等級和可視區域的 45° 圖像提供 45° 圖像時,傾斜角度會自動切換成 45,並在沒有 45° 圖像時切換回 0 (此為預設行為)。45° 圖像僅適用於 satellitehybrid 地圖類型,且僅適用於某些位置及某些縮放等級。注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTiltsetTilt 參照的內容不同,請勿對 tilt 屬性進行 bind(),否則可能會產生無法預測的影響。
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
參數: 
  • tiltInteractionEnabledboolean
傳回值:
設定是否要啟用傾斜互動功能。只有在地圖是向量地圖時,這個選項才會生效。如未在程式碼中設定,系統會使用該地圖 ID 的雲端設定 (如果有的話)。
setZoom
setZoom(zoom)
參數: 
  • zoomnumber 較大的變焦值對應更高的解析度。
傳回值:
設定地圖縮放。
沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll
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()
引數:
showType 變更時,會引發此事件。
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,地圖圖示不可點擊。地圖圖示代表搜尋點,又稱為 POI。
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,請勿清除地圖 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。如果未指定全景,則拖曳衣夾人時,地圖的 div 會顯示預設的 StreetViewPanorama
streetViewControl optional
類型:  boolean optional
街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設 UI 的一部分,在顯示不應顯示街景服務道路疊加層的地圖類型 (例如非 Google 地球地圖類型) 時,應設為 false
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 和此選項參照不同內容,請勿 bind() tilt 屬性,否則可能會產生無法預測的影響。
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 介面

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

center optional
類型:  LatLng|LatLngLiteral optional
查看《MapElement.center》。
headingInteractionDisabled optional
類型:  boolean optional
mapId optional
類型:  string optional
查看《MapElement.mapId》。
renderingType optional
類型:  RenderingType optional
tiltInteractionDisabled optional
類型:  boolean optional
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「click」的 domEvent 類型可能是 KeyboardEvent)。
latLng optional
類型:  LatLng optional
當事件發生時,游標底下的經、緯度。
stop
stop()
參數:
傳回值:  void
避免這項事件進一步傳播。

IconMouseEvent 介面

google.maps.IconMouseEvent 介面

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

這個介面會擴充 MapMouseEvent

placeId optional
類型:  string optional
獲得點擊的地點 ID。這個地點 ID 可用來查詢更多有關點選的地圖項目的資訊。

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

沿用: domEventlatLng
沿用: stop

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 ID 作為金鑰的 MapType 實例的登錄。

這個類別會擴充 MVCObject

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

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

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)
參數: 
傳回值:
沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll

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,系統就會移除圖層。
沿用: addListenerbindTogetnotifysetsetValuesunbindunbindAll

BicyclingLayer 類別

google.maps.BicyclingLayer 類別

顯示單車道的疊加層。

這個類別會擴充 MVCObject

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

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

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