Maps

MapElement class

google.maps.MapElement class

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，可透過 MapElement.innerMap 屬性存取。

自訂元素：
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" 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]) 參數：  options：MapElementOptions optional

屬性
center	類型：  LatLng|LatLngLiteral optional 地圖的中心經緯度。 HTML 屬性： <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled	類型：  boolean optional 預設值： false 地圖是否應允許使用者控制攝影機方向 (旋轉)。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。 HTML 屬性： <gmp-map heading-interaction-disabled></gmp-map>
innerMap	類型：  Map MapElement 在內部使用的 Map 參照。
internalUsageAttributionIds	類型：  Iterable<string> optional 預設值： null 在初始值設定器中新增使用情況歸因 ID，協助 Google 瞭解哪些程式庫和範例對開發人員有幫助，例如標記叢集程式庫的使用情況。如要選擇不傳送使用情況歸因 ID，可以安全地刪除這個屬性，或將值替換為空白字串。系統只會傳送不重複的值。例項化後，系統可能會忽略對這個值的變更。 HTML 屬性： <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId	類型：  string optional 地圖的地圖 ID。地圖例項建立後，就無法設定或變更這個參數。Map.DEMO_MAP_ID 可用於試用需要地圖 ID 的功能，但不需要啟用雲端功能。 HTML 屬性： <gmp-map map-id="string"></gmp-map>
renderingType	類型：  RenderingType optional 預設值： RenderingType.VECTOR 地圖應為光柵地圖或向量地圖。地圖例項建立後，就無法設定或變更這個參數。如未設定，地圖 ID 的雲端設定會決定算繪類型 (如有)。請注意，向量地圖可能不適用於所有裝置和瀏覽器，地圖會視需要還原為光柵地圖。 HTML 屬性： <gmp-map rendering-type="vector"></gmp-map> <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled	類型：  boolean optional 預設值： false 地圖是否應允許使用者控制攝影機傾斜角度。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。 HTML 屬性： <gmp-map tilt-interaction-disabled></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 位置。
default	您可以使用自訂元素，圍繞 Maps JavaScript 網頁元件 (例如 AdvancedMarkerElement) 建立可重複使用的元件。根據預設，直接新增至 MapElement 的任何自訂元素都會在 MapPanes.overlayMouseTarget 中插入及算繪。不過，Maps JavaScript API 網頁元件可能會重新插入 MapElement 的內部插槽。

方法
addEventListener	addEventListener(type, listener[, options]) 參數：  type：string代表要監聽的事件類型，且區分大小寫。 listener：EventListener|EventListenerObject接收通知的物件。這必須是函式或包含 handleEvent 方法的物件 options：boolean|AddEventListenerOptions optional請參閱選項。自訂事件僅支援 capture 和 passive。 傳回值：  void 設定函式，每當指定事件傳送至目標時，系統就會呼叫該函式。請參閱 addEventListener。
removeEventListener	removeEventListener(type, listener[, options]) 參數：  type：string這個字串會指定要移除事件監聽器的事件類型。 listener：EventListener|EventListenerObject要從事件目標移除的事件處理常式事件監聽器。 options：boolean|EventListenerOptions optional請參閱選項。 傳回值：  void 從目標中移除先前透過 addEventListener 註冊的事件監聽器。請參閱「removeEventListener」。

事件
gmp-zoomchange	function(event) 引數：  event：ZoomChangeEvent 當地圖縮放等級的屬性變更後，會引發此事件。

MapElementOptions interface

google.maps.MapElementOptions 介面

MapElementOptions 物件，用於定義可在 MapElement 上設定的屬性。

屬性
center optional	類型：  LatLng|LatLngLiteral optional 詳情請參閱《MapElement.center》。
headingInteractionDisabled optional	類型：  boolean optional 詳情請參閱《MapElement.headingInteractionDisabled》。
internalUsageAttributionIds optional	類型：  Iterable<string> optional 詳情請參閱《MapElement.internalUsageAttributionIds》。
mapId optional	類型：  string optional 詳情請參閱《MapElement.mapId》。
renderingType optional	類型：  RenderingType optional 詳情請參閱《MapElement.renderingType》。
tiltInteractionDisabled optional	類型：  boolean optional 詳情請參閱《MapElement.tiltInteractionDisabled》。
zoom optional	類型：  number optional 詳情請參閱《MapElement.zoom》。

ZoomChangeEvent class

google.maps.ZoomChangeEvent class

這項事件是根據監控縮放比例變化建立的。

這個類別會擴充 Event。

撥打 const {ZoomChangeEvent} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

Map 類別

google.maps.Map class

這個類別會擴充 MVCObject。

撥打 const {Map} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
Map	Map(mapDiv[, opts]) 參數：  mapDiv：HTMLElement地圖會填滿這個元素。 opts：MapOptions optional選項 在指定的 HTML 容器 (通常是 DIV 元素) 中建立新的地圖。

常數
DEMO_MAP_ID	地圖 ID，可用於需要地圖 ID 的程式碼範例。這個地圖 ID 不適用於正式版應用程式，也無法用於需要雲端設定的功能 (例如雲端式樣式設定)。

屬性
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，即可讓 fitBounds 在 getBounds 的結果中成為冪等。 傳回值：無 設定檢視區包含指定的界限。 注意：如果地圖設為 display: none，fitBounds 函式會將地圖大小讀取為 0x0，因此不會執行任何動作。如要在隱藏地圖時變更可視區域，請將地圖設為 visibility: hidden，確保地圖 div 具有實際大小。如果是向量地圖，這個方法會將地圖的傾斜角度和方向角度設為預設的零值。呼叫這個方法時，地圖可能會平移和縮放，以配合邊界，並產生流暢的動畫。這個方法是否會產生動畫取決於內部啟發式演算法。
getBounds	getBounds() 參數：無 回傳值：  LatLngBounds|undefined 目前可視區域的緯度/經度界線。 傳回目前檢視區的經、緯界限。如果可見的世界地圖不只一個，經度範圍會介於正負 180 度 (含首尾)。如果地圖尚未初始化，或尚未設定中心和縮放比例，結果會是 undefined。如果是傾斜或航向非零的向量地圖，傳回的經緯度範圍代表包含地圖可視區域可見區域的最小定界框。請參閱 MapCanvasProjection.getVisibleRegion，瞭解如何取得地圖可視區域的確切可見區域。
getCenter	getCenter() 參數：無 傳回值：  LatLng|undefined 傳回地圖中心顯示的位置。請注意，這個 LatLng 物件並未包裝。詳情請參閱 LatLng。如果未設定中心或界線，則結果為 undefined。
getClickableIcons	getClickableIcons() 參數：無 傳回值：  boolean|undefined 傳回地圖圖示的可點擊性。地圖圖示代表搜尋點 (POI)。如果傳回值為 true，地圖上的圖示即可點選。
getDatasetFeatureLayer	注意：僅適用於 v=beta 版。 getDatasetFeatureLayer(datasetId) 參數：  datasetId：string 傳回值：  FeatureLayer 傳回指定 datasetId 的 FeatureLayer。您必須在 Google Cloud 控制台中設定資料集 ID。如果資料集 ID 未與地圖的地圖樣式建立關聯，或無法使用資料導向樣式 (沒有地圖 ID、沒有向量圖塊、沒有在地圖樣式中設定的資料導向樣式特徵圖層或資料集)，系統會記錄錯誤，且產生的 FeatureLayer.isAvailable 會是 false。
getDiv	getDiv() 參數：無 傳回值：  HTMLElement 地圖的 mapDiv。
getFeatureLayer	getFeatureLayer(featureType) 參數：  featureType：FeatureType 傳回值：  FeatureLayer 傳回特定 FeatureType 的 FeatureLayer。您必須在 Google Cloud 控制台中啟用 FeatureLayer。如果地圖上沒有指定的 FeatureType，或無法使用資料驅動樣式 (沒有地圖 ID、沒有向量圖塊，且地圖樣式中未啟用 FeatureLayer)，系統會記錄錯誤，且產生的 FeatureLayer.isAvailable 會是 false。FeatureLayer
getHeading	getHeading() 參數：無 傳回值：  number|undefined 傳回地圖的指南針方向。頂角值是以度為單位，從正北方順時針測量而得。如果地圖尚未初始化，則結果為 undefined。
getHeadingInteractionEnabled	getHeadingInteractionEnabled() 參數：無 傳回值：  boolean|null 傳回是否已啟用標題互動功能。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
getInternalUsageAttributionIds	getInternalUsageAttributionIds() 參數：無 傳回值：  Iterable<string>|null 傳回使用情況歸因 ID 清單，協助 Google 瞭解哪些程式庫和範例對開發人員有幫助，例如標記叢集程式庫的使用情況。
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。
getTiltInteractionEnabled	getTiltInteractionEnabled() 參數：無 傳回值：  boolean|null 傳回是否已啟用傾斜互動。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
getZoom	getZoom() 參數：無 傳回值：  number|undefined 傳回地圖的縮放比例。如果尚未設定縮放比例，結果為 undefined。
moveCamera	moveCamera(cameraOptions) 參數：  cameraOptions：CameraOptions 傳回值：無 立即將地圖的攝影機設為目標攝影機選項，不使用動畫。
panBy	panBy(x, y) 參數：  x：number地圖在 x 方向移動的像素數。 y：number地圖在 y 方向移動的像素數。 傳回值：無 根據指定的距離 (像素) 變更地圖的中心點。如果距離同時小於地圖的寬度和高度，移動時會產生平順的動畫感。請注意，地圖座標系統會由西往東遞增 (x 值) 以及由北往南遞增 (y 值)。
panTo	panTo(latLng) 參數：  latLng：LatLng|LatLngLiteral地圖的新中心緯度/經度。 傳回值：無 將地圖中心變更為指定的 LatLng。如果所進行的變動同時小於地圖的寬度和高度，移動時會產生平順的動畫感。
panToBounds	panToBounds(latLngBounds[, padding]) 參數：  latLngBounds：LatLngBounds|LatLngBoundsLiteral地圖要平移到的邊界。 padding：number|Padding optional以像素為單位的邊框間距。如果提供數字值，則 4 個邊的邊框間距都會相同。預設值為 0。 傳回值：無 將地圖平移至包含指定 LatLngBounds 的最小必要範圍。除了地圖會平移，盡可能在 {currentMapSizeInPx} - {padding} 內顯示範圍外，系統不會保證範圍在地圖上的位置。無論是光柵地圖或向量地圖，地圖的縮放、傾斜和方向都不會改變。
setCenter	setCenter(latlng) 參數：  latlng：LatLng|LatLngLiteral 傳回值：無
setClickableIcons	setClickableIcons(value) 參數：  value：boolean 傳回值：無 控制地圖圖示是否可點選。地圖圖示代表搜尋點 (POI)。如要停用地圖圖示的點擊功能，請將 false 值傳遞至這個方法。
setHeading	setHeading(heading) 參數：  heading：number 傳回值：無 設定地圖的指南針方向，以正北方為起點，角度按順時針轉動。如果是光柵地圖，這個方法僅適用於空照圖像。
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) 參數：  headingInteractionEnabled：boolean 傳回值：無 設定是否啟用標題互動功能。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
setMapTypeId	setMapTypeId(mapTypeId) 參數：  mapTypeId：MapTypeId|string 傳回值：無
setOptions	setOptions(options) 參數：  options：MapOptions optional 傳回值：無
setRenderingType	setRenderingType(renderingType) 參數：  renderingType：RenderingType 傳回值：無 設定地圖目前的 RenderingType。
setStreetView	setStreetView(panorama) 參數：  panorama：StreetViewPanorama optional要繫結至地圖的全景。 傳回值：無 將 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 屬性，否則可能會產生無法預測的效果。
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) 參數：  tiltInteractionEnabled：boolean 傳回值：無 設定是否啟用傾斜互動。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
setZoom	setZoom(zoom) 參數：  zoom：number縮放值越大，解析度越高。 傳回值：無 設定地圖的縮放比例。
已繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

事件
bounds_changed	function() 引數：無 當檢視區界限變更時，會引發此事件。
center_changed	function() 引數：無 當地圖中心的屬性變更時，會引發此事件。
click	function(event) 引數：  event：MapMouseEvent|IconMouseEvent 使用者點選地圖時，系統會觸發這項事件。除非點選的是地點圖示，否則系統會傳回具有點選位置屬性的 MapMouseEvent；如果點選的是地點圖示，則會傳回具有地點 ID 的 IconMouseEvent。IconMouseEvent 和 MapMouseEvent 相同，但 IconMouseEvent 具有地點 ID 欄位。如果地點 ID 不重要，事件一律可視為 MapMouseEvent。如果點選的是標記或資訊視窗，系統不會觸發點擊事件。
contextmenu	function(event) 引數：  event：MapMouseEvent 地圖容器引發 DOM contextmenu 事件時，會引發此事件。
dblclick	function(event) 引數：  event：MapMouseEvent 使用者在地圖上按兩下時，系統會觸發這個事件。請注意，點擊事件有時會在這個事件之前觸發一次，有時則會觸發兩次。
drag	function() 引數：無 當使用者拖曳地圖時，會重複引發此事件。
dragend	function() 引數：無 使用者停止拖曳地圖時，系統會觸發這項事件。注意：使用者透過鍵盤停止平移地圖時，系統不會觸發 dragend。請改用 Map.idle 事件，判斷使用者何時停止平移或拖曳地圖。
dragstart	function() 引數：無 使用者開始拖曳地圖時，會引發此事件。
heading_changed	function() 引數：無 當地圖方向屬性變更後，會引發此事件。
idle	function() 引數：無 當地圖在平移或縮放後閒置時，會引發此事件。
isfractionalzoomenabled_changed	function() 引數：無 當 isFractionalZoomEnabled 屬性變更時，就會觸發這個事件。
mapcapabilities_changed	function() 引數：無 地圖功能變更時，就會觸發這個事件。
maptypeid_changed	function() 引數：無 當 mapTypeId 屬性變更後，會引發此事件。
mousemove	function(event) 引數：  event：MapMouseEvent 當使用者的滑鼠移動至地圖容器時，會引發此事件。
mouseout	function(event) 引數：  event：MapMouseEvent 當使用者的滑鼠離開地圖容器時，會引發此事件。
mouseover	function(event) 引數：  event：MapMouseEvent 當使用者的滑鼠進入地圖容器時，會引發此事件。
projection_changed	function() 引數：無 當投影變更後，會引發此事件。
renderingtype_changed	function() 引數：無 當 renderingType 變更時，就會觸發這個事件。
tilesloaded	function() 引數：無 所有可見的地圖方塊完成載入之後，就會引發這個事件。
tilt_changed	function() 引數：無 當地圖斜率屬性變更後，會引發此事件。
zoom_changed	function() 引數：無 當地圖縮放等級的屬性變更後，會引發此事件。
rightclick	已淘汰：請改用 Map.contextmenu 事件，以支援 macOS 上的 Control 鍵點擊等使用模式。 function(event) 引數：  event：MapMouseEvent 當使用者在 Google 地圖上按下滑鼠右鍵時，系統會觸發這項事件。

MapOptions interface

google.maps.MapOptions 介面

MapOptions 物件，用於定義可在地圖上設定的屬性。

屬性
backgroundColor optional	類型：  string optional 地圖 div 的背景顏色。如果圖塊尚未載入，使用者平移時就會看到這個顏色。這個選項需在地圖初始化後才能設定。
cameraControl optional	類型：  boolean optional 攝影機控制項的啟用/停用狀態。
cameraControlOptions optional	類型：  CameraControlOptions optional 攝影機控制項的顯示選項。
center optional	類型：  LatLng|LatLngLiteral optional 初始的地圖中心。
clickableIcons optional	類型：  boolean optional 預設值： true 如果顯示 false，地圖圖示就無法點選。地圖圖示代表搜尋點 (POI)。
colorScheme optional	類型：  ColorScheme|string optional 預設值： ColorScheme.LIGHT 初始地圖配色。這個選項需在地圖初始化後才能設定。
controlSize optional	類型：  number optional 地圖上顯示的控制項大小 (以像素為單位)。建立地圖時必須直接提供這個值，日後更新這個值可能會導致控制項進入 undefined 狀態。僅控管 Maps API 本身所做的控制項。不會縮放開發人員建立的自訂控制項。
disableDefaultUI optional	類型：  boolean optional 啟用/停用所有預設 UI 按鈕。可個別覆寫。不會停用鍵盤控制項，這類控制項是由 MapOptions.keyboardShortcuts 選項另外控制。不會停用手勢控制功能，這項功能由 MapOptions.gestureHandling 選項另外控制。
disableDoubleClickZoom optional	類型：  boolean optional 連按兩下啟用/停用縮放和中心。預設為啟用。 注意：不建議使用這項屬性。如要停用按兩下縮放功能，可以使用 gestureHandling 屬性，並將其設為 "none"。
draggable optional	已淘汰：已於 2017 年淘汰。如要停用地圖上的拖曳功能，可以使用 gestureHandling 屬性，並將其設為 "none"。 類型：  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 由北方位基點以順時針方向繞某一角度所取得的空照圖像方向。方向會貼齊包含圖像的最近可用角度。
headingInteractionEnabled optional	類型：  boolean optional 預設值： false 地圖是否應允許使用者控制攝影機方向 (旋轉)。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
internalUsageAttributionIds optional	類型：  Iterable<string> optional 預設值： null 在初始值設定器中新增使用情況歸因 ID，協助 Google 瞭解哪些程式庫和範例對開發人員有幫助，例如標記叢集程式庫的使用情況。如要選擇不傳送使用情況歸因 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 初始 Map 的 mapTypeId。預設值為 ROADMAP。
maxZoom optional	類型：  number optional 將可在地圖上顯示的最大縮放等級。如果省略或設為 null，系統會改用目前地圖類型的最大縮放比例。有效縮放值為零到支援的最大縮放等級之間的數字。
minZoom optional	類型：  number optional 將可在地圖上顯示的最小縮放等級。如果省略或設為 null，系統會改用目前地圖類型的最低縮放等級。有效縮放值為零到支援的最大縮放等級之間的數字。
noClear optional	類型：  boolean optional 如果 true，請勿清除 Map div 的內容。
panControl optional	已淘汰：自 2015 年 9 月起，平移控制項已淘汰。 類型：  boolean optional 「平移」控制項的啟用/停用狀態。
panControlOptions optional	已淘汰：自 2015 年 9 月起，平移控制項已淘汰。 類型：  PanControlOptions optional 平移控制項的顯示選項。
renderingType optional	類型：  RenderingType optional 預設值： RenderingType.RASTER 地圖應為光柵地圖或向量地圖。地圖例項建立後，就無法設定或變更這個參數。如未設定，地圖 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，則會停用使用滑鼠滾輪縮放地圖的功能。捲動滾輪預設為啟用。 注意：不建議使用這項屬性。如要停用使用滾輪縮放的功能，可以利用 gestureHandling 屬性，並將其設為 "cooperative" 或 "none"。
streetView optional	類型：  StreetViewPanorama optional StreetViewPanorama：在街景服務衣夾人拖曳到地圖上時顯示。如未指定全景，將 Pegman 放到地圖的 div 時，系統會顯示預設的 StreetViewPanorama。
streetViewControl optional	類型：  boolean optional 街景服務衣夾人控制項的初始啟用/停用狀態。這個控制項是預設 UI 的一部分，顯示不應出現街景道路疊加層的地圖類型 (例如非地球地圖類型) 時，應設為 false。
streetViewControlOptions optional	類型：  StreetViewControlOptions optional 街景服務衣夾人控制項的初始顯示選項。
styles optional	類型：  Array<MapTypeStyle> optional 要套用至各預設地圖類型的樣式。請注意，在 satellite/hybrid 和 terrain 模式下，這些樣式只會套用至標籤和幾何圖形。使用地圖 ID 或向量地圖時，無法使用這項功能 (請改用雲端式地圖樣式設定)。
tilt optional	類型：  number optional 如果是向量地圖，則設定地圖的入射角。允許的值會根據地圖的縮放等級而有所限制。如果是光柵地圖，則控制地圖入射角的自動切換行為。唯一允許的值為 0 和 45。無論縮放等級和可視區域為何，值 0 都會讓地圖一律使用 0° 的俯視角度。如果目前縮放等級和可視區域有 45° 圖像，值 45 會自動將傾斜角度切換為 45°，如果沒有，則會切換回 0° (這是預設行為)。45° 圖像僅適用於 satellite 和 hybrid 地圖類型、部分地點和部分縮放等級。注意： getTilt 會傳回目前的傾斜角度，而非這個選項指定的值。由於 getTilt 和這個選項是指不同的事物，請勿 bind() tilt 屬性，否則可能會產生無法預測的影響。
tiltInteractionEnabled optional	類型：  boolean optional 預設值： false 地圖是否應允許使用者控制攝影機傾斜角度。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
zoom optional	類型：  number optional 地圖的初始縮放等級。有效縮放值為零到支援的最大縮放等級之間的數字。縮放值越大，解析度越高。
zoomControl optional	類型：  boolean optional 縮放控制項的啟用/停用狀態。
zoomControlOptions optional	類型：  ZoomControlOptions 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	類型：  MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event 對應的原生 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 class

google.maps.MapTypeRegistry class

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	類型：  LatLngBounds|LatLngBoundsLiteral 設定後，使用者只能在指定界線內平移及縮放。範圍可限制經緯度，或僅限制緯度。如要使用僅限緯度的界線，請分別使用 -180 和 180 的西經和東經，例如 latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}。
strictBounds optional	類型：  boolean optional 您可以將 strictBounds 旗標設為 true，進一步限制範圍。這樣一來，使用者就無法大幅縮小畫面，確保限制範圍外的所有內容都會隱藏。預設值為 false，表示使用者可以縮小畫面，直到整個有界區域都顯示在畫面上，可能包括有界區域外的區域。

TrafficLayer class

google.maps.TrafficLayer class

路況圖層。

這個類別會擴充 MVCObject。

撥打 const {TrafficLayer} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
TrafficLayer	TrafficLayer([opts]) 參數：  opts：TrafficLayerOptions optional 顯示目前路況的圖層。

方法
getMap	getMap() 參數：無 傳回值：  Map|null 傳回顯示這個圖層的地圖。
setMap	setMap(map) 參數：  map：Map optional 傳回值：無 在指定的地圖上呈現圖層。如果地圖設為 null，圖層就會移除。
setOptions	setOptions(options) 參數：  options：TrafficLayerOptions optional 傳回值：無
已繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

TrafficLayerOptions 介面

google.maps.TrafficLayerOptions 介面

TrafficLayerOptions 物件，用於定義可在 TrafficLayer 上設定的屬性。

屬性
autoRefresh optional	類型：  boolean optional 預設值： true 流量圖層是否會自動重新整理並顯示最新資訊。
map optional	類型：  Map optional 要顯示車流量圖層的地圖。

TransitLayer class

google.maps.TransitLayer class

大眾運輸圖層。

這個類別會擴充 MVCObject。

撥打 const {TransitLayer} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
TransitLayer	TransitLayer() 參數：無 顯示大眾運輸路線的圖層。

方法
getMap	getMap() 參數：無 傳回值：  Map|null 傳回顯示這個圖層的地圖。
setMap	setMap(map) 參數：  map：Map optional 傳回值：  void 在指定的地圖上呈現圖層。如果地圖設為 null，圖層就會移除。
已繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

BicyclingLayer class

google.maps.BicyclingLayer class

顯示單車道的疊加層。

這個類別會擴充 MVCObject。

撥打 const {BicyclingLayer} = await google.maps.importLibrary("maps") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。

建構函式
BicyclingLayer	BicyclingLayer() 參數：無 顯示單車道並降低大道路等級的圖層。

方法
getMap	getMap() 參數：無 傳回值：  Map|null 傳回顯示這個圖層的地圖。
setMap	setMap(map) 參數：  map：Map optional 傳回值：  void 在指定的地圖上呈現圖層。如果地圖設為 null，圖層就會移除。
已繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll

CameraOptions interface

google.maps.CameraOptions 介面

注意：僅適用於 v=beta 版。

用於設定地圖的攝影機選項。

屬性
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。