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])
參數： 
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 的內部插槽。
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」。
gmp-zoomchange
function(event)
引數： 
當地圖縮放等級的屬性變更後，會引發此事件。

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])
參數： 
在指定的 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，地圖上的圖示即可點選。
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
參數： 
  • datasetId：string
傳回值：  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，或無法使用資料驅動樣式 (沒有地圖 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)
參數： 
傳回值：無
立即將地圖的攝影機設為目標攝影機選項，不使用動畫。
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
傳回值：無
控制地圖圖示是否可點選。地圖圖示代表搜尋點 (POI)。如要停用地圖圖示的點擊功能，請將 false 值傳遞至這個方法。
setHeading
setHeading(heading)
參數： 
  • heading：number
傳回值：無
設定地圖的指南針方向，以正北方為起點，角度按順時針轉動。如果是光柵地圖，這個方法僅適用於空照圖像。
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
參數： 
  • headingInteractionEnabled：boolean
傳回值：無
設定是否啟用標題互動功能。只有在向量地圖中，這個選項才會生效。如果未在程式碼中設定，系統會使用地圖 ID 的雲端設定 (如有)。
setMapTypeId
setMapTypeId(mapTypeId)
參數： 
傳回值：無
setOptions
setOptions(options)
參數： 
傳回值：無
setRenderingType
setRenderingType(renderingType)
參數： 
傳回值：無
設定地圖目前的 RenderingType。
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 屬性，否則可能會產生無法預測的效果。
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)
引數： 
使用者點選地圖時，系統會觸發這項事件。除非點選的是地點圖示，否則系統會傳回具有點選位置屬性的 MapMouseEvent；如果點選的是地點圖示，則會傳回具有地點 ID 的 IconMouseEvent。IconMouseEvent 和 MapMouseEvent 相同，但 IconMouseEvent 具有地點 ID 欄位。如果地點 ID 不重要，事件一律可視為 MapMouseEvent。如果點選的是標記或資訊視窗，系統不會觸發點擊事件。
contextmenu
function(event)
引數： 
地圖容器引發 DOM contextmenu 事件時，會引發此事件。
dblclick
function(event)
引數： 
使用者在地圖上按兩下時，系統會觸發這個事件。請注意，點擊事件有時會在這個事件之前觸發一次，有時則會觸發兩次。
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)
引數： 
當使用者的滑鼠移動至地圖容器時，會引發此事件。
mouseout
function(event)
引數： 
當使用者的滑鼠離開地圖容器時，會引發此事件。
mouseover
function(event)
引數： 
當使用者的滑鼠進入地圖容器時，會引發此事件。
projection_changed
function()
引數：無
當投影變更後，會引發此事件。
renderingtype_changed
function()
引數：無
當 renderingType 變更時，就會觸發這個事件。
tilesloaded
function()
引數：無
所有可見的地圖方塊完成載入之後，就會引發這個事件。
tilt_changed
function()
引數：無
當地圖斜率屬性變更後，會引發此事件。
zoom_changed
function()
引數：無
當地圖縮放等級的屬性變更後，會引發此事件。
rightclick
function(event)
引數： 
當使用者在 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
類型：  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
類型：  boolean optional
「平移」控制項的啟用/停用狀態。
panControlOptions optional
類型：  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
對應的原生 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
設定後，使用者只能在指定界線內平移及縮放。範圍可限制經緯度，或僅限制緯度。如要使用僅限緯度的界線，請分別使用 -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])
參數： 
顯示目前路況的圖層。
getMap
getMap()
參數：無
傳回值：  Map|null
傳回顯示這個圖層的地圖。
setMap
setMap(map)
參數： 
  • map：Map optional
傳回值：無
在指定的地圖上呈現圖層。如果地圖設為 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 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 介面

用於設定地圖的攝影機選項。
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。