Maps JavaScript API 發布說明書

訂閱這些版本資訊。訂閱

Maps JavaScript API 團隊會定期更新 API，包括新增功能、修正錯誤和提升效能。如要指定在應用程式內載入的 API 版本，請使用 Maps JavaScript API Bootstrap 要求的 v 參數。進一步瞭解版本管理。

這份異動記錄會依日期和版本編號列出版本，以及相關異動。

本頁列出 2025 年和 2026 年的版本資訊。如需更早的版本，請參閱 Maps JavaScript API 版本資訊封存。

如要接收新版 Maps API 的更新通知，請訂閱 google-maps-js-api-v3-notify 群組。

3.66.9d

2026 年 10 月 14 日

變更：

  • 修正問題：在 AdvancedMarkerElement 上完成拖曳動作時，會錯誤觸發地圖點擊事件。
  • 修正重新開啟同一個搜尋點後，無法使用 Escape 鍵關閉搜尋點資訊視窗的問題。
  • [alpha channel] AdvancedPlaceDetailsElement、AdvancedPlaceDetailsCompactElement 和 AdvancedPlaceItemElement 現在支援 Alpha 色板中的 basic-section-top 和 basic-section-bottom 槽。
  • [Alpha 版管道] PlacePinElement現已在 Alpha 版管道推出，可在地圖上顯示地點資訊
  • 修正以下問題：地圖為 gmp-map 元素時，InfoWindow 無法使用 Escape 鍵關閉，且焦點不會回到先前聚焦的元素。

3.66.8b

2026 年 10 月 8 日

變更：

  • 修正以下問題：再次點選搜尋點圖示後，無法使用 Escape 鍵關閉搜尋點資訊視窗。
  • 修正鍵盤方向鍵導覽功能會將焦點移至地圖可見區域外的 AdvancedMarkerElement 的問題。
  • [Beta 版] 在 3D 地圖 (Map3DElement) 中新增 MapMode.ROADMAP、地圖模式 UI 控制項、Map3DElement.colorScheme (用於淺色和深色地圖樣式) 和 Label3DElement (<gmp-label-3d>)。

3.66.7

2026 年 10 月 1 日

變更：

  • [Alpha 版] 修正問題：在強制顏色模式下，Route3DElement 彈出式視窗中的大眾運輸車輛圖示會消失。
  • [Alpha 版管道] Route.createWaypointMarkers() 現在會為建立的標記設定本地化的預設 title (「起點」或「目的地」)。
  • [alpha channel] 修正問題：在混合和衛星地圖模式下，Route3DElement彈出式視窗文字不會顯示。
  • [Alpha 版] Route.createWaypointMarkers() 建立的 3D 標記現在會維持固定的螢幕大小 (sizePreserved 預設為 true)。
  • [Alpha 版] Route3DElement 起點和目的地標記現在可透過鍵盤存取，並由螢幕閱讀器朗讀。將滑鼠游標懸停在標記上，標題會顯示為工具提示。
  • [Beta 版] 新增 Map3DElement.maxMemoryMegabytes 和 Map3DElement.qualityMode 屬性，以及 QualityMode 列舉，有助於減少 3D 地圖的記憶體用量。
  • 修正問題：在 Safari 中變更頁面縮放比例時，PopoverElement (<gmp-popover>) 會偏離錨定位置。
  • 透過 gmp-pointerover、gmp-pointerout 和 gmp-pointermove，新增 Maps3D 互動元素的指標事件支援。
  • 修正 3D 地圖繪圖元素 (Marker3DElement、Model3DElement、Polygon3DElement、Polyline3DElement、FlattenerElement、CirclePathElement) 和 PopoverElement 的 TypeScript 定義，以接受 google.maps.LatLng。

3.66.6c

2026 年 9 月 22 日

變更：

  • 修正以下問題：透過建構函式選項或值屬性，以程式輔助方式填入 PlaceAutocompleteElement 時，不會顯示清除按鈕。
  • [alpha channel] 已從 google.maps.routes.RoutePolyline3DOptions 移除 colorScheme。Route3DElement 現在會追蹤父項 Map3D 的有效色彩配置。
  • [Beta 版] 修正街景服務全景算繪生命週期中的記憶體流失問題。
  • [Beta 版] PlaceLinkElement 預設圖示可透過 default-icon-hidden 屬性隱藏，只顯示地點連結文字。

3.66.4d

2026 年 9 月 9 日

變更：

  • [Alpha 版頻道] AutofitsCamera 最小範圍從 2,000 公尺變更為 80 公尺。
  • 淘汰 AdvancedMarkerElement.addListener() 和舊版事件 (click、dragstart、drag、dragend)。請改用標準 addEventListener() 和前置字元為 gmp- 的事件。

3.66.3d

2026 年 9 月 2 日

變更：

  • [Alpha 版] 在 RoutePolyline3DOptions 中新增 trafficPolylinesDisabled 欄位。開發人員可藉此在建立 3D 路線折線時，停用路況感知折線。
  • [Alpha 版管道] 最佳化 Route3DElement，避免在切換 trafficPolylinesDisabled 時，傳送不必要的後端要求。

3.66.2d

2026 年 8 月 26 日

變更：

  • [Alpha 版] 移除字型載入中的路線 3D 圖示，並將其移至嵌入的 SVG 素材資源，避免多次載入 Material Symbols 字型時發生問題。
  • [Beta 版] 新增 Places UI Kit 進階元件：AdvancedPlaceDetailsElement、AdvancedPlaceDetailsCompactElement、PlaceLinkElement、PlaceButtonElement、PlaceNameElement、AdvancedPlaceListElement、AdvancedPlaceSearchElement
  • 為大眾運輸路線名稱新增工具提示，即使名稱遭到截斷，也能查看完整名稱。
  • 新增自訂網頁元件的 removeEventListener 類型。
  • 修正問題：VoiceOver 會在路線標記的視覺隱藏螢幕閱讀器元素上，顯示焦點外框

3.66.1a

2026 年 8 月 17 日

變更：

  • 新增備用標籤並移除多餘的鍵盤焦點停靠點，修正靜態地點資訊卡圖片的無障礙行為。

3.65.12f

2026 年 8 月 6 日

變更：

  • [Alpha 管道] 在 3D Maps JS API 的 Alpha 管道中加入 <gmp-label-3d> (google.maps.maps3d.Label3DElement)。開發人員現在可以使用新元素宣告標籤文字，並獨立設定其衝突行為，與連結的 3D 標記元素 (例如 <gmp-marker-3d> 和 <gmp-marker-3d-interactive>) 分開。
  • 為 Place Details 小工具中的「更多選項」按鈕，提供不重複的無障礙元素名稱。
  • [Alpha 版管道] 改善在 Alpha 版/Beta 版以外使用 TravelMode.TWO_WHEELER 時，Route 3D 交通工具模式的錯誤訊息
  • [Alpha 版] Route3D 元件現在支援 trafficPolylinesDisabled 屬性。這樣一來，開發人員在使用 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL 路線規劃選項時，就能停用車流量感知折線。
  • [Alpha 版管道] 增加 AutofitsCamera 北邊界邊框間距，避免預設圖釘遭到裁剪。
  • 修正問題：在觸控螢幕裝置上，無法將街景服務衣夾人拖曳到地圖上。

3.65.11b

2026 年 7 月 27 日

變更：

  • [Alpha 版管道] 強化 Route3D 彈出式視窗，顯示非大眾運輸圖示 (單車、開車、兩輪車和步行)。
  • [Alpha 版管道] Route.createWaypointMarkers 會為起點和目的地建立標記，並套用預設樣式，除非指定 customOverride 函式。目前不支援中繼路線控點。

3.65.10a

2026 年 7 月 22 日

變更：

  • 修正問題：Maps JS 載入 Material Symbols Outlined 字型的方式，可能會影響基本頁面上載入的相同字型。
  • 修正以下問題：使用 options.value 初始化 PlaceAutocompleteElement，或透過 value 屬性以程式輔助方式修改時，會在表單 POST 提交空白值。
  • 更新 3D 地圖傾斜和方向 UI 控制項，在攝影機限制範圍增加時重新啟用。

3.65.8c (已復原)

2026 年 7 月 7 日

變更：

  • [Alpha 版] Route3DElement 會為大眾運輸路線算繪額外的折線和彈出式視窗資料。
  • Address Validation API 新增對internalUsageAttributionIds的支援。這項屬性可將 API 呼叫歸因於特定套件或 OSS 程式庫。
  • 更新 2D 地圖上點擊搜尋點時顯示的預設資訊視窗，改用 Place Widgets。
  • 提升高流量情況下街景服務全景的可靠性。

3.65.6a

2026 年 6 月 25 日

變更：

  • [Beta 版] 更新 2D 地圖上點擊搜尋點時顯示的預設資訊視窗，改用 Place Widgets。
  • 修正錯誤：3D 地圖有時會在 fov 值極端時擲回錯誤。
  • 更新預設路線標記，不再使用已淘汰的 glyph PinElement 選項。

3.65.5e

2026 年 6 月 17 日

變更：

  • 修正 OverlayView.getMap() 的輸入內容
  • 更新 BasicPlaceAutocompleteElement 和 PlaceAutocompleteElement 的類型，指出建構函式選項參數為選用

3.65.3b

2026 年 6 月 4 日

變更：

  • Maps JavaScript API 的 DrawingManager 功能已無法使用。詳情請參閱 https://developers.google.com/maps/deprecations。
  • 改善深色模式下地圖著作權對話方塊的色彩對比度。
  • 達到航向限制時，停用 3D 地圖旋轉控制項。
  • 修正 Place Autocomplete 行動輸入欄位與 iOS 系統狀態列/安全區域重疊的問題。注意：在可視區域中繼標記中設定 viewport-fit=cover，修正程式就會生效。
  • Maps 3D JavaScript API 新增 internalUsageAttributionIds 支援。開發人員可透過這項屬性，將 API 呼叫歸因於特定套件或 OSS 程式庫。
  • Places (New) API 新增 internalUsageAttributionIds 支援。開發人員可透過這項屬性，將 API 呼叫歸因於特定套件或 OSS 程式庫。
  • [Alpha 版管道] 縮小 Route3DElement 屬性的 getter 類型，以符合 setter 正規化。
  • [Alpha 版管道] Route3DElement 會公開 routes、fallbackInfo 和 geocodingResults 屬性。

3.65.2d

2026 年 5 月 27 日

變更：

  • 修正問題：在有邊界限制的地圖上縮小時，縮放按鈕會發生問題。
  • Places Library 已為地點導入 transitStation。
  • Routes 程式庫新增對 internalUsageAttributionIds 的支援。開發人員可透過這項屬性，將 API 呼叫歸因於特定套件或 OSS 程式庫。

3.65.1c

2026 年 5 月 20 日

變更：

  • 在淺色模式下，無論是否提供地圖 ID 或自訂樣式，路線圖和地形圖上的 Google 標誌都會顯示為白色背景上的深灰色。
  • [Alpha 版] Route3DElement 會在 Routes API 呼叫成功和失敗後，分別調度 gmp-load 和 gmp-error 事件。
  • 修正不正確的說明文件，其中指出相符項目會在自動預測查詢字串的次要文字中醒目顯示。只有主要文字中的相符項目會醒目顯示，這與 Places API 自動完成功能的行為一致。
  • 改善 Place Autocomplete 自動預測項目的顏色沿用功能，讓項目能順利沿用父項元素設定的顏色。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中新增「input-icon」和「clear-icon」版位，用於自訂圖示。
  • 公開 BasicPlaceAutocomplete 和 PlaceAutocomplete 預測項目的 prediction-item-secondary-text 和 prediction-item-nonmatch 陰影部分，可為不相符的主要文字和次要文字自訂樣式。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中，新增 no-clear-button 屬性和 noClearButton 屬性，以便隱藏清除按鈕
  • Maps JavaScript API 的熱視圖圖層功能現已停用。
  • 改善地圖設定擷取的錯誤處理機制。
  • 光柵地圖已不再支援 45 度圖像。
  • 在 PlacesLibrary 說明文件中新增缺少的類別。此外，我們也記錄了 FormattableText 的 toString() 方法。
  • 改善「回報地圖錯誤」連結的無障礙功能。

3.64.12d

2026 年 5 月 6 日

變更：

  • LatLng 的 equals() 方法現在接受 LatLngLiteral 物件，而非擲回錯誤。LatLng 和 LatLngAltitude equals() 的說明文件現在也準確反映現有的容許度等級為 1e-9。
  • [Alpha 版] Map3DElement 搭配自動調整子項時，現在一開始會以 RELATIVE_TO_GROUND 高度模式算繪，支援在載入時顯示較高海拔區域，適用於預先定義攝影機屬性，而非使用 flyCameraTo 套用的情況。此外，初次載入 Map3DElement 時，如果地圖有子項使用 AutofitsCamera API 且仍在運作，系統會延後初始地圖算繪，直到所有子項都完成運作，且不論飛越動畫設定為何，攝影機都會貼齊；後續的攝影機更新則會遵循飛越設定。
  • [Alpha 版] Polygon3DElement 新增 autofitsCamera 屬性，支援自動調整攝影機。

3.64.11d

2026 年 4 月 29 日

變更：

  • [Alpha 版管道] MarkerElement 新增 autofitsCamera 屬性，支援自動調整標記的攝影機。
  • 修正 PlaceAutocompleteElement 的問題：預測項目圖示無法在 Safari 瀏覽器中顯示。
  • Places Library 已為地點導入 isPureServiceAreaBusiness。現在只要在 Place Autocomplete (Data API 和小工具) 和 Text Search 要求中設定 pureServiceAreaBusinessesIncluded，即可要求純區域服務商家的結果。
  • Places Library 已在地點中導入 addressDescriptor、containingPlaces 和 timeZone。
  • Places Library 已為地點導入 futureOpeningDate。現在只要在 Place Autocomplete (資料 API 和小工具)、Nearby Search 和 Text Search 要求中設定 futureOpeningBusinessesIncluded，即可要求尚未營業的商家結果。
  • 無論是否有地圖 ID 或自訂樣式，Roadmap 淺色地圖的 Google 標誌現在都相同。先前，凡是使用地圖 ID 的 Roadmap 地圖，一律會顯示深色模式的 Google 標誌。如要維持白色 Google 標誌，使用者應切換至深色模式。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中，新增焦點環做為 CSS Shadow Part。
  • 新增 FuelType DIESEL_PLUS 和 E100。已新增 EVConnectorType 個NACS。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中，新增 value、placeholder、disabled、readonly、no-input-icon 和 maxlength 屬性。
  • 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中新增「description」屬性，為螢幕閱讀器使用者提供額外背景資訊。
  • 縮小 LatLngAltitudeLiteral.altitude 的宣告類型，不允許空值或未定義的值。修正 DirectionalLocation.toJSON() 宣告的傳回類型。

3.64.9c

2026 年 4 月 14 日

變更：

  • TypeScript 宣告現在能正確區分屬性 getter 和 setter 的類型 (包括沒有 setter 的唯讀屬性)。

3.64.8b

2026 年 4 月 8 日

變更：

  • [Alpha 版管道] 啟用 autofitsCamera 的 Route3DElement、Marker3DElement 和 Polyline3DElement 從 DOM 移除時，不會觸發攝影機更新。如果是 Route3DElement，錯誤或空白回應不會影響攝影機。此外，如果將特定元素的 autofitsCamera 從 true 變更為 false，攝影機不會更新為排除該元素，但該元素不會納入日後的攝影機更新。
  • AdvancedMarkerElement 的 zIndex 現在由明確設定的值決定，或預設由垂直像素位置決定。明確值會優先於預設值。為避免畫面下方沒有 zIndex 的標記意外與有 zIndex 的標記重疊，建議您在所有標記中一律套用 zIndex。
  • TypeScript 宣告現在包含：將 HTML 代碼名稱對應至 JS 類別 (google.maps.HTMLElementTagNameMap 和全域 HTMLElementTagNameMap) 的介面、將 HTML 代碼名稱對應至各 JS 類別 EventMap (google.maps.HTMLElementEventMapTagNameMap) 的介面、所有自訂 CSS 屬性 (google.maps.CSSProperties) 的介面，以及每個字串型列舉都有定義的字串聯集類型 (${EnumName}String)，且該字串聯集會用於整個宣告中的列舉。addEventListener() 也會使用 EventMap 類型在每個自訂元素上超載，而 google.maps.importLibrary() 則會超載，以便為傳入的程式庫名稱正確輸入每個傳回的程式庫。

3.64.7d

2026 年 4 月 1 日

變更：

  • Map3DElement 初始化後，現在可以動態更新 mapId 屬性，不必重新例項化 Map3DElement。
  • [Alpha 版] 新增 Route3DElement，用於在 3D 地圖上算繪路線。
  • [Alpha 版] 新增 Route.create3DPolylines() 和 Route.createPopover() API。
  • [Alpha 版] 新增 spherical.traversePath() API。
  • [Alpha 版管道] 在 Marker3DElement、Polyline3DElement 和 Route3DElement 中新增 autofitsCamera API，並為 Map3DElement 新增 autofitsCameraAnimation API。
  • [Alpha 版] 新增 CirclePathElement，用於透過 Polygon3DElement 算繪圓形。
  • [Alpha 版] alpha 管道的 3D 地圖現已推出新的 ROADMAP 地圖模式。
  • 修正錯誤：在行動裝置上，如果地圖附加至 DOM 元素，而該元素是在與 Maps JS 程式庫程式碼不同的頁框結構定義中建立，則街景服務衣夾人無法正常運作。

3.64.6d

2026 年 3 月 26 日

變更：

  • 修正問題：如果沒有醒目顯示的預測結果，按下 Enter 鍵不會提交包含 Place Autocomplete 元素的表單。
  • 修正競爭狀況，避免 FlattenerElement 無法在 3D 地圖上繪製。
  • 修正錯誤：如果地圖附加至 DOM 元素，而該元素是在與 Maps JS 程式庫程式碼不同的 iframe 情境中建立，則行動裝置上的觸控處理功能無法正常運作。

3.64.5d

2026 年 3 月 18 日

變更：

  • weekly 管道現在提供多項 3D 地圖更新，包括新的 MarkerElement 和 FlattenerElement。此外，我們也新增了 cameraPosition 和 fov 屬性，並為 flyCameraTo 和 flyCameraAround 方法新增 altitudeMode 支援。
  • Places Library 針對已識別的地點，推出 currentOpeningHours、regularSecondaryOpeningHours 和 currentSecondaryOpeningHours。currentOpeningHours 提供下週的營業時間，包括假日等特殊營業時間。次要營業時間與地點的主要營業時間不同，是指地點的得來速、自取或外帶等服務的營業時間。
  • 修正 3D 地圖的問題：地圖移動後，Google 地圖連結有時無法正確更新。

3.64.4d

2026 年 3 月 12 日

變更：

  • 在位置變更時同步處理 InfoWindow 地圖屬性，修正導致不必要控制台警告的問題。
  • 修正問題：Map3DElement 的程式輔助 fov 更新有時會遭到捨棄。
  • Map3DElement 上的 flyCameraAround 方法現在接受 Number.Infinity 做為 repeatCount 參數，可無限播放動畫。

3.64.3a

2026 年 3 月 2 日

變更：

  • Maps Embed API 現在會使用 Places UI Kit 顯示地點詳細資料。
  • [Beta 版] 3.64.2 版中，Map3DElement 先前導入的 cameraPosition 屬性，現在也支援 flyCameraTo 目標。詳情請參閱「Maps JavaScript 中的 3D 地圖」。

3.64.2b

2026 年 2 月 26 日

變更：

  • google.maps.DirectionsService、google.maps.DirectionsRenderer 和 google.maps.DistanceMatrixService 已於 2026 年 2 月 25 日淘汰。目前我們並未排定停用這些 API，也會繼續修正重大迴歸錯誤。如要停止支援，我們會在 12 個月前發出通知。詳情請參閱舊版 (包括建議採用的新替代方案)。
  • [Beta 版] 推出新的 MarkerElement，可在 3D 地圖的標記中顯示自訂 HTML 內容。此外，新的 FlattenerElement 現在可以壓平特定區域的 3D 網格。
  • [Beta 版] Map3DElement 已更新，加入 fov 和 cameraPosition 屬性，flyCameraTo 和 flyCameraAround 方法現在支援 altitudeMode。詳情請參閱「Maps JavaScript 中的 3D 地圖」。
  • 修正錯誤：使用 document.createElement('gmp-pin') 建立 PinElement 時，會擲回 NotSupportedError。

3.64.1c

2026 年 2 月 19 日

變更：

  • AdvancedMarkerElement 調整大小時更新碰撞。

3.63.14d

2026 年 2 月 5 日

變更：

  • Places Library 推出新選項，可在要求資料時識別地點。除了使用 id 之外，您現在可以指定 resourceName 來初始化 Place 物件。
  • Places Library 已針對識別出的地點推出 subDestinations。如果使用者在機場、國家公園、大學或體育場等大型或複雜的地點搜尋，這些subDestinations可提供更具體的地點。
  • 修正問題：在 JS 中設定中心屬性時，Map3D 必須指定高度 (現在預設為 0)。
  • PlaceDetailsElement 和 PlaceDetailsCompactElement 的 Place 物件現在包含 googleMapsLinks 屬性，可提供深層連結網址，用於在 Google 地圖中執行各種動作。包括查看地點、規劃路線、查看相片、閱讀現有評論，以及撰寫新評論的 URI。

3.63.13

2026 年 1 月 29 日

變更：

  • 滑鼠游標懸停在搜尋點上時，Maps Embed API 不會再顯示懸浮資訊卡。
  • 針對設定錯誤的 Places UI Kit (Place Details + Place Search) 元素，新增控制台警告
  • PlaceDetailsElement 現在會顯示 AI 生成的地點摘要 (如有)。
  • PlaceDetailsElement 現在提供 AI 生成的評論摘要。

3.63.10a

2026 年 1 月 13 日

變更：

  • 修正無法在彈出式視窗內捲動和點按的問題。
  • Places API 現已提供 resourceName 和 shortFormattedAddress 欄位

3.63.9d

2026 年 1 月 8 日

變更：

  • PlaceSearchElement 載入相片時，顯示非相片內容的速度會稍微加快。Places UI Kit 的相片淡入動畫經過改良。
  • 改善在傾斜地圖上算繪折線時的效能。
  • 修正錯誤：在特定情況下，透過程式設定 3D 地圖攝影機時，攝影機不會更新。
  • 略為提升 PlaceDetailsElement 和 PlaceSearchElement 載入相片的效能。
  • 釐清 MapOptions 中 draggable 屬性的行為，進一步說明使用者互動限制。
  • 強制 Address Validation 程式庫中的 possibleNextAction 存取 Beta 版
  • 在 PlaceAutocompleteElement 中新增 placeholder 屬性和 HTML 屬性支援
  • PlaceAutocompleteElement 現在支援更多標準 CSS 字型屬性的自訂功能，包括：font、font-size、font-family、font-weight、line-height、font-style 和 color。預設字型大小現在為 16px。
  • 在 PlaceAutocompleteElement 中新增 value 屬性和 HTML 屬性支援
  • 最佳化 Places UI Kit 的圖片載入作業。
  • 已將 CSS 部分 input 新增至 PlaceAutocompleteElement

3.63.5d

2025 年 12 月 11 日

變更：

  • 在 Maps JavaScript API 中推出 Address Validation API
  • mapTypeId 設為空值或未定義時，現在預設為 MapTypeId.ROADMAP，修正可能導致地圖圖塊無法載入的問題。
  • 如果地點無法評分，請隱藏PlaceDetailsElement中的評論部分。
  • 改善 google.maps.Map 上 Google 標誌的色彩對比度，並套用自訂樣式
  • 向量地圖現在使用與光柵地圖相同的衛星圖像，視覺逼真度更高。

3.63.4a

2025 年 12 月 4 日

變更：

  • --gmp-mat-spacing-medium 現在會套用至 PlaceDetailsCompactElement 水平檢視畫面的內部容器邊框間距。
  • 修正問題：在 MacOS Safari 上與 UI 控制項互動時，3D 地圖會移動。
  • 現在可以動態變更 Map3DElement 的 language 和 region 屬性，不必重新建立地圖。

3.63.1b

2025 年 11 月 20 日

變更：

  • 修正資訊視窗附加至 AdvancedMarkerElement 時位置不正確的問題。
  • 將 PlaceAutocompleteElement 的清除按鈕設為僅在輸入內容有文字時顯示。
  • 在 PlaceDetailsCompactElement 樣式中，方向屬性比對不區分大小寫。
  • 新增功能，可在 3D 地圖上開啟 PopoverElement 時，停用平移地圖功能。
  • 修正錯誤：無法在 PinElement 上使用 addEventListener()。
  • 現在只要點選內容區域以外的地方，即可關閉互動視窗對話方塊 (例如地圖上的鍵盤快速鍵對話方塊，以及 Places UI Kit 中的揭露事項對話方塊)。
  • 地點資料現在包含 AI 生成的評論和附近設施摘要，新屬性包括 evChargeAmenitySummary、neighborhoodSummary、generativeSummary 和 reviewSummary。

3.62.13e

2025 年 11 月 6 日

變更：

  • 修正了在 DOM 中動態新增及移除 PopoverElement 時，記憶體流失的問題。
  • 修正了在 DOM 中動態新增及移除 Map3DElement 時，記憶體流失的問題。
  • 修正了在 PlaceDetailsCompactElement 中使用粗邊框時，圓角圖片與圓角容器的對齊問題。

3.62.12c

2025 年 10 月 30 日

變更：

  • [Alpha 版管道] 移除實驗性 ElevationElement。
  • 在 3D 地圖 PopoverElement 中，新增 background-color、border-radius、box-shadow 和 padding 的 CSS 變數。
  • 點選相片外部時，Places UI Kit 相片燈箱不會再關閉。

3.62.11d

2025 年 10 月 23 日

變更：

  • [Alpha 版管道] 讓深色模式適用於醒目顯示的地點情境清單項目。
  • 在 AdvancedMarkerElementOptions 中新增 anchorLeft 和 anchorTop 屬性。
  • <gmp-pin> 網頁元件現已推出。使用新的 glyphSrc 屬性提供字符的圖片網址，或使用 glyphText 屬性顯示文字。glyph 屬性現已在 PinElement 上淘汰。
  • 防止在可視區域外建立相關聯的 AdvancedMarker 時，意外顯示 InfoWindow。
  • 3D Maps 現已在每週更新頻道推出。這個版本包含新的指南針控制項和簡化的預設 UI 控制項、支援雲端式地圖樣式設定和協作手勢處理、透過 Map3DElement 上的新 language 和 region 屬性改善本地化功能，以及改善基本地圖標籤的無障礙功能。詳情請參閱「Maps JavaScript 中的 3D 地圖」。
  • 改善 3D 地圖的記憶體管理功能，避免 iOS 裝置發生記憶體不足的問題。
  • 推出 Routes JS。開發人員可使用 Maps JS API 呼叫 Routes API 並繪製路線。

3.62.9c

2025 年 10 月 9 日

變更：

  • 在 AdvancedMarkerElement 中新增 anchorTop 和 anchorLeft 屬性。這樣一來，您就能將標記的錨點變更為預設底部中間以外的位置。

3.62.8d

2025 年 10 月 2 日

變更：

  • Maps Embed API 啟用新的攝影機控制項。
  • [Beta 版] Map3DElement 類別和 Map3DElementOptions 介面中的 defaultUIDisabled 屬性已替換為 defaultUIHidden。defaultUIDisabled 將繼續在 beta 管道中運作。
  • [Beta 版] FlyAroundAnimationOptions 介面中的 rounds 屬性已替換為 repeatCount。rounds 將繼續在 beta 管道中運作。
  • mapMode 屬性現已在 PlaceContextualElement 上淘汰。

3.62.7e

2025 年 9 月 25 日

變更：

  • 為 PlaceContextualElement 啟用醒目顯示標記。

3.62.6d

2025 年 9 月 18 日

變更：

  • [Beta 版] 釐清 Route 錯誤訊息。
  • [Beta 版] 支援 Route 要求中的 Place 資源名稱。
  • [Beta 版] 允許從 RouteLeg 路徑建立 Route 折線。

3.62.5d

2025 年 9 月 10 日

變更：

  • [Beta 版] Polyline3DElement 中的 coordinates 屬性已替換為 path，現在可做為 HTML 屬性使用。Polygon3DElement 的 outerCoordinates 屬性已替換為 path，現在可做為 HTML 屬性使用。Polygon3DElement 的 innerCoordinates 屬性已替換為 innerPaths。這兩個元素的所有「coordinates」屬性都已淘汰，但仍可在 Beta 版中運作。

3.62.3c

2025 年 9 月 3 日

沒有公開異動。

3.62.2c

2025 年 8 月 28 日

變更：

3.62.1

2025 年 8 月 21 日

變更：

  • [Beta 版] 在 AddressValidation.fetchAddressValidation() 中，為 Address Validation API 的工作階段管理功能新增 sessionToken 和 placeAutocompleteElement 選用選項
  • [Beta 版] 推出 Routes JS。開發人員可使用 Maps JS API 呼叫 Routes API 並繪製路線。

3.61.14

2025 年 8 月 7 日

變更：

  • 修正問題：在水平模式下，Place Details 精簡元素無法使用相片燈箱。

3.61.12c

2025 年 7 月 31 日

變更：

  • 新增 PlaceAutocompleteElementOptions 和 BasicPlaceAutocompleteElementOptions 中其他欄位的說明文件。
  • 解決進階標記在平移至畫面外時，會短暫閃爍然後消失的問題。
  • 在 Place 類別中新增 googleMapsLinks。

3.61.11a

2025 年 7 月 24 日

變更：

  • 在 Place Review 類別中新增 originalText 和 originalTextLanguageCode。
  • [Alpha 版管道] 啟用 PlaceContextual Maps Grounding 小工具的 mapMode。允許使用者在 ROADMAP、HYBRID 和 NONE 之間切換。
  • [Beta 版] 如果地圖無法初始化 (例如使用者的瀏覽器不支援 WebGL)，Map3DElement 現在會觸發事件。
  • 地圖上的 45° 圖像現已淘汰。詳情請參閱「淘汰項目 - 45° 圖像」。

3.61.10d

2025 年 7 月 17 日

變更：

  • Basic Place Autocomplete 小工具現已在每週更新版本中推出。
  • [Alpha 版] 移除實驗性 PlaceListElement。
  • 新增 PlaceSearchElement 和相關設定 / 要求元素。
  • PlaceDetailsElement 和 PlaceDetailsCompactElement 的其他樣式符記。

3.61.9a

2025 年 7 月 10 日

變更：

  • 更新標記，避免使用螢幕閱讀器時重複播放每個項目的導覽指示。現在每次進入群組時，只會播報一次操作說明。
  • 修正深色模式下鍵盤快速鍵對話方塊的對比度問題。
  • 為 Place Autocomplete 元素啟用邊框、邊框半徑、小工具背景顏色和色彩配置自訂支援。Place Autocomplete 元素現在會自動套用深色模式。如要停用，請在 CSS 中套用 color-scheme: light。
  • 在 Place Photo 和 Review 類別中新增 googleMapsURI 欄位。
  • [Beta 版] 在 Address Validation API 中新增 PossibleNextAction 列舉。

3.61.7a

2025 年 7 月 1 日

變更：

  • Maps JavaScript API 的熱視圖圖層功能已不再支援。這個 API 已於 2025 年 5 月淘汰，並將於 2026 年 5 月推出的 Maps JavaScript API 後續版本中停用。詳情請參閱 https://developers.google.com/maps/deprecations。
  • 修正 GA 問題：無法處理點擊自訂樣式隱藏的搜尋點。
  • [Beta 版] 新增 3D 地圖中 WebGL 內容遺失的額外處理功能。WebGL 內容還原後，3D 地圖現在會嘗試自行還原。

3.61.6d

2025 年 6 月 26 日

變更：

  • 將 internalUsageAttributionIds 新增至 Map3DElement 和 Map3DElementOptions。

3.61.5a

2025 年 6 月 17 日

變更：

  • 啟用 Places Autocomplete 的 LocationBias 字串「IP_BIAS」支援。
  • 修正 SearchNearbyRequest 的說明文件錯誤。SearchNearbyRequest.RankPreference 的預設值為 POPULARITY，而非 DISTANCE。

3.61.4a

2025 年 6 月 12 日

變更：

  • 新增 RPCStatus 列舉，用於描述特定網路服務傳回的狀態碼。

3.61.3b

2025 年 6 月 5 日

沒有公開異動。

3.61.2

2025 年 5 月 29 日

變更：

  • 新增 PlaceDetailsElement、PlaceDetailsCompactElement 和相關設定元素。移除 PlaceDetailsSize。
  • 修正 PlaceAutocompleteElement 的問題：選取輸入法項目會導致元素選取預測項目。

3.61.1

2025 年 5 月 22 日

變更：

  • [Beta 版] 修正 PlaceDetailsCompactElement 地點輸出內容缺少位置/可視區域的問題。
  • 在涵蓋的城市中，可查看街道層級的詳細資料。

3.60.12

2025 年 5 月 8 日

變更：

  • [Beta 版] Maps JavaScript API 新增 Address Validation API 支援。
  • 修正了從沒有 Origin 標頭的內容發出網路呼叫的問題。

3.60.11 (已復原)

2025 年 5 月 1 日

變更：

  • [Beta 版] 新增 PlaceDetailsCompactElement 和相關設定元素。
  • 修正 StreetViewPanoramaOptions.zoomControl = false 無法用於街景服務地圖的問題。

3.60.10

2025 年 4 月 24 日

變更：

  • [Beta 版] 3D Maps 現已在 Beta 版推出。這個版本改善了無障礙功能，並為折線、多邊形和 3D 模型新增互動元素。此外，現在可以使用新的 PopoverElement 在 3D 地圖上顯示自訂 HTML 內容。詳情請參閱「Maps JavaScript 中的 3D 地圖」。

3.60.9

2025 年 4 月 17 日

變更：

  • [Alpha 版] 將 PlaceContextualElement 推出至不受限制的實驗版。
  • [Alpha 版] 3D 地圖現在預設會使用以圖片為基礎的光照 (IBL) 算繪 3D 模型。

3.60.8

2025 年 4 月 9 日

變更：

  • [Beta 版] LocalContext API 現已完全移除。現在，如果嘗試例項化 LocalContextMapView，系統會擲回錯誤。詳情請參閱 https://developers.google.com/maps/deprecations#localcontext-deprecation。
  • 修正錯誤：在觸控裝置上拖曳進階標記時，會出現異常行為。
  • 提高協同手勢處理疊加層的不透明度，讓疊加層上的文字在地圖所有區域都符合對比度規定。
  • 在 Places API 中新增 PostalAddress 支援。
  • 確保啟動時靜態訪客分布圖的 colorScheme 與基礎地圖相同。

3.60.7b

2025 年 4 月 3 日

變更：

  • Place Autocomplete 小工具現已在每週更新版本中推出。

3.60.6

2025 年 3 月 27 日

變更：

  • 修正 Safari 的問題：使用 overscroll-behavior 的頁面無法正常捲動。
  • 修正問題：啟用衝突行為後，新增大量進階標記時會發生閃爍。
  • Places 新增 PriceRange 支援。

3.60.5 (已復原)

2025 年 3 月 20 日

變更：

  • 修正了點選或輕觸進階標記時，無法捲動頁面的錯誤。
  • 修正 <gmp-map> 中全螢幕模式無法正常運作的錯誤。
  • 修正錯誤：隱藏進階標記的資訊視窗仍會顯示。
  • 在路線圖中加入單車圖層時，自訂樣式地圖不會失去自訂樣式。

3.60.4

2025 年 3 月 11 日

變更：

  • 自訂樣式和背景顏色會套用至已定義樣式的特定地圖類型和色彩配置 (一開始僅限於路線圖和路線圖深色模式)。大眾運輸圖層會保留所選地圖類型的任何自訂樣式。

3.60.3 (已復原)

2025 年 3 月 5 日

變更：

  • 修正導致路線面板無法顯示的錯誤。

3.60.2

2025 年 2 月 27 日

變更：

  • Places：新增對電動車充電接頭類型 NACS (SAE J3400) 的支援。
  • 正式發布 gmp-map 和 gmp-advanced-marker HTML 元素。

3.60.1

2025 年 2 月 20 日

變更：

  • [Alpha 版] Polygon3DElement 和 Polyline3DElement 上的 altitudeMode 現在預設為 CLAMP_TO_GROUND。
  • [Alpha 版] 現在必須在 Map3DElement 上設定新的 mode 選項，才能算繪 3D 地圖 (有 2 個新值 HYBRID 和 SATELLITE 可用)。現有的 defaultLabelsDisabled 選項已移除，請將 mode 設為 HYBRID 或 SATELLITE。
  • [Beta 版] 如果未特別為特定地圖類型設定背景顏色，背景顏色會恢復為預設值或 MapOptions 中設定的顏色。
  • [Beta 版] 光柵自訂樣式應只套用至已指派樣式的地圖類型。
  • 修正問題：在全螢幕模式下拖曳進階標記時，標記會偏移。此外，我們也修正了在全螢幕模式下拖曳街景服務衣夾人時，會出現偏移的問題。
  • 將預設的縮放控制項替換為新的相機控制項，其中包含平移和縮放按鈕。
  • 更新縮放按鈕圖示，與新的平移按鈕圖示保持一致。

3.59.8

2025 年 2 月 6 日

變更：

  • 客戶現在可以文字形式存取 TransitFare 值。
  • [Alpha 版管道] 推出新的 AirQualityMeterElement：<gmp-air-quality-meter>。
  • [Alpha 色板] 現在必須在 Google Cloud 雲端專案中啟用 Places API (新版)，才能使用 PlaceAutocompleteElement。.
  • [Alpha 版管道] PlaceAutocompleteElement：gmp-placeselect 事件已由 gmp-select 取代，並提供 PlacePredictionSelectEvent 物件，而非 PlaceAutocompletePlaceSelect 物件。
  • [Alpha 版管道] PlaceAutocompleteElement：gmp-requesterror 事件已由 gmp-error 取代，並提供 Event 物件，而非 PlaceAutocompleteRequestErrorEvent 物件。
  • [Alpha 版] PlaceAutocompleteElement：componentRestrictions 已由 includedRegionCodes 取代。
  • [Alpha 版] PlaceAutocompleteElement：types 已替換為 includedPrimaryTypes。

3.59.7

2025 年 1 月 30 日

變更：

  • [Beta 版] 為自訂樣式設定的路線圖和深色模式路線圖背景顏色，應顯示在圖塊和地圖邊界後方。
  • [Beta 版] 新增大眾運輸圖層時，自訂樣式路線圖 (或深色模式路線圖) 會維持自訂樣式，不會還原為預設的基本地圖樣式。
  • 現在，深色模式的地圖在加入大眾運輸圖層後，仍會保持深色模式。

3.59.6

2025 年 1 月 23 日

沒有公開異動。

3.59.5

2025 年 1 月 16 日

變更：

  • 修正錯誤：建立自訂街景服務全景時，會擲回未捕捉的錯誤。

3.59.4a

2025 年 1 月 9 日

變更：

  • 修正錯誤：啟用路況圖層時，會擲回未擷取的錯誤。
  • [Beta 版] 解決 PlaceAutocompleteElement 無法正確產生焦點的問題。
  • [Beta 版] 在支援的城市中，縮放等級為 z17 以上時，會顯示原子地圖項目。

先前的版本資訊

如需 2024 年及更早的版本資訊，請參閱 Maps JavaScript API 版本資訊封存。