Map 類別
google.maps.Map
類別
這個類別會擴充 MVCObject
。
呼叫 const {Map} = await google.maps.importLibrary("maps")
即可存取。請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
Map |
Map(mapDiv[, opts]) 參數:
在指定的 HTML 容器中 (通常是 DIV 元素) 建立新的地圖。 |
屬性 | |
---|---|
controls |
類型:
Array<MVCArray<HTMLElement>> 附加至地圖的其他控制項。如要在地圖中加入控制項,請將控制項的 <div> 新增至與應顯示 ControlPosition 的 MVCArray 中。 |
data |
類型:
Data Data 的執行個體,可繫結至地圖。為這個 Data 物件新增地圖項目,以便在地圖上輕鬆顯示這些功能。 |
mapTypes |
類型:
MapTypeRegistry 透過字串 ID 建立 MapType 執行個體的登錄檔。 |
overlayMapTypes |
要疊加的其他地圖類型。疊加層地圖類型會顯示在所附加的基本地圖上方,順序與在 overlayMapTypes 陣列中的顯示順序相同 (索引值較高的疊加層會顯示在索引值較低的疊加層前方)。 |
方法 | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) 參數:
傳回值:無
設定檢視區包含指定的界限。 注意:當地圖設為 display: none 時,fitBounds 函式會讀取地圖的大小為 0x0,因此不會執行任何動作。如要在隱藏地圖時變更可視區域,請將地圖設為 visibility: hidden ,確保地圖 div 具有實際大小。在向量地圖上,此方法會將地圖的傾斜和方向設為預設的零值。呼叫此方法可能會流暢地在地圖平移時縮放畫面,以符合邊界。此方法是否適用內部經驗法則。 |
getBounds |
getBounds() 參數:無
傳回值:
LatLngBounds|undefined 目前可視區域的經緯度邊界。傳回目前檢視區的經、緯界限。如果可以看見多個世界副本,邊界會以 -180 度和 180 度 (含) 為單位。如果地圖尚未初始化或未設定,且尚未設定縮放功能,則結果會是 undefined 。如果向量地圖具有非零傾斜或方向角度,則傳回的經緯度會代表最小的定界框,其中包含地圖可視區域的可見區域。請參閱 MapCanvasProjection.getVisibleRegion ,取得地圖可視區域的確切可見區域。 |
getCenter |
getCenter() 參數:無
傳回價值:
LatLng|undefined |
getClickableIcons |
getClickableIcons() 參數:無
傳回價值:
boolean|undefined 傳回地圖圖示的可點擊屬性。地圖圖示代表搜尋點 (也稱為搜尋點)。如果傳回的值是 true ,則可在地圖上按一下圖示。 |
|
getDatasetFeatureLayer(datasetId) 參數:
傳回價值:
FeatureLayer 傳回指定 datasetId 的 FeatureLayer 。您必須在 Google Cloud 控制台中設定資料集 ID。如果資料集 ID 未與地圖的地圖樣式建立關聯,或是無法使用資料導向樣式 (沒有地圖 ID、沒有向量圖塊、沒有地圖樣式設定的資料圖層或資料集),則系統會記錄錯誤,產生的 FeatureLayer.isAvailable 則會顯示為否。 |
getDiv |
getDiv() 參數:無
傳回值:
HTMLElement mapDiv。 |
getFeatureLayer |
getFeatureLayer(featureType) 參數:
傳回價值:
FeatureLayer 傳回特定 FeatureType 的 FeatureLayer 。您必須在 Google Cloud Console 中啟用 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) 參數:
傳回值:無
立即將地圖的相機設為目標相機選項,且不含動畫。 |
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) 參數:
傳回值:無
設定地圖的指南針方向 (以度為單位,以基數為單位)。光柵地圖僅適用於此方法。 |
setMapTypeId |
setMapTypeId(mapTypeId) 參數:
傳回值:無
|
setOptions |
setOptions(options) 參數:
傳回值:無
|
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 指的是不同的內容,因此請勿bind() tilt 屬性,因為這樣可能會產生無法預測的效果。 |
setZoom |
setZoom(zoom) 參數:
傳回值:無
設定地圖的縮放功能。 |
沿用於:
addListener 、bindTo 、get 、notify 、set 、setValues 、unbind 、unbindAll |
常數 | |
---|---|
DEMO_MAP_ID |
地圖 ID,可用於需要地圖 ID 的程式碼範例。這個地圖 ID 不適用於正式版應用程式,無法用於需要雲端設定的功能 (例如 Cloud 樣式)。 |
事件 | |
---|---|
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) 引數:
使用者按兩下地圖時,會觸發這個事件。請注意,click 事件也會引發,就是在這個事件前面。 |
drag |
function() 引數:無
當使用者拖曳地圖時,會重複引發此事件。 |
dragend |
function() 引數:無
使用者停止拖曳地圖時,會引發此事件。 |
dragstart |
function() 引數:無
使用者開始拖曳地圖時,會引發此事件。 |
heading_changed |
function() 引數:無
當地圖方向屬性變更後,會引發此事件。 |
idle |
function() 引數:無
當地圖在平移或縮放後閒置時,會引發此事件。 |
isfractionalzoomenabled_changed |
function() 引數:無
當 isFracativeZoomEnabled 屬性變更時,會觸發此事件。 |
mapcapabilities_changed |
function() 引數:無
地圖功能變更時,就會觸發這個事件。 |
maptypeid_changed |
function() 引數:無
當 mapTypeId 屬性變更後,會引發此事件。 |
mousemove |
function(event) 引數:
當使用者的滑鼠移動至地圖容器時,會引發此事件。 |
mouseout |
function(event) 引數:
當使用者的滑鼠離開地圖容器時,會引發此事件。 |
mouseover |
function(event) 引數:
當使用者的滑鼠進入地圖容器時,會引發此事件。 |
projection_changed |
function() 引數:無
當投影變更後,會引發此事件。 |
renderingtype_changed |
function() 引數:無
當轉譯類型變更時,會觸發這個事件。 |
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 的內容。 |
panControl optional |
類型:
boolean optional 「平移」控制項的啟用/停用狀態。 注意:Google Maps JavaScript API 3.22 版新推出的控制項組合不支援「平移」控制項。使用 3.22 版和 3.23 版時,您可以選擇使用舊版的控制項,而不使用新的控制項,因此該控制項會成為舊版控制項的一部分。請參閱 3.22 版地圖控制項的新功能。 |
panControlOptions optional |
類型:
PanControlOptions optional 平移控制項的顯示選項。 注意:Google Maps JavaScript API 3.22 版新推出的控制項組合不支援「平移」控制項。使用 3.22 版和 3.23 版時,您可以選擇使用舊版的控制項,而不使用新的控制項,因此該控制項會成為舊版控制項的一部分。請參閱 3.22 版地圖控制項的新功能。 |
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 。 |
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"></gmp-map>
在內部,可透過 innerMap
屬性存取 Map
。
自訂元素:
<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 HTML 屬性:
|
zoom |
類型:
number optional HTML 屬性:
|
方法 | |
---|---|
|
addEventListener(type, listener[, options]) 參數:
傳回價值:
void 設定一個函式,以便在指定事件傳送至目標時呼叫。請參閱 addEventListener |
|
removeEventListener(type, listener[, options]) 參數:
傳回價值:
void 從目標中移除先前透過 addEventListener 註冊的事件監聽器。請參閱 removeEventListener |
MapElementOptions 介面
google.maps.MapElementOptions
介面
用於定義可在 MapElement 中設定的屬性的 MapElementOptions 物件。
屬性 | |
---|---|
center optional |
類型:
LatLng|LatLngLiteral optional 初始的地圖中心。 |
mapId optional |
類型:
string optional 地圖地圖 ID。將地圖執行個體化後,即無法設定或變更這個參數。 |
zoom optional |
類型:
number optional 初始地圖縮放等級。有效縮放值是指從零到支援的最大縮放等級的數字。縮放值越大,解析度越高。 |
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() 方法,以免被傳播。進一步瞭解 Places API 開發人員指南中的地點 ID。
這個介面會擴充 MapMouseEvent
。
屬性 | |
---|---|
placeId optional |
類型:
string optional 使用者點選的地點 ID。這個地點 ID 可用於查詢更多有關已點選功能的資訊。 進一步瞭解 Places API 開發人員指南中的地點 ID。 |
繼承:
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) 參數:
傳回值:無
設定登錄檔,以建立傳送的字串識別項與傳送的 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
介面
包含地圖目前可用功能快照的物件。如需可用功能清單,請參閱屬性。
屬性 | |
---|---|
isAdvancedMarkersAvailable optional |
類型:
boolean optional |
isDataDrivenStylingAvailable optional |
類型:
boolean optional |