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> 新增至對應到 ControlPosition 的 MVCArray 。 |
data |
類型:
Data Data 的例項,繫結至地圖。在這個 Data 物件中新增地圖項目,以便在地圖上輕鬆顯示。 |
mapTypes |
類型:
MapTypeRegistry MapType 例項的登錄檔 (依字串 ID)。 |
overlayMapTypes |
要疊加的其他地圖類型。疊加層地圖類型會顯示在所附加的基本地圖上方,順序與在 overlayMapTypes 陣列中的顯示順序相同 (索引值較高的疊加層會顯示在索引值較低的疊加層前方)。 |
方法 | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) 參數:
傳回值:None
設定檢視區包含指定的界限。 注意:地圖設為 display: none 時,fitBounds 函式會將地圖的大小讀取為 0x0,因此不會執行任何動作。如要在隱藏地圖時變更可視區域,請將地圖設為 visibility: hidden ,藉此確保地圖 div 包含實際大小。對向量地圖而言,這個方法會將地圖的傾斜和方向設為預設值 0。呼叫此方法可讓地圖在平移和縮放以符合邊界時流暢的動畫效果。此方法是否動畫取決於內部經驗法則。 |
getBounds |
getBounds() 參數:無
傳回值:
LatLngBounds|undefined 目前可視區域的經緯度邊界。傳回目前檢視區的經、緯界限。如果系統顯示多個世界副本,邊界範圍會以介於 -180 到 180 度 (含首尾) 之間的範圍表示。如果地圖尚未初始化或中心點且未設定縮放,則結果為 undefined 。如果是具有非零傾斜或方向的向量地圖,傳回的 lat/lng 邊界代表範圍最小,其中包含地圖可視區域的可見區域。請參閱 MapCanvasProjection.getVisibleRegion ,瞭解地圖可視區域的確切可見區域。 |
getCenter |
getCenter() 參數:無
傳回值:
LatLng|undefined |
getClickableIcons |
getClickableIcons() 參數:無
傳回值:
boolean|undefined 傳回地圖圖示的可點擊屬性。地圖圖示代表搜尋點,又稱為搜尋點。如果傳回的值為 true ,則圖示在地圖上可供點擊。 |
|
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 。 |
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) 參數:
傳回值:None
根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度,移動時會產生平順的動畫感。請注意,地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。 |
panTo |
panTo(latLng) 參數:
傳回值:None
將地圖的中心變更為指定的 LatLng 。如果所進行的變動同時小於地圖的寬度和高度,移動時會產生平順的動畫感。 |
panToBounds |
panToBounds(latLngBounds[, padding]) 參數:
傳回值:None
根據所需的最低程度平移地圖,以包含指定的 LatLngBounds 。這無法保證地圖上的邊界會位於何處,唯一差別在於地圖會經過平移,盡可能在 {currentMapSizeInPx} - {padding} 內顯示最大的邊界。光柵地圖和向量地圖都不會變更地圖的縮放、傾斜和方向設定。 |
setCenter |
setCenter(latlng) 參數:
傳回值:None
|
setClickableIcons |
setClickableIcons(value) 參數:
傳回值:None
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點,又稱為搜尋點。如要停用地圖圖示的可點擊屬性,請將 false 的值傳遞至這個方法。 |
setHeading |
setHeading(heading) 參數:
傳回值:None
設定地圖的指南針方向,以度為單位從北方位處以度為單位。在光柵地圖中,這個方法僅適用於空照圖像。 |
setMapTypeId |
setMapTypeId(mapTypeId) 參數:
傳回值:None
|
setOptions |
setOptions(options) 參數:
傳回值:None
|
setStreetView |
setStreetView(panorama) 參數:
傳回值:None
將 StreetViewPanorama 繫結至地圖。此全景會覆寫預設的 StreetViewPanorama ,讓地圖可以連結至地圖外的外部全景。將全景設為 null 會將預設的內嵌全景繫結回地圖。 |
setTilt |
setTilt(tilt) 參數:
傳回值:None
針對向量地圖,請設定地圖的入射角。允許的值取決於地圖的縮放等級。如果是光柵地圖,可控制地圖連續角度的自動切換行為。唯一允許的值為 0 和 45 。setTilt(0) 會使地圖一律使用 0° 俯瞰視圖,無論縮放等級和可視區域為何。setTilt(45) 會在目前的縮放等級和可視區域可取得 45° 圖像時,自動將傾斜角度切換為 45 度,並在沒有 45° 圖像時切換為 0 (這是預設行為)。45° 圖像僅適用於部分地點內和某些縮放等級的 satellite 和 hybrid 地圖類型。注意: getTilt 會傳回目前的傾斜角度,而非 setTilt 設定的值。由於 getTilt 和 setTilt 代表不同的事物,因此不要 bind() tilt 屬性,否則可能會產生無法預測的影響。 |
setZoom |
setZoom(zoom) 參數:
傳回值:None
設定地圖的縮放等級。 |
繼承:
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 用於地圖 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 連按兩下啟用/停用縮放和中心。預設啟用。 注意:我們不建議使用這項屬性。如要停用按兩下縮放功能,您可以使用 |
|
類型:
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 由北方位基點以順時針方向繞某一角度所取得的空照圖像方向。方向會貼齊包含圖像的最近可用角度。 |
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 的內容。 |
|
類型:
boolean 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 ,則停用滑鼠滾輪在地圖上縮放功能。系統預設會啟用滑輪。注意:我們不建議使用這項屬性。如要停用滾輪縮放功能,您可以使用 |
streetView optional |
類型:
StreetViewPanorama optional 在地圖上拖放街景服務衣夾人時,會顯示 StreetViewPanorama 。如果未指定全景,當拖曳衣夾人時,地圖的 div 會顯示預設的 StreetViewPanorama 。 |
streetViewControl optional |
類型:
boolean optional 街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設使用者介面的一部分,顯示時不應顯示「街景服務」道路疊加層的地圖類型 (例如非地球地圖類型),應設為 false 。 |
streetViewControlOptions optional |
類型:
StreetViewControlOptions optional 街景服務衣夾人控制項的初始顯示選項。 |
styles optional |
類型:
Array<MapTypeStyle> optional 要套用至各個預設地圖類型的樣式。請注意,在 satellite /hybrid 和 terrain 模式中,這些樣式僅適用於標籤和幾何圖形。 |
tilt optional |
類型:
number optional 針對向量地圖,請設定地圖的入射角。允許的值取決於地圖的縮放等級。如果是光柵地圖,可控制地圖連續角度的自動切換行為。唯一允許的值為 0 和 45 。這個值 0 會使地圖一律使用 0° 俯瞰檢視畫面,無論縮放等級和可視區域為何。當目前的縮放等級和可視區域可取得 45° 圖像時,45 值會讓傾斜角度自動切換至 45 度,並在沒有 45° 圖像時切換為 0 (這是預設行為)。45° 圖像僅適用於部分地點內和某些縮放等級的 satellite 和 hybrid 地圖類型。注意: 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 屬性:
|
innerMap |
類型:
Map MapElement 內部使用的 Map 參照。 |
mapId |
類型:
string optional 地圖的地圖 ID。詳情請參閱地圖 ID 說明文件。
HTML 屬性:
|
zoom |
類型:
number optional 地圖的縮放等級。
HTML 屬性:
|
方法 | |
---|---|
|
addEventListener(type, listener[, options]) 參數:
傳回值:
void 設定函式,當指定事件傳送至目標時,就會呼叫函式。請參閱 addEventListener |
|
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 |
套用至所選地圖項目和元素的樣式規則。系統會依照您在這個陣列中指定的順序套用規則。如需使用方法和允許值的規範,請參閱樣式參考資料。 |
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 「點擊」可能有 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 開發人員指南。 |
繼承:
domEvent 、latLng
|
方法 | |
---|---|
已沿用:
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) 參數:
傳回值:None
設定登錄檔,以建立傳送的字串識別項與傳送的 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) 參數:
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 null ,系統就會移除圖層。 |
setOptions |
setOptions(options) 參數:
傳回值:None
|
繼承:
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) 參數:
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 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) 參數:
傳回值:None
在指定的地圖上呈現圖層。如果地圖設為 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。 |