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> 新增至對應至應算繪 ControlPositionMVCArray
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()
參數:
Return Value:  LatLngBounds|undefined 目前可視區域的經緯度邊界。
傳回目前檢視區的經、緯界限。如果可以看到世界的多部副本,則邊界範圍為經度 -180 到 180 度 (含首尾)。如果地圖尚未初始化,或尚未設定中心縮放,則結果為 undefined。如果是具有非零傾斜或方向的向量地圖,傳回的經緯度範圍代表包含地圖可視區域可見區域的最小定界框。如要瞭解地圖可視區域的確切顯示區域,請參閱 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
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
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
傳回值:
設定地圖的指南針方向,以距離北方基線為單位測量單位。這個方法僅適用於光柵地圖。
setMapTypeId
setMapTypeId(mapTypeId)
參數: 
傳回值:
setOptions
setOptions(options)
參數: 
傳回值:
setStreetView
setStreetView(panorama)
參數: 
傳回值:
StreetViewPanorama 繫結至地圖。此全景會覆寫預設的 StreetViewPanorama,允許地圖繫結至地圖以外的外部全景。將全景設定為 null,會將預設的內嵌全景繫結回地圖。
setTilt
setTilt(tilt)
參數: 
  • tiltnumber
傳回值:
針對向量地圖,設定地圖的入射角。允許的值會根據地圖的縮放等級限制。如果是光柵地圖,請控制地圖的出現角度的自動切換行為。僅允許以下值:045setTilt(0) 會使地圖一律使用 0° 俯瞰檢視畫面,無論縮放等級和可視區域為何。setTilt(45) 會在目前的縮放等級和可視區域有 45° 圖像可用時,自動切換至 45° 圖像;如果沒有 45° 圖像,則會切換回 0 (此為預設行為)。45° 圖像僅適用於某些地點內的 satellitehybrid 地圖類型,以及某些縮放等級。注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTiltsetTilt 是指不同的事情,因此不要 bind() tilt 屬性;這樣做可能會產生無法預期的影響。
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()
引數:
當 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,則無法點擊地圖圖示。地圖圖示代表搜尋點,也稱為搜尋點。
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
由北方位基點以順時針方向繞某一角度所取得的空照圖像方向。方向會貼齊包含圖像的最近可用角度。
isFractionalZoomEnabled optional
類型:  boolean optional
預設:向量地圖為 true,光柵地圖為 false
地圖是否應允許使用小數縮放比例。請聆聽 isfractionalzoomenabled_changed,瞭解預設的時間。
keyboardShortcuts optional
類型:  boolean optional
如果為 false,則禁止使用鍵盤控制地圖。預設會啟用鍵盤捷徑。
mapId optional
類型:  string optional
地圖的地圖 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
平移控制項的顯示選項。

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
街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設使用者介面的一部分,在顯示不應顯示街景服務道路疊加層的地圖類型 (例如非地球地圖類型) 時,請設為 false
streetViewControlOptions optional
類型:  StreetViewControlOptions optional
街景服務衣夾人控制項的初始顯示選項。
styles optional
類型:  Array<MapTypeStyle> optional
要套用至每個預設地圖類型的樣式。請注意,如果是 satellite/hybridterrain 模式,這些樣式只會套用至標籤和幾何圖形。
tilt optional
類型:  number optional
針對向量地圖,設定地圖的入射角。允許的值會根據地圖的縮放等級限制。如果是光柵地圖,請控制地圖的出現角度的自動切換行為。僅允許以下值:0450 值會使地圖一律使用 0° 俯瞰檢視畫面,無論縮放等級和可視區域為何。45 值會使傾斜角度自動切換成 45°,也就是目前縮放等級和可視區域中有 45° 圖像可用時,如果無法提供 45° 圖像,就會切換回 0 (此為預設行為)。45° 圖像僅適用於某些地點內的 satellitehybrid 地圖類型,以及某些縮放等級。注意: getTilt 會傳回目前的傾斜角度,而非這個選項指定的值。由於 getTilt 和這個選項指不同的事物,因此請勿 bind() tilt 屬性,這麼做可能會產生無法預測的影響。
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" map-id="string" 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>
innerMap
類型:  Map
對 MapElement 在內部使用的 Map 參照。
mapId
類型:  string optional
地圖的地圖 ID。詳情請參閱地圖 ID 說明文件
HTML 屬性:
  • <gmp-map map-id="string"></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 位置。
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
初始的地圖中心。
mapId optional
類型:  string optional
地圖的地圖 ID。在地圖例項化後,就無法設定或變更這個參數。
zoom optional
類型:  number optional
初始地圖縮放等級。有效的縮放值是從零到支援的最大縮放等級所提供的數字。縮放值越大,表示解析度越高。

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 開發人員指南。

沿用: domEventlatLng
沿用: stop

MapTypeId 常數

google.maps.MapTypeId 常數

一般 MapTypes 的 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 識別碼。
  • mapType:要新增至登錄檔的 MapType|* 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 介面

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

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