Maps

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
類型：  MVCArray<MapType optional>
要疊加的其他地圖類型。疊加層地圖類型會顯示在所附加的基本地圖上方，順序與在 overlayMapTypes 陣列中的顯示順序相同 (索引值較高的疊加層會顯示在索引值較低的疊加層前方)。
fitBounds
fitBounds(bounds[, padding])
參數： 
  • bounds：LatLngBounds|LatLngBoundsLiteral 要顯示的範圍。
  • padding：number|Padding optional 邊框間距 (以像素為單位)。移除邊框間距後，邊界會容納在地圖中。數字的 4 個邊會產生相同的邊框間距。請在此處提供 0，讓 getBounds 對 getBounds 的結果使用冪等。
傳回值：無
設定檢視區包含指定的界限。
注意：當地圖設為 display: none 時，fitBounds 函式會讀取地圖的大小為 0x0，因此不會執行任何動作。如要在隱藏地圖時變更可視區域，請將地圖設為 visibility: hidden，確保地圖 div 具有實際大小。在向量地圖上，此方法會將地圖的傾斜和方向設為預設的零值。呼叫此方法可能會流暢地在地圖平移時縮放畫面，以符合邊界。此方法是否適用內部經驗法則。
getBounds
getBounds()
參數：無
傳回值：  LatLngBounds|undefined目前可視區域的經緯度邊界。
傳回目前檢視區的經、緯界限。如果可以看見多個世界副本，邊界會以 -180 度和 180 度 (含) 為單位。如果地圖尚未初始化或未設定，且尚未設定縮放功能，則結果會是 undefined。如果向量地圖具有非零傾斜或方向角度，則傳回的經緯度會代表最小的定界框，其中包含地圖可視區域的可見區域。請參閱 MapCanvasProjection.getVisibleRegion，取得地圖可視區域的確切可見區域。
getCenter
getCenter()
參數：無
傳回價值：  LatLng|undefined
傳回地圖中心顯示的位置。請注意，這個 LatLng 物件「不會」包裝。詳情請參閱《LatLng》。如果未設定中心或邊界，結果會是 undefined。
getClickableIcons
getClickableIcons()
參數：無
傳回價值：  boolean|undefined
傳回地圖圖示的可點擊屬性。地圖圖示代表搜尋點 (也稱為搜尋點)。如果傳回的值是 true，則可在地圖上按一下圖示。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
參數： 
  • datasetId：string
傳回價值：  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：number 按 x 方向移動地圖的像素數量。
  • y：number 以 y 方向移動地圖的像素數量。
傳回值：無
根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度，移動時會產生平順的動畫感。請注意，地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。
panTo
panTo(latLng)
參數： 
傳回值：無
將地圖中心變更為指定的 LatLng。如果所進行的變動同時小於地圖的寬度和高度，移動時會產生平順的動畫感。
panToBounds
panToBounds(latLngBounds[, padding])
參數： 
  • latLngBounds：LatLngBounds|LatLngBoundsLiteral平移地圖的邊界。
  • padding：number|Padding optional 邊框間距 (以像素為單位)。數字的 4 個邊會產生相同的邊框間距。預設值為 0。
傳回值：無
以包含指定 LatLngBounds 所需的最低程度平移地圖。{currentMapSizeInPx} - {padding}無論是光柵地圖還是向量地圖，地圖的縮放、傾斜和方向都不會變更。
setCenter
setCenter(latlng)
參數： 
傳回值：無
setClickableIcons
setClickableIcons(value)
參數： 
  • value：boolean
傳回值：無
控制地圖圖示是否可供點擊。地圖圖示代表搜尋點 (也稱為搜尋點)。如要停用地圖圖示的可點擊屬性，請將 false 的值傳遞至此方法。
setHeading
setHeading(heading)
參數： 
  • heading：number
傳回值：無
設定地圖的指南針方向 (以度為單位，以基數為單位)。光柵地圖僅適用於此方法。
setMapTypeId
setMapTypeId(mapTypeId)
參數： 
傳回值：無
setOptions
setOptions(options)
參數： 
傳回值：無
setStreetView
setStreetView(panorama)
參數： 
傳回值：無
將 StreetViewPanorama 繫結至地圖。這個全景會覆寫預設的 StreetViewPanorama，讓地圖繫結至地圖外部的外部全景。將全景設定為 null 時，會將預設的內嵌全景繫結至地圖。
setTilt
setTilt(tilt)
參數： 
  • tilt：number
傳回值：無
若為向量地圖，請設定地圖的無效角度。允許的值取決於地圖的縮放等級。如為光柵地圖，控制地圖角度的自動切換行為。僅允許的值為 0 和 45。setTilt(0) 會讓地圖一律使用 0° 的俯瞰檢視畫面，無論縮放等級和可視區域為何。setTilt(45) 會允許目前的縮放等級，在目前的縮放等級和可視區域提供 45° 圖像時，將傾斜角度切換為 45，在沒有可用的 45° 圖像時改回 0 (此為預設行為)。45° 圖像僅適用於部分位置和某些縮放等級的 satellite 和 hybrid 地圖類型。注意： getTilt 會傳回目前的傾斜角度，而非 setTilt 設定的值。由於 getTilt 和 setTilt 指的是不同的內容，因此請勿bind() tilt 屬性，因為這樣可能會產生無法預測的效果。
setZoom
setZoom(zoom)
參數： 
  • zoom：number 縮放值越大，解析度越高。
傳回值：無
設定地圖的縮放功能。
沿用於： 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()
引數：無
當地圖縮放等級的屬性變更後，會引發此事件。
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
「平移」控制項的啟用/停用狀態。

注意：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，則使用滑鼠滾輪停用地圖的縮放功能。系統預設會啟用滾輪。

注意：我們不建議使用這個屬性。如要停用滾輪的縮放功能，您可以使用 gestureHandling 屬性，並將其設為 "cooperative" 或 "none"。
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 屬性：
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
類型：  Map
MapElement 內部使用的 Map 參照。
mapId
類型：  string optional
HTML 屬性：
  • <gmp-map map-id="string"></gmp-map>
zoom
類型：  number optional
HTML 屬性：
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
參數： 
  • type：string (區分大小寫)，表示要監聽的事件類型。
  • listener：EventListener|EventListenerObject接收通知的物件。這必須是包含此 HandleEvent 方法的函式或物件
  • options：boolean|AddEventListenerOptions optional請參閱選項。自訂事件僅支援 capture 和 passive。
傳回價值：  void
設定一個函式，以便在指定事件傳送至目標時呼叫。請參閱 addEventListener
BetaremoveEventListener
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
類型：  Array<Object>
套用至所選地圖項目和元素的樣式規則。規則會按照您在此陣列中指定的順序套用。如需使用指南和允許的值，請參閱樣式參考資料。
elementType optional
類型：  string optional
要套用樣式工具的元素。元素是地圖上地圖項目的視覺呈現。例如：為幾何圖形套用的標籤、圖示、筆觸或填色等等。選用設定。如未指定 elementType，系統會假設值為 'all'。如需用法和允許值的詳細資訊，請參閱樣式參考資料。
featureType optional
類型：  string optional
要套用樣式工具的一或多個功能。選用設定。如未指定 featureType，系統會假設值為 'all'。如需用法和允許值的詳細資訊，請參閱樣式參考資料。

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)
參數： 
  • id：string要在登錄檔中新增 MapType 的 ID。
  • mapType：要新增至登錄檔的 MapType|* 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