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 不適用於正式版應用程式,也無法用於需要雲端設定的功能 (例如雲端樣式)。
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 冪等。
傳回值:None
設定檢視區包含指定的界限。
注意:地圖設為 display: none 時,fitBounds 函式會將地圖的大小讀取為 0x0,因此不會執行任何動作。如要在隱藏地圖時變更可視區域,請將地圖設為 visibility: hidden,藉此確保地圖 div 包含實際大小。對向量地圖而言,這個方法會將地圖的傾斜和方向設為預設值 0。呼叫此方法可讓地圖在平移和縮放以符合邊界時流暢的動畫效果。此方法是否動畫取決於內部經驗法則。
getBounds
getBounds()
參數:
傳回值:  LatLngBounds|undefined目前可視區域的經緯度邊界。
傳回目前檢視區的經、緯界限。如果系統顯示多個世界副本,邊界範圍會以介於 -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
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
getZoom
getZoom()
參數:
傳回值:  number|undefined
傳回地圖的縮放等級。如未設定縮放等級,結果會是 undefined
moveCamera
moveCamera(cameraOptions)
參數: 
傳回值:None
立即將地圖的相機設為目標相機選項,不含動畫。
panBy
panBy(x, y)
參數: 
  • xnumber往 x 方向移動地圖的像素數量。
  • ynumber y 方向移動地圖的像素數量。
傳回值:None
根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度,移動時會產生平順的動畫感。請注意,地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。
panTo
panTo(latLng)
參數: 
傳回值:None
將地圖的中心變更為指定的 LatLng。如果所進行的變動同時小於地圖的寬度和高度,移動時會產生平順的動畫感。
panToBounds
panToBounds(latLngBounds[, padding])
參數: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral 要平移的地圖範圍。
  • paddingnumber|Padding optional 邊框間距 (以像素為單位)。數字值會在所有 4 邊產生相同的邊框間距。預設值為 0。
傳回值:None
根據所需的最低程度平移地圖,以包含指定的 LatLngBounds。這無法保證地圖上的邊界會位於何處,唯一差別在於地圖會經過平移,盡可能在 {currentMapSizeInPx} - {padding} 內顯示最大的邊界。光柵地圖和向量地圖都不會變更地圖的縮放、傾斜和方向設定。
setCenter
setCenter(latlng)
參數: 
傳回值:None
setClickableIcons
setClickableIcons(value)
參數: 
  • valueboolean
傳回值:None
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點,又稱為搜尋點。如要停用地圖圖示的可點擊屬性,請將 false 的值傳遞至這個方法。
setHeading
setHeading(heading)
參數: 
  • headingnumber
傳回值:None
設定地圖的指南針方向,以度為單位從北方位處以度為單位。在光柵地圖中,這個方法僅適用於空照圖像。
setMapTypeId
setMapTypeId(mapTypeId)
參數: 
傳回值:None
setOptions
setOptions(options)
參數: 
傳回值:None
setStreetView
setStreetView(panorama)
參數: 
傳回值:None
StreetViewPanorama 繫結至地圖。此全景會覆寫預設的 StreetViewPanorama,讓地圖可以連結至地圖外的外部全景。將全景設為 null 會將預設的內嵌全景繫結回地圖。
setTilt
setTilt(tilt)
參數: 
  • tiltnumber
傳回值:None
針對向量地圖,請設定地圖的入射角。允許的值取決於地圖的縮放等級。如果是光柵地圖,可控制地圖連續角度的自動切換行為。唯一允許的值為 045setTilt(0) 會使地圖一律使用 0° 俯瞰視圖,無論縮放等級和可視區域為何。setTilt(45) 會在目前的縮放等級和可視區域可取得 45° 圖像時,自動將傾斜角度切換為 45 度,並在沒有 45° 圖像時切換為 0 (這是預設行為)。45° 圖像僅適用於部分地點內和某些縮放等級的 satellitehybrid 地圖類型。注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTiltsetTilt 代表不同的事物,因此不要 bind() tilt 屬性,否則可能會產生無法預測的影響。
setZoom
setZoom(zoom)
參數: 
  • zoomnumber變大的縮放值對應較高的解析度。
傳回值:None
設定地圖的縮放等級。
繼承: 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
用於地圖 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,請勿清除地圖 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。如果未指定全景,當拖曳衣夾人時,地圖的 div 會顯示預設的 StreetViewPanorama
streetViewControl optional
類型:  boolean optional
街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設使用者介面的一部分,顯示時不應顯示「街景服務」道路疊加層的地圖類型 (例如非地球地圖類型),應設為 false
streetViewControlOptions optional
類型:  StreetViewControlOptions optional
街景服務衣夾人控制項的初始顯示選項。
styles optional
類型:  Array<MapTypeStyle> optional
要套用至各個預設地圖類型的樣式。請注意,在 satellite/hybridterrain 模式中,這些樣式僅適用於標籤和幾何圖形。
tilt optional
類型:  number optional
針對向量地圖,請設定地圖的入射角。允許的值取決於地圖的縮放等級。如果是光柵地圖,可控制地圖連續角度的自動切換行為。唯一允許的值為 045。這個值 0 會使地圖一律使用 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 中的程式庫

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接收通知的物件。這必須是函式或含有 processEvent 方法的物件
  • 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「點擊」可能有 KeyboardEvent 類型的 domEvent)。
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 常數

一般 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 物件。
傳回值:None
設定登錄檔,以建立傳送的字串識別項與傳送的 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)
參數: 
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 null,系統就會移除圖層。
setOptions
setOptions(options)
參數: 
傳回值:None
繼承: 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)
參數: 
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 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)
參數: 
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 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