對應 類別
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 |
要疊加的其他地圖類型。疊加層地圖類型會顯示在所附加的基本地圖上方,順序與在 overlayMapTypes 陣列中的顯示順序相同 (索引值較高的疊加層會顯示在索引值較低的疊加層前面)。 |
方法 | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) 參數:
傳回值:無
設定檢視區包含指定的界限。 注意:當地圖設為 display: none 時,fitBounds 函式會將地圖的大小讀取為 0x0,因此不會執行任何操作。如要在隱藏地圖時變更可視區域,請將地圖設為 visibility: hidden ,確保地圖 div 設有實際大小。對於向量地圖,此方法會將地圖的傾斜和方向角度設為預設的零值。呼叫這個方法可能會讓地圖在平移及縮放符合邊界時,可能會呈現平滑的動畫。這個方法的動畫效果是否取決於內部經驗法則。 |
getBounds |
getBounds() 參數:無
傳回值:
LatLngBounds|undefined 目前可視區域的經緯度邊界。傳回目前檢視區的經、緯界限。如果可以看到世界上的多個副本,則從經度到 180 度的範圍介於經度之間 (包括 -180 到 180 度)。如果尚未初始化或置中,且尚未設定縮放功能,則結果為 undefined 。如果是具有非零傾斜或方向的向量地圖,傳回的 lat/lng 邊界代表最小的邊框,範圍包含地圖可視區域的可見區域。如要瞭解地圖可視區域的確切顯示區域,請參閱 MapCanvasProjection.getVisibleRegion 。 |
getCenter |
getCenter() 參數:無
傳回值:
LatLng|undefined |
getClickableIcons |
getClickableIcons() 參數:無
傳回值:
boolean|undefined 傳回地圖圖示的可點擊性。地圖圖示代表搜尋點,又稱為搜尋點。如果傳回值為 true ,則圖示可在地圖上點選。 |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) 參數:
傳回值:
FeatureLayer 傳回指定 datasetId 的 FeatureLayer 。您必須在 Google Cloud 控制台中設定資料集 ID。如果資料集 ID 未與地圖的地圖樣式建立關聯,或者無法使用資料導向樣式 (沒有地圖 ID、沒有向量圖塊、沒有地圖樣式中的地圖項目圖層或資料集),則此記錄就會記錄錯誤,而產生的 FeatureLayer.isAvailable 為 false。 |
getDiv |
getDiv() 參數:無
傳回值:
HTMLElement 地圖的 mapDiv. |
getFeatureLayer |
getFeatureLayer(featureType) 參數:
傳回值:
FeatureLayer 傳回特定 FeatureType 的 FeatureLayer 。您必須在 Google Cloud 控制台中啟用 FeatureLayer 。如果這個地圖上沒有指定 FeatureType 的 FeatureLayer ,或是無法使用資料導向樣式 (沒有地圖 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) 參數:
傳回值:無
根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度,移動時會產生平順的動畫感。請注意,地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。 |
panTo |
panTo(latLng) 參數:
傳回值:無
將地圖的中心變更為指定的 LatLng 。如果所進行的變動同時小於地圖的寬度和高度,移動時會產生平順的動畫感。 |
panToBounds |
panToBounds(latLngBounds[, padding]) 參數:
傳回值:無
以包含指定 LatLngBounds 所需的最低門檻平移地圖。這樣做無法保證地圖上的邊界會位於何處,但地圖會平移以盡可能顯示在 {currentMapSizeInPx} - {padding} 中的邊界。在光柵地圖和向量地圖上,地圖的縮放、傾斜度和方向都將維持不變。 |
setCenter |
setCenter(latlng) 參數:
傳回值:無
|
setClickableIcons |
setClickableIcons(value) 參數:
傳回值:無
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點,又稱為搜尋點。如要停用地圖圖示的可點擊性,請將 false 的值傳遞至此方法。 |
setHeading |
setHeading(heading) 參數:
傳回值:無
設定地圖的指南針方向,以度為單位從北方位角度測量所得的結果。針對光柵地圖,此方法僅適用於空照圖像。 |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) 參數:
傳回值:無
設定是否啟用標題互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。 |
setMapTypeId |
setMapTypeId(mapTypeId) 參數:
傳回值:無
|
setOptions |
setOptions(options) 參數:
傳回值:無
|
setRenderingType |
setRenderingType(renderingType) 參數:
傳回值:無
設定地圖目前的 RenderingType。 |
setStreetView |
setStreetView(panorama) 參數:
傳回值:無
將 StreetViewPanorama 繫結至地圖。此全景會覆寫預設的 StreetViewPanorama ,讓地圖可以繫結至地圖外的外部全景。將全景設定為 null ,會將預設的內嵌全景繫結回地圖。 |
setTilt |
setTilt(tilt) 參數:
傳回值:無
針對向量地圖,設定地圖的入射角。允許的值視地圖的縮放等級而定。 針對光柵地圖,控制地圖方位角的自動切換行為。唯一允許的值為 0 和 45 。setTilt(0) 會一律使用 0° 的俯視檢視畫面,無論縮放等級和可視區域為何。setTilt(45) 會使目前的縮放等級和可視區域有 45° 圖像時,將傾斜角度自動切換為 45,且當 45° 圖像無法使用時,會切換回 0 (預設行為)。45° 圖像僅適用於部分地點內及特定縮放等級的 satellite 和 hybrid 地圖類型,注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTilt 和 setTilt 參照不同內容,因此請勿對 tilt 屬性執行 bind() 。這可能會產生無法預期的影響。 |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) 參數:
傳回值:無
設定是否要啟用傾斜互動功能。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。 |
setZoom |
setZoom(zoom) 參數:
傳回值:無
設定地圖的縮放等級。 |
沿用:
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() 引數:無
當地圖縮放等級的屬性變更後,會引發此事件。 |
|
function(event) 引數:
當使用者在地圖上按一下右鍵時,會引發此事件。 |
MapOptions 介面
google.maps.MapOptions
介面
MapOptions 物件,用來定義可以在地圖上設定的屬性。
屬性 | |
---|---|
backgroundColor optional |
類型:
string optional 用於 Map div 的背景顏色。當使用者平移而尚未載入圖塊時,就會看到這個顏色。這個選項需在地圖初始化後才能設定。 |
center optional |
類型:
LatLng|LatLngLiteral optional 初始的地圖中心。 |
clickableIcons optional |
類型:
boolean optional 預設:
true 如果設為 false ,地圖圖示將無法點選。地圖圖示代表搜尋點,又稱為搜尋點。 |
colorScheme optional |
類型:
ColorScheme|string optional 初始的地圖色彩配置。這個選項需在地圖初始化後才能設定。 |
controlSize optional |
類型:
number optional 地圖上顯示控制項的大小 (以像素為單位)。建立地圖時必須直接提供這個值,之後更新這個值可能會導致控制項進入 undefined 狀態。僅管理 Maps API 本身建立的控制項。不會調整開發人員建立自訂控制項的資源。 |
disableDefaultUI optional |
類型:
boolean optional 啟用/停用所有預設 UI 按鈕。可以個別覆寫。系統不會停用鍵盤控制項 (由 MapOptions.keyboardShortcuts 選項個別控制)。不會停用手勢控制項,這由 MapOptions.gestureHandling 選項另外控制。 |
disableDoubleClickZoom optional |
類型:
boolean 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 如何處理地圖上的手勢。允許的值:
|
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 的內容。 |
|
類型:
boolean 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 ,會停用使用滑鼠滾輪縮放地圖的功能。系統預設會啟用滾輪。注意:我們不建議使用這項屬性。如要停用滾輪縮放功能,您可以使用 |
streetView optional |
類型:
StreetViewPanorama optional 在地圖上拖放街景服務衣夾人時,會顯示 StreetViewPanorama 。如果未指定全景,當拖曳衣夾人時,預設的 StreetViewPanorama 會顯示在地圖的 div 中。 |
streetViewControl optional |
類型:
boolean optional 街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設 UI 的一部分,而且在顯示地圖類型時,應設為 false ,但不應顯示街景服務道路疊加層 (例如非 Google 地球地圖類型)。 |
streetViewControlOptions optional |
類型:
StreetViewControlOptions optional 街景服務衣夾人控制項的初始顯示選項。 |
styles optional |
類型:
Array<MapTypeStyle> optional 要套用至各個預設地圖類型的樣式。請注意,針對 satellite /hybrid 和 terrain 模式,這些樣式只會套用至標籤和幾何圖形。使用地圖 ID 或使用向量地圖時,無法使用這項功能 (請改用雲端式地圖樣式設定)。 |
tilt optional |
類型:
number optional 針對向量地圖,設定地圖的入射角。允許的值視地圖的縮放等級而定。至於光柵地圖,控制自動切換行為以地圖方位角為準。唯一允許的值為 0 和 45 。無論縮放等級和可視區域為何,0 值都會使地圖一律使用 0° 的俯視檢視畫面。當目前的縮放等級和可視區域有 45° 圖像可用時,45 值會導致傾斜角度自動切換為 45。此外,當 45° 圖像沒有可用時,傾斜角度會變回 0 (預設行為)。45° 圖像僅適用於部分地點內及特定縮放等級的 satellite 和 hybrid 地圖類型,注意: 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 屬性:
|
headingInteractionDisabled |
類型:
boolean optional 預設:
false 地圖是否應允許使用者控制攝影機方向 (旋轉)。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
HTML 屬性:
|
innerMap |
類型:
Map MapElement 內部使用的 Map 參照。 |
mapId |
類型:
string optional 地圖的地圖 ID。在地圖例項化之後,無法設定或變更此參數。
Map.DEMO_MAP_ID 可用於試用需要地圖 ID,但不需要雲端啟用的功能。HTML 屬性:
|
renderingType |
類型:
RenderingType optional 地圖必須是光柵地圖或向量地圖。在地圖例項化之後,無法設定或變更此參數。如未設定,地圖 ID 的雲端設定會決定算繪類型 (如果有的話)。請注意,部分裝置和瀏覽器可能無法使用向量地圖,因此如有需要,地圖會改回使用光柵地圖。
HTML 屬性:
|
tiltInteractionDisabled |
類型:
boolean optional 預設:
false 指出地圖是否應允許使用者控制攝影機傾斜。只有在地圖為向量地圖時,這個選項才會生效。如果未在程式碼中設定,系統會使用地圖 ID 的雲端設定 (如有)。
HTML 屬性:
|
zoom |
類型:
number optional 地圖的縮放等級。有效的縮放值是從零到支援的最大縮放等級數字,較大的縮放值對應較高的解析度。
HTML 屬性:
|
方法 | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) 參數:
傳回值:
void 設定每次指定事件傳送至目標時要呼叫的函式。請參閱 addEventListener |
removeEventListener |
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 |
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 |
要套用至所選地圖項目和元素的樣式規則。系統會依照您在這個陣列中指定的順序套用規則。如需使用和允許值的規範,請參閱樣式參考資料。 |
elementType optional |
類型:
string optional 樣式工具應套用的元素。元素是地圖上地圖項目的視覺元素,例如:標籤、圖示、套用到幾何圖形的筆觸或填滿等。選用設定。如未指定 elementType ,系統會假設該值為 'all' 。如要進一步瞭解用法和允許值,請參閱樣式參考資料。 |
featureType optional |
類型:
string optional |
MapMouseEvent 介面
google.maps.MapMouseEvent
介面
這個物件是從地圖以及疊加層上的各種 mouse 事件傳回的,而且包含以下顯示的所有欄位。
屬性 | |
---|---|
domEvent |
對應的原生 DOM 事件。開發人員不應仰賴 target 、currentTarget 、relatedTarget 和 path 屬性的定義並保持一致。開發人員也不應該依賴 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) 參數:
傳回值:無
設定登錄檔,以建立傳送的字串識別項與傳送的 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-styling 和 https://goo.gle/gmp-FeatureLayerIsAvailable。 |
isWebGLOverlayViewAvailable optional |
類型:
boolean optional 如果為 true,此地圖已正確設定,允許使用 WebGLOverlayView 。 |