Maps JavaScript API 發布說明書

訂閱版本資訊。

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

這份變更記錄會列出各個版本和發布日期，以及相關變更。

如要接收新版 Maps API 的最新消息，請訂閱 google-maps-js-api-v3-notify 群組。

自 2021 年 8 月 26 日起，Maps JavaScript API 可能會透過 beta 管道發出額外呼叫，回報遙測資訊，以計算多項功能的服務等級目標 (SLO)。您可能需要更新內容安全政策，確保系統不會在瀏覽器層級封鎖這些呼叫。詳情請參閱常見問題。

3.66.3d

2026 年 9 月 2 日

變更：

• [Alpha 版] 在 RoutePolyline3DOptions 中加入 trafficPolylinesDisabled 欄位。開發人員可藉此在建立 3D 路徑折線時，停用可感知流量的折線。
• [Alpha 版] 最佳化 Route3DElement，避免在切換 trafficPolylinesDisabled 時發出不必要的後端要求。

3.66.2d

2026 年 8 月 26 日

變更：

• [Alpha 版] 從字型載入作業中移除 Route 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 版] 將 <gmp-label-3d> (google.maps.maps3d.Label3DElement) 新增至 3D 地圖 JS API 的 Alpha 版。開發人員現在可以使用新元素宣告標籤文字，並獨立設定其衝突行為，與連結的 3D 標記元素 (例如 <gmp-marker-3d> 和 <gmp-marker-3d-interactive>) 分開。
• 為 Place Details 小工具中的「更多選項」按鈕提供專屬的無障礙名稱。
• [Alpha 版] 改善「路線 3D 旅遊模式」的錯誤訊息，適用於在 Alpha 版/Beta 版以外使用 TravelMode.TWO_WHEELER 的情況
• [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 初始化或透過 value 屬性以程式輔助方式修改時，PlaceAutocompleteElement 會在表單 POST 中提交空白值。
• 更新 3D 地圖傾斜和方向 UI 控制項，以便在攝影機限制範圍增加時重新啟用。

3.65.8c (已復原)

2026 年 7 月 7 日

變更：

• [Alpha 版] Route3DElement 會轉譯大眾運輸路線的額外折線和快顯視窗資料。
• 地址驗證 API 新增對 internalUsageAttributionIds 的支援。這個屬性可將 API 呼叫歸因於特定套件或 OSS 程式庫。
• 更新 2D 地圖上點按興趣點時的預設資訊視窗，改用 Place 小工具。
• 在高流量情況下，提升街景服務全景的可靠性。

3.65.6a

2026 年 6 月 25 日

變更：

• [Beta 版管道] 更新 2D 地圖上 POI 點擊事件的預設資訊視窗，改用地點小工具。
• 修正錯誤：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 中新增對內部 UsageAttributionId 的支援。開發人員可透過這項屬性，將 API 呼叫歸因於特定套件或 OSS 程式庫。
• Places (新版) 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 且仍在運作的子項，初始地圖算繪作業會延後，直到所有子項完成運作為止，且無論 fly-to 動畫設定為何，相機都會快速移動；後續的相機更新作業則會遵守 fly-to 設定。
• [Alpha 版] Polygon3DElement 新增 autofitsCamera 屬性，支援自動調整攝影機。

3.64.11d

2026 年 4 月 29 日

變更：

• [Alpha 版] MarkerElement 新增 autofitsCamera 屬性，支援自動調整攝影機以配合標記。
• 修正 PlaceAutocompleteElement 中的問題：預測項目圖示不會在 Safari 瀏覽器中顯示。
• Places Library 已為地點導入 isPureServiceAreaBusiness。現在只要在 Place Autocomplete (資料 API 和小工具) 和 Text Search 要求中設定 pureServiceAreaBusinessesIncluded，即可要求完全無店面區域商家的結果。
• Places Library 已為地點導入 addressDescriptor、containingPlaces 和 timeZone。
• Places Library 已為地點導入 futureOpeningDate。現在只要在 Place Autocomplete (資料 API 和小工具)、Nearby Search 和 Text Search 要求中設定 futureOpeningBusinessesIncluded，即可要求尚未開幕的商家結果。
• 現在，無論有無地圖 ID 或自訂樣式，路線圖淺色地圖的 Google 標誌都會相同。先前，凡是使用地圖 ID 的路線圖地圖，一律會顯示深色模式的 Google 標誌。如要維持白色 Google 標誌，使用者應切換至深色模式。
• 在 PlaceAutocompleteElement 和 BasicPlaceAutocompleteElement 中，將焦點環新增為 CSS 陰影部分。
• 新增了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 版管道] Route3DElement、Marker3DElement 和 Polyline3DElement (含 autofitsCamera) 從 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 日

變更：

• 現在，mapId 屬性可在 Map3DElement 初始化後動態更新，不必重新例項化 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 版] 3D 地圖的 alpha 管道現已推出新的 ROADMAP 地圖模式。
• 修正錯誤：在附加至 DOM 元素的 Google 地圖中，如果該元素是在與 Maps JS 程式庫程式碼不同的影格環境中建立，行動裝置上的街景服務人偶就無法正常運作。

3.64.6d

2026 年 3 月 26 日

變更：

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

3.64.5d

2026 年 3 月 18 日

變更：

• weekly 頻道現在推出了幾個 3D 地圖更新，包括新的 MarkerElement 和 FlattenerElement。此外，我們也加入了 cameraPosition 和 fov 屬性，以及對 flyCameraTo 和 flyCameraAround 方法的 altitudeMode 支援。
• Places 庫為已識別的地點引入了 currentOpeningHours、regularSecondaryOpeningHours 和 currentSecondaryOpeningHours。currentOpeningHours 提供接下來一週的營業時間，包括假日等特殊時間。次要營業時間與場所的主要營業時間不同，指的是場所的免下車取餐、取餐或外帶等服務的營業時間。
• 修正了 3D 地圖中地圖移動後，有時 Google 地圖連結無法正確更新的問題。

3.64.4d

2026 年 3 月 12 日

變更：

• 同步 InfoWindow 映射屬性以在位置變更時修復導致不必要的控制台警告的問題。
• 修復了程序化購買的問題fovMap3DElement 的更新偶爾會停止。
• Map3DElement 上的 flyCameraAround 方法現在接受 Number.Infinity 作為 repeatCount 參數，從而實現無限動畫。

3.64.3a

2026 年 3 月 2 日

變更：

• Maps Embed API 現在使用 Places UI Kit 來顯示地點詳情。
• [beta 頻道] cameraPosition先前介紹過的房產Map3DElement3.64.2 版本現在也支援了flyCameraTo目標。詳情請參閱「Maps JavaScript 中的 3D 地圖」。

3.64.2b

2026 年 2 月 26 日

變更：

• google.maps.DirectionsService、google.maps.DirectionsRenderer 和 google.maps.DistanceMatrixService 將於 2026 年 2 月 25 日棄用。目前暫無計劃停止服務，並將繼續修復任何重大回歸錯誤。如要停止支援，我們會在至少 12 個月前發出通知。有關更多詳細資訊（包括更新的、建議的替代方案），請參閱 legacy。
• [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 庫引入了在請求資料時識別地點的新選項。除了使用 id 之外，現在還可以指定 resourceName 來初始化 Place 物件。
• Places 庫已為已識別的地點引入了 subDestinations。這些 subDestinations 為在機場、國家公園、大學或體育場等大型或複雜場所內搜尋的使用者提供更具體的目的地。
• 修正了 Map3D 在 JS 中設定 center 屬性時需要指定海拔高度的問題（現在預設為 0）。
• 來自 PlaceDetailsElement 和 PlaceDetailsCompactElement 的 Place 物件現在包含一個 googleMapsLinks 屬性，該屬性提供 URL，以便深度連結到 Google 地圖以執行各種操作。這包括用於查看地點、獲取路線、查看照片、閱讀現有評論和撰寫新評論的 URI。

3.63.13

2026 年 1 月 29 日

變更：

• Maps Embed API 在將滑鼠遊標停留在興趣點 (POI) 上時不再顯示懸停卡片。
• 為配置錯誤的 Places UI Kit（地點詳情 + 地點搜尋）元素添加控制台警告
• 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 屬性行為，進一步解釋使用者互動限制。
• 強制在 地址驗證 程式庫中為 possibleNextAction 啟用 Beta 版管道存取權
• 在 PlaceAutocompleteElement 中新增 placeholder 屬性和 HTML 屬性支援
• PlaceAutocompleteElement 現在支援更多標準 CSS 字型屬性的自訂功能，包括：字型、字型大小、字型系列、字型粗細、行高、字型樣式和顏色。預設字型大小現在為 16 像素。
• 在 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。
• 在 Map 3D PopoverElement 中新增 background-color、border-radius、box-shadow 和 padding 的 CSS 變數。
• 現在點選相片以外的區域，不會再關閉 Places UI Kit 相片燈箱。

3.62.11d

2025 年 10 月 23 日

變更：

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

3.62.9c

2025 年 10 月 9 日

變更：

• 已將 anchorTop 和 anchorLeft 屬性新增至 AdvancedMarkerElement。這樣就能將標記的錨點變更為預設底部中央以外的位置。

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 請求中的地點資源名稱。
• [測試版管道] 允許從 RouteLeg 路徑建立 Route 折線。

3.62.5d

2025 年 9 月 10 日

變更：

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

3.62.3c

2025 年 9 月 3 日

沒有面向大眾的變更。

3.62.2c

2025 年 8 月 28 日

變更：

• 繪圖程式庫已淘汰。詳情請參閱 https://developers.google.com/maps/deprecations。

3.62.1

2025 年 8 月 21 日

變更：

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

3.61.14

2025 年 8 月 7 日

變更：

• 修正問題：在橫向模式下，地點詳細資料精簡元素無法使用相片燈箱。

3.61.12c

2025 年 7 月 31 日

變更：

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

3.61.11a

2025 年 7 月 24 日

變更：

• 將 originalText 和 originalTextLanguageCode 加入到 Place Review 類別中。
• [alpha 頻道] 為 PlaceContextual Maps Grounding Widget 啟用 mapMode。允許使用者在「路線圖」、「混合」和「無」之間切換。
• [beta 通道] 如果地圖初始化失敗（例如，由於使用者瀏覽器缺少 WebGL 支援），Map3DElement 現在會觸發一個事件。
• 地圖上的 45° 圖像已淘汰。有關更多信息，請參閱 棄用 – 45° 圖像。

3.61.10d

2025 年 7 月 17 日

變更：

• 基本地點自動完成小工具現已在每週頻道中提供。
• [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 中阻止處理因自訂樣式而隱藏的 POI 的點擊事件的問題。
• [beta 通道] 為 3D 地圖中的 WebGL 上下文遺失添加了額外的處理。當 WebGL 上下文恢復時，3D 地圖將嘗試自行恢復。

3.61.6d

2025 年 6 月 26 日

變更：

• 將 internalUsageAttributionIds 新增至 Map3DElement 和 Map3DElementOptions。

3.61.5a

2025 年 6 月 17 日

變更：

• 為 Place 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 的問題：選取 IME 項目時，元素會選取預測項目。

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 地圖現已在 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> 中正常運作的錯誤。
• 修正錯誤：隱藏進階標記後，資訊視窗仍會顯示。
• 在 Roadmap 中自訂樣式的地圖在新增自行車圖層時不會遺失其自訂樣式。

3.60.4

2025 年 3 月 11 日

變更：

• 自訂樣式和背景顏色將套用於定義樣式的特定地圖類型和配色方案（最初，這將僅限於路線圖和深色路線圖）。公車圖層將保留所選地圖類型的任何自訂樣式。

3.60.3（已回滾）

2025 年 3 月 5 日

變更：

• 修正了導致方向指示面板不顯示的錯誤。

3.60.2

2025 年 2 月 27 日

變更：

• 地點：增加了對電動車連接器類型 NACS（SAE J3400）的支援。
• 已將 gmp-map 和 gmp-advanced-marker HTML 元素發布到 GA。

3.60.1

2025 年 2 月 20 日

變更：

• [alpha 通道] altitudeMode 在 Polygon3DElement 和 Polyline3DElement 上現在預設為 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 頻道] 現在使用 PlaceAutocompleteElement 需要在 Google Cloud 專案上啟用 Places API（新）。 .
• [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 版管道] 針對自訂樣式設定的路線圖和深色模式路線圖背景顏色，應在圖塊和地圖邊界後方算繪。
• [測試版] 自訂樣式的路線圖（或深色模式路線圖）在新增交通圖層時將保持其自訂樣式，而不是恢復為預設的基礎地圖樣式。
• 新增交通圖層後，處於深色模式的地圖將保持深色模式。

3.59.6

2025 年 1 月 23 日

沒有面向大眾的變更。

3.59.5

2025 年 1 月 16 日

變更：

• 修正了建立自訂街景全景圖時拋出未捕獲錯誤的錯誤。

3.59.4a

2025 年 1 月 9 日

變更：

• 修正了啟用流量層時拋出未捕獲錯誤的錯誤。
• [beta 頻道] 修正了 PlaceAutocompleteElement 無法正確釋放焦點的問題。
• [beta 通道] 原子地圖特徵將在 z17 及更深層的支援城市中顯示。

3.59.3

2024 年 12 月 12 日

變更：

• Firebase App Check 現已支援 Maps JS API 和 Places JS。

3.59.2

2024 年 12 月 5 日

變更：

• [alpha 通道] 原子地圖特徵將顯示在 z17 及更深處的支援城市。
• 在初始值設定工具中新增使用情況歸因 ID，協助 Google 瞭解哪些程式庫和範例對開發人員有幫助，例如標記叢集程式庫的使用情況。若要選擇不傳送使用歸因 ID，可以安全地刪除此屬性或將值替換為空字串。例項化後，系統可能會忽略對這個值的變更。
• 您現在可以使用 Firebase App Check 來防止惡意請求。瞭解更多使用 App Check with Places和使用 App 查看地圖。

3.59.1

2024 年 11 月 21 日

變更：

• [beta 頻道] 修正了街景視野中缺少縮放控制的問題。
• 修正了舊版不可點擊標記仍然會觸發點擊事件的錯誤。
• 修正了切換到自訂地圖類型時，進階標記無法更新像素位置的錯誤。
• 現在使用地圖 ID 套用預設或自訂地圖類型和樣式時，系統會記錄控制台警告。當 mapId 存在時，地圖樣式是透過 Cloud Console 控管，且雲端樣式目前僅支援路線圖地圖類型。
• 在深色模式下，滑鼠懸停時可移動相機控制按鈕。
• 使用極小範圍時，fitBounds 邊框間距問題。

3.58.11a

2024 年 10 月 31 日

變更：

• [beta 通道] 修正了導致 Web 元件地圖上的 StreetView 小人無法使用的錯誤。
• 防止螢幕閱讀器在 Embed API 地圖上隱藏滾動訊息時聚焦於該滾動訊息。

3.58.10

2024 年 10 月 24 日

變更：

• 解決了存取會話儲存時出現異常的問題。

3.58.9（已回滾）

2024 年 10 月 17 日

變更：

• [alpha 通道] 現在可以將自訂影像和 SVG 用於在 3D 地圖上渲染的標記。

3.58.8

2024 年 10 月 10 日

變更：

• 移除了錯誤的 WebGLOverlayView 控制台警告。
• 修正問題：如果地圖是頁面上第一個以指標或滑鼠互動的元素，Chrome 會誤在地圖周圍顯示藍色焦點線。
• 為行動服務 JavaScript 車隊追蹤新增了 ODRD 車輛和車隊位置提供者。

3.58.7

2024 年 10 月 3 日

沒有面向大眾的變更。

3.58.6

2024 年 9 月 25 日

變更：

• [alpha 通道] 從Polyline3DElement和Polygon3DElement移除*Opacity屬性。您可以使用 #rgba、#rrggbbaa、rgba(r, g, b, a) 或 rgb(r g b / a) 顏色格式，在對應的 *Color 屬性中指定 Alpha 值。
• [alpha 通道] 預設 UI 控制、標記、3D 模型和預設相機動畫功能現已可在實驗版本中與 3D 地圖一起使用。
• 修正了向量地圖上自訂地圖類型無法相互切換的錯誤。
• 針對高像素密度的裝置，使用高 DPI 的衛星圖像。

3.58.5a

2024 年 9 月 19 日

沒有面向大眾的變更。

3.58.4a

2024 年 9 月 12 日

沒有面向大眾的變更。

3.58.3

2024 年 9 月 5 日

沒有面向大眾的變更。

3.58.2

2024 年 8 月 29 日

變更：

• PinElement 的文字字形現在會隨著 PinElement 縮放，且預設顏色與 PinElement 的預設 glyphColor 相符。

3.58.1a

2024 年 8 月 22 日

變更：

• [Beta 版] 預設將「縮放」控制項替換為「攝影機控制項」。攝影機控制功能提供縮放和平移控制選項。
• 將 cameraControl 和 cameraControlOptions 屬性發布至 MapOptions。
• 允許在建立地圖例項時設定色彩配置 (淺色或深色)。
• 如果地圖寬度太小，請更新「地圖類型」控制項，換行顯示
• 整合新的標籤器，用於算繪向量地圖標籤。
• 對於未使用地圖 ID 的開發人員，新版基本地圖顏色現在是 v=weekly 管道的預設顏色。詳情請參閱 https://developers.google.com/maps/new-basemap-style-opt-in。

3.57.13

2024 年 8 月 8 日

變更：

• [Beta 版管道] 在反向地理編碼、正向地理編碼和地點 ID 查閱的地理編碼回應中，新增地址描述元。

3.57.12

2024 年 8 月 1 日

變更：

• [Beta 版管道] 在反向地理編碼、正向地理編碼和地點 ID 查閱的地理編碼回應中，新增地址描述元。
• [Beta 版管道] 允許在地圖例項化時設定色彩配置 (淺色或深色)。
• 在向量地圖中點選地圖項目時，縮短 IconMouseEvent 的延遲時間

3.57.10

2024 年 7 月 25 日

變更：

• [Beta 版管道] 在反向地理編碼、正向地理編碼和地點 ID 查閱的地理編碼回應中，新增地址描述元。
• 在 Place 類別中新增主要類型和顯示名稱的數個屬性。

3.57.9

2024 年 7 月 18 日

變更：

• 改善街景服務衣夾人控制項的無障礙功能。

3.57.8b

2024 年 7 月 11 日

沒有面向大眾的變更。

3.57.7

2024 年 7 月 4 日

變更：

• 將電動車選項和燃料選項新增至 Place 類別屬性。為 Place.searchByText 啟用電動車搜尋選項。

3.57.6a

2024 年 6 月 27 日

沒有面向大眾的變更。

3.57.5

2024 年 6 月 20 日

沒有面向大眾的變更。

3.57.4

2024 年 6 月 13 日

變更：

• [Beta 版] 整合了新的標籤器，用於算繪向量地圖標籤。
• InfoWindow 新增了 isOpen 屬性，可指出資訊視窗是在地圖或街景服務中開啟。
• 修正 Place Autocomplete PlacePrediction 類別的錯誤參考說明文件。

3.57.3a

2024 年 6 月 6 日

• [Beta 版管道] 在反向地理編碼、正向地理編碼和地點 ID 查閱的地理編碼回應中，新增地址描述元。

3.57.2

2024 年 5 月 28 日

變更：

• 修正網頁元件中的地圖類型控制項無法開啟選單的錯誤。
• 修正導致 AdvancedMarkerElement 缺少拖曳指標的錯誤。
• 為新的 Place API 新增自動完成功能。
• 地圖光柵圖塊現在會以 WebP 圖片格式提供。
• 更新 Place.searchByText 和 Place.searchNearby 的說明文件，以指向正確的欄位清單。
• 每週頻道現在提供新的資訊視窗關閉按鈕和可選標題列。

3.57.0

2024 年 5 月 24 日

沒有面向大眾的變更。

3.56.12a

2024 年 5 月 9 日

變更：

• 修正了導致 AdvancedMarkerElement 的拖曳指示器缺少的錯誤。

3.56.11

2024 年 5 月 2 日

變更：

• [beta 頻道] <gmp-map> 現在，當設定了地圖 ID 但未在地圖 ID 上設定明確渲染類型時，也會預設使用向量模式（例如 DEMO_MAP_ID）。

3.56.10

2024 年 4 月 25 日

變更：

• [beta 通道] PlaceAutocompleteElement 的 gmp-placeselect 事件現在可以冒泡了。
• [beta 頻道] 新增資訊視窗關閉按鈕和選用標題列。
• [beta 通道] 改進了街景小人控制的鍵盤和單指針輔助功能。
• 修復了移除高級標記後導致的記憶體洩漏問題。
• 修復了繪製圓形時無法繪製平滑邊緣的問題。
• 新增了在 google.maps.Map 實例化期間設定向量模式的 API（不需要 mapId）。

3.56.8

2024 年 4 月 11 日

變更：

• 修正了使用 AdvancedMarkerElement 時出現的記憶體洩漏問題。

3.56.7

2024 年 4 月 4 日

變更：

• 在新的 Place 類別中新增 searchNearby 函數。

3.56.6

2024 年 3 月 28 日

變更：

• [beta 通道] 地圖柵格瓦片現在以 WebP 影像格式提供。
• 固定向量地圖上地圖興趣點的資訊視窗錨點位置。
• 修正了顯示 AdvancedMarkerElement 時未指定位置的錯誤。
• 為 InfoWindow API 新增了「關閉」事件。

3.56.5

2024 年 3 月 21 日

變更：

• [beta 通道] 新的底圖顏色現在是未使用地圖 ID 的開發者的預設。請造訪 https://developers.google.com/maps/new-basemap-style-opt-in 查看更多。
• 修正了資訊視窗中向量地圖標籤和圖示的基準位置。

3.56.4

2024 年 3 月 14 日

沒有面向大眾的變更。

3.56.3

2024 年 3 月 7 日

沒有面向大眾的變更。

3.56.1

2024 年 2 月 22 日

變更：

• 修正了 Place.searchByText 的“fields”參數中的文件錯誤。
• [beta 通道] 在 <gmp-map> 中建立一個預設插槽，並允許建立自訂元素來包裝 Maps JavaScript API Web 元件。
• 在新的 Place 類別 API 中新增停車選項。
• 棄用 google.maps.Marker。請改用 google.maps.marker.AdvancedMarkerElement。目前，google.maps.Marker 暫無停用計劃，但建議使用 google.maps.marker.AdvancedMarkerElement 而不是 google.maps.Marker。雖然 google.maps.Marker 將繼續獲得任何重大回歸的錯誤修復，但 google.maps.Marker 中已存在的錯誤將不會解決。如要停止支援，我們會在至少 12 個月前發出通知。請造訪 https://developers.google.com/maps/deprecations 查看棄用詳情。
• 為新的 Place 類別 API 新增其他屬性。
• 為新的 Place 類別 API 新增付款選項。

3.55.11a

2024 年 2 月 15 日

變更：

• 阻止地圖在點擊時自動滾動顯示。

3.55.11

2024 年 2 月 8 日

變更：

• [alpha 通道] 從 PlaceAutocompleteElement 移除 inputElement 屬性。
• [Alpha 版] 為 Place Autocomplete 元素新增 CSS 零件
• [Beta 版] PlaceAutocompleteElement 現已推出預先發布版 (v=beta)
• 為 Places V2 API 新增輔助功能選項。

3.55.10

2024 年 2 月 1 日

變更：

• [beta 通道] 棄用 SearchByTextRequest.rankBy。請改用 SearchByTextRequest.rankPreference。
• [beta 通道] Place.findPlaceFromQuery 和 Place.findPlaceFromPhoneNumber 已不再可用；請改用 Place.searchByText。
• 修復各管道的使用情況追蹤問題。
• 在 JavaScript 行程分享中，為「行程」和「車輛位置」供應商啟用「考量交通狀況的多線段」功能。
• 新的 Place 類別現已在每週版本中推出。
• 棄用 Place.openingHours。請使用常規營業時間。

3.55.9

2024 年 1 月 25 日

變更：

• [Beta 版] 修正問題：在 MapElement 上按下 Esc 鍵時，無法關閉鍵盤快速鍵對話方塊。
• 為引導程式 URL 新增了一個新的 URL 參數 loading=async，用於直接載入腳本。這表明 Maps JavaScript API 沒有同步加載，並且腳本的 load 事件沒有觸發任何 JavaScript 程式碼。為提高效能，強烈建議盡可能將其設定為 async。

3.55.8

2024 年 1 月 18 日

變更：

• [alpha 通道] 現在將會話令牌作為 PlaceAutocompleteElement 請求的一部分傳送。
• [beta 通道] 在 AdvancedMarkerElement 中引入新屬性 gmpClickable。對於在 beta 頻道中使用 addEventListener() 註冊 gmp-click 事件的使用者來說，這是一個重大變更。如要在點擊時接收 gmp-click 事件，請將 gmpClickable 屬性設為 true，或將 gmp-clickable 屬性新增至 網頁元件。如果使用者使用 addListener() 註冊 gmp-click 事件，目前不需要進行任何變更。

3.55.7

2024 年 1 月 11 日

變更：

• [Beta 版] AdvancedMarkerElement 的 element 屬性現在會指向 AdvancedMarkerElement 的例項。
• [Beta 版頻道] 進階標記現在可使用子節點自訂內容。
• 修正了點擊地圖後平移和縮放鍵盤快速鍵不起作用的錯誤。
• 啟用 JavaScript 行程分享的折線自訂功能。
• [alpha 通道] 為 PlaceAutocomplete 新增 types、requestedLanguage、requestedRegion 和 name 屬性。
• [beta 通道] 修正了在呼叫 document.createElement('gmp-advanced-marker') 時無法建立進階標記元素的錯誤。

3.55.3

2023 年 11 月 30 日

沒有面向大眾的變更。

3.55.2

2023 年 11 月 23 日

變更：

• 修正導致街景服務發生樣式相關 CSP 錯誤的錯誤

3.55.1

2023 年 11 月 16 日

沒有面向大眾的變更。

3.54.12a

2023 年 11 月 8 日

變更：

• 修正導致 WebGLOverlayView 無法在特定情況下算繪的錯誤。

3.54.12

2023 年 11 月 2 日

變更：

• [alpha 通道] 將地點自動完成更新為 Web 元件。這是一項破壞性變更。請參閱 https://developers.google.com/maps/documentation/javascript/reference/places-widget#PlaceAutocompleteElement 以取得更新的使用資訊。
• [alpha 通道] 更新位置自動完成元素焦點管理
• [Beta 版管道] 在 MapElements 中公開 gmp-zoomchange 事件
• 啟用 MapTypeControl HORIZONTAL_BAR 可自動處理 RTL 佈局上下文。

3.54.11

2023 年 10 月 26 日

變更：

• 修正了在地圖上設定控制項時可能出現錯誤的問題。
• 透過 StreetViewLocationRequest 和 StreetViewControlOptions，增加將街景影像限制為僅限官方 Google 來源的功能。

3.54.10

2023 年 10 月 18 日

變更：

• [beta 頻道] MapElement 現在會根據其計算出的 direction 樣式自動調整其控制項佈局，以適應從左到右或從右到左的佈局。此外，還提供插槽用於新增自訂控制項。ControlPosition 現在支援 LTR/RTL 版面支援的邏輯值。Maps Embed API 現在也會根據語言自動調整其控制佈局，以適應從左到右或從右到左的閱讀方向。
• [beta 版] MapElement 現在已啟用 delegatesFocus

3.54.9

2023 年 10 月 12 日

• [beta 頻道] 為 Places v2 API 新增編輯摘要。

3.54.7a

2023 年 9 月 28 日

變更：

• 在 Journey Sharing JavaScript 中增加了對多個位置提供者的支援。

3.54.6

2023 年 9 月 21 日

變更：

• google.maps.FeatureLayer 回應滑鼠移動事件。
• 新增了 google.maps.FeatureType.SCHOOL_DISTRICT，因此在資料驅動樣式中支援學區。

3.54.5

2023 年 9 月 14 日

變更：

• [beta 通道] 修正了導致 AdvancedMarkerElement 的 addEventListener() 不可用的錯誤。

3.54.4

2023 年 9 月 7 日

變更：

• 谷歌標誌與地圖上的版權資訊重疊的次數將減少。

3.54.2

2023 年 8 月 24 日

變更：

• 修復了 DirectionsRenderer 中的一個錯誤，如果在渲染 DirectionsResult 之前沒有設定縮放和中心，則地圖將無法載入。

3.54.1

2023 年 8 月 18 日

變更：

• 升級 Maps JavaScript API，使其原生支援 ECMAScript 2020。
• 高級標記現在顯示得更清晰。
• 當 Array.from 被重寫為不支援可迭代物件的實作時，映射功能將被停用。
• 修正了在極限等級停用縮放按鈕時焦點遺失的問題。

3.53.13

2023 年 7 月 27 日

變更：

• [beta 通道] 新 Place 類別中的屬性已重構。PhotoAttribution 現在是 AuthorAttribution。author 現在是 displayName。authorURI 現在是 uri。photoURI {?string} 現已在 AuthorAttribution 上可用。Photo.attributions 現在是 Photo.authorAttributions。Review.authorAttribution {?AuthorAttribution} 替換 Photo.author/authorURI/authorPhotoURI。
• [Beta 版] 在 Place 類別的 searchByText() 方法中新增必要欄位 textQuery，並淘汰 query。
• 調整了柵格地圖標籤和圖示的資訊視窗錨點偏移量。

3.53.12

2023 年 7 月 20 日

變更：

• [beta 通道] 為 JavaScript Journey Sharing - 車隊追蹤增加了 ODRD 車輛和車隊位置提供者。
• 更新了忽略傳遞給 LatLng() 建構函數的參數時的警告訊息。
• 已棄用 Marker.collisionBehavior，請改用 AdvancedMarkerElement.collisionBehavior。

3.53.11

2023 年 7 月 13 日

變更：

• 如果指定點與折線的起點或邊緣距離夠近，函式 isLocationOnEdge() 現在會傳回 true。
• 新增錯誤日誌，以便開發人員瞭解向量地圖載入失敗並回退到柵格地圖的情況。

3.53.7

2023 年 6 月 15 日

變更：

• [Alpha 版] 更新 Place Autocomplete 元素，進一步支援螢幕閱讀器和其他輔助技術。

3.53.5

2023 年 6 月 1 日

變更：

• 允許將節點元素傳遞給高階標記的 content 屬性。
• 改進了高級標記碰撞行為的性能。
• 在 JavaScript 路線分享中，新增了 DeliveryVehicleStop 的欄位。

3.53.4a

2023 年 5 月 24 日

修正錯誤：

• 修正了向量地圖上出現的閃爍問題。
• 修正在 getNextOpeningTime() 地點方法中，因不同時區而導致的日期計算錯誤。
• 更正了 Journey Sharing 中 VehicleJourneySegment 的錯誤類型。

3.53.3

2023 年 5 月 18 日

變更：

• [alpha 通道] 修正了使用箭頭鍵來反白顯示預測內容，然後按 Esc 鍵時，「放置自動完成元素」不會恢復原始文字的錯誤。
• [alpha 通道] 更新了地點自動完成預測樣式，以確保在文字溢出時顯示省略號。
• [beta 頻道] 本機上下文現在會顯示一則通知，提示本機上下文地圖上的位置上下文資訊即將消失。
• 修正了街景小人圖示只有在至少一次返回停靠欄後才會顯示懸停拖曳預覽的錯誤。
• Place Autocomplete 服務中已淘汰的邊界、位置和半徑。請改用 locationBias 和 locationRestriction。

3.53.2

2023 年 5 月 4 日

變更：

• [Beta 版管道] 資料集資料導向樣式現已推出
• [Beta 版] <gmp-map> 和 <gmp-advanced-marker> 網頁元件現已推出。
• 在 JavaScript Journey Sharing 中，為 Task 和 TaskTrackingInfo 新增 TimeWindow 欄位。
• AdvancedMarkerElement 和 PinElement 已發布到每週頻道。
• Boundaries 的數據驅動型樣式已發布到每週頻道。
• getMapCapabilities 和 mapcapabilities_changed 活動將在每週頻道發布。

3.53.1a

2023 年 4 月 27 日

變更：

• 更新了地點自動完成服務，以支援位置偏好和位置限制
• [Beta 版管道] 發布 Place v2 toJSON 方法的說明文件。
• [beta 頻道] 修正了地圖換行時進階標記拖曳的問題。
• [beta 通道] 資料驅動樣式 PlaceFeature.fetchPlace 顯示名稱將以最終使用者的語言顯示。
• [測試版] AdvancedMarkerView 和 PinView 已重新命名為 AdvancedMarkerElement 和 PinElement。
• [Beta 版] 修正問題：有時系統不會明確載入 AdvancedMarkers 和 Pins，但這些項目仍可使用。請務必先載入「marker」程式庫，再存取這些類別。
• [beta 通道] 高級標記 position 現已標準化為 LatLngAltitude。
• [Beta 版管道] 淘汰進階標記 draggable 屬性，改用 gmpDraggable。

3.52.9

2023 年 4 月 13 日

變更：

• [Beta 版管道] 將 Place 屬性「priceLevel」的值從數字變更為字串。「priceLevel」的可能值現在為：「FREE」、「INEXPENSIVE」、「MODERATE」、「EXPENSIVE」、「VERY_EXPENSIVE」。
• [測試版] 淘汰 AdvancedMarkerView.draggable，改用 gmpDraggable。
• [Beta 版管道] 從 Place 類別中移除「icon」屬性和欄位名稱。建議開發人員改用「svgIconMaskURI」。
• [Beta 版管道] AdvancedMarkerView 的 title 屬性現在只接受字串。如要移除名稱，請使用空字串。
• [Beta 版管道] 新增「svgIconMaskURI」，做為 Place.fromPlaceFrom 方法支援的欄位名稱。
• [Beta 版管道] 將 Place 類別屬性從 userRatingsCount 變更為 userRatingCount
• 改善記錄到控制台時的錯誤列印。

修正錯誤：

• 修正關閉 InfoWindow 時會導致錯誤的錯誤。

3.52.8

2023 年 4 月 6 日

變更：

• 在 JavaScript Journey Sharing 中，將 pollingIntervalMillis 新增為投票所供應商的公開欄位。
• [Beta 版管道] 將 Place 類別 JSON 回應從 snake_case 改為 lowerCamelCase。

修正錯誤：

• 修正地點評論的 publishTime 顯示錯誤日期的問題。
• 修正建立自訂元素時會導致全域中斷的問題。
• [Beta 版管道] 修正地圖包裝時，進階標記會消失的錯誤。

3.52.6

2023 年 3 月 23 日

變更：

• [Alpha 版] 推出 Place Autocomplete 小工具 (新版) 實驗功能。
• 在每週頻道中發布 JavaScript 學習歷程分享。

3.52.5

2023 年 3 月 16 日

變更：

• [Beta 版] 資料導向樣式：移除 NEIGHBORHOOD、ADMINISTRATIVE_AREA_LEVEL_3、 ADMINISTRATIVE_AREA_LEVEL_4 和 SUBLOCALITY_LEVEL_1 FeatureType。

修正錯誤：

• 修正錯誤：importLibrary() 使用的程式庫的 TypeScript 介面為空白。

3.52.4

2023 年 3 月 9 日

變更：

• [Beta 版] 拖曳標記時，系統會抑制進階標記的點擊事件。

3.52.3

2023 年 3 月 2 日

變更：

• [beta 頻道] 為 JavaScript Journey Sharing 新增 TaskTrackingInfo 實體。
• [beta 通道] 升級 Maps JavaScript API 以原生支援 ECMAScript 2020。

修正錯誤：

• 修正了在新增及移除地圖標記時可能發生的記憶體流失問題。
• 修正錯誤：在觸控裝置上，當可點選的進階標記下方有互動式元素時，該元素會變成可點選。

3.52.2

2023 年 2 月 23 日

變更：

• [Beta 版管道] 資料導向樣式：移除 PlaceFeature.displayName 屬性。
• [Beta 版管道] 修正呼叫 setMap(null) 時，WebGLOverlayViews 未正確移除的問題
• 修正錯誤：系統會回報 search 程式庫不明。
• 修正錯誤：在陰影根中，InfoWindow 關閉按鈕會隱藏。
• 為改善 Core Web Vitals 並減少不必要的資料移轉，Maps JS 現在會延遲載入地圖圖塊，直到地圖接近檢視區塊為止。在網頁初始可視區域內建立的地圖應該不會有任何差異。

3.52.1

2023 年 2 月 16 日

變更：

• 新增 importLibrary() 函式，可在執行階段動態載入程式庫。
• [Beta 版管道] 在進階標記上開啟時，啟用 InfoWindow 的自動平移功能。
• [Beta 版管道] 將旅程分享程式庫資料物件中的特定欄位設為不可為空值
• [Beta 版] 資料導向樣式：NEIGHBORHOOD、ADMINISTRATIVE_AREA_LEVEL_3、ADMINISTRATIVE_AREA_LEVEL_4 和 SUBLOCALITY_LEVEL_1 FeatureType 已淘汰。並於 2023 年 3 月移除。

3.51.8

2023 年 2 月 2 日

變更：

• Beta 版管道：支援在自訂地圖類型上算繪進階標記。
• 現在，最新版本的內嵌 bootstrap 載入器會重複使用文件中其他位置的 CSP 隨機值。

3.51.7

2023 年 1 月 26 日

變更：

• Beta 版管道：資料導向樣式：新增 fetchPlace 方法，可取得 PlaceFeature 的顯示名稱。PlaceFeature.displayName 屬性將於 2023 年 2 月淘汰並移除。

3.51.6

2023 年 1 月 19 日

修正錯誤：

• 修正進階標記的問題：從地圖中移除有碰撞的標記時，有時可能會在 DOM 中留下虛影標記元素。

3.51.5

2023 年 1 月 12 日

變更：

• 修正 AdvancedMarkerView、PinView 和 LocalContextMapView 上的 element 類型，從 Element 改為 HTMLElement | SVGElement，更貼近必要元素類型。

修正錯誤：

• 修正使用進階標記和資訊視窗時的錯誤。如果使用鍵盤拖曳標記，資訊視窗可能不會開啟。

3.51.4

2023 年 1 月 5 日

變更：

• Beta 版管道：在位置類別中新增屬性
• Beta 版：資料導向樣式 FeatureMouseEvent.features 陣列可能包含多個特徵 (如果點擊位置下方有多個特徵)，且點擊位置下方的所有 FeatureLayer 點擊事件監聽器都會觸發。
• Beta 版管道：針對 google.maps.Map.getFeatureLayer 的無效引數擲回錯誤。
• 修正全螢幕地圖上進階標記的像素位置。
• 變更地圖滑鼠事件，現在會忽略已按下其他滑鼠按鈕時發生的滑鼠按鈕點擊事件。
• 修正地圖放大時進階標記消失的錯誤。
• 改善縮放地圖時的效能，地圖中包含許多進階標記。
• 更新 StreetViewPanoramaOptions 說明文件，明確指出自訂全景無法使用 clickToGo。
• 改善建立 LatLngBounds 時的效能，包括透過 Map.getBounds() 建立。
• 更新 onAdd 和 onRemove 的 WebGLOverlayView 參照。
• 為行程分享功能新增固定標記樣式自訂設定。

3.51.3

2022 年 12 月 8 日

變更：

• 修正錯誤：標記超出地圖可視區域時，不會放棄鍵盤焦點。
• Beta 版管道：推出 Place 類別，這是支援 Promise 等新型使用模式的全新簡化 API。「地點」類別包含一些新的資料欄位。
• Beta 版管道：修正錯誤，以防在傳遞以 Proxy 包裝的地圖時，進階標記無法轉譯。
• Beta 版頻道：為 JavaScript 行程分享功能新增行程地點供應商標記自訂功能。

3.51.2

2022 年 12 月 1 日

變更：

• Beta 版：google.maps.importLibrary() API 現已推出。
• Beta 版：已淘汰：當地特色已淘汰，不建議用於新網站。相關功能會繼續運作；如要停止支援，我們會在 12 個月前發出通知。如果想要自行設計類似當地特色資料庫的服務，建議您參考快速建構工具中的「社區機能探索」解決方案，或是使用 Maps JavaScript API 的 Places Library。如需相關說明，請查看 Places Library 的程式碼範例或利用程式碼研究室資源。
• Beta 版：為改善 Core Web Vitals 並減少不必要的資料移轉，Maps JS 現在會延遲載入地圖圖塊，直到地圖接近可視區域為止。在網頁的初始可視區域內建立的地圖應該不會有差異。
• Beta 版管道：為「行程分享」位置資訊供應商新增輪詢狀態變更的事件。
• Beta 版頻道：新增「行程分享」的樣式自訂功能。淘汰舊版設定方法。
• 在路線面板的步驟中新增鍵盤無障礙功能。現在可以使用 Tab 鍵瀏覽路線，並使用空格鍵或 Enter 鍵選取路線。
• google.maps.geometry.spherical.computeArea() 現在接受 LatLngBounds 和 Circle。LatLngBounds 現在可使用 LatLngBoundsLiteral 建構。
• 在「建議路線」DirectionRenderer面板的圖片中新增 alt 文字。

3.51.1

2022 年 11 月 17 日

變更：

• Beta 版管道：發布 Places 程式庫中的 Place 類別。
• Beta 版頻道：新增「行程分享」的樣式自訂功能。舊版設定方法已遭淘汰。
• Maps Embed API 現已淘汰 Internet Explorer 11。
• 使用混合或衛星地圖類型時，Maps Embed API 中的 Google 標誌會變更樣式，提高可見度
• 提升進階標記的載入效能。
• 讓「復原」繪圖按鈕可透過鍵盤存取，並支援螢幕閱讀器。
• 讓方向資訊算繪器的標記可透過鍵盤存取，且方便螢幕閱讀器使用。
• 為地圖比例尺控制項新增 ARIA 說明。
• 啟用地圖比例尺控制項的鍵盤焦點和互動功能。
• 在 Geocoder JS API 中導入語言參數。如果未明確指定，Maps JS API 不會再將 US 視為 Geocoder 中的預設區域。
• 在 Directions JavaScript API 中導入語言參數。
• 為 Distance Matrix JS API 導入語言參數。

修正錯誤：

• 修正錯誤：開啟資訊視窗時，鍵盤焦點會重新導向標記。
• 修正導致標記無法成為焦點的錯誤。

3.51

2022 年 11 月 16 日

變更：

• 每週版本已更新至 3.51 版。
• 每季版本已更新至 3.50 版。
• 如要使用 3.49 和 3.48 版，請透過號碼要求。

3.50.12a

2022 年 11 月 7 日

變更：

• 修正 google.maps.event.addListenerOnce 和 google.maps.event.addDomListenerOnce 的 this 繫結不正確問題。

3.50.12

2022 年 11 月 3 日

變更：

• Beta 版管道：在傾斜地圖上使用進階標記時，現在支援海拔高度。

3.50.11

2022 年 10 月 27 日

變更：

• Beta 版：資料導向樣式功能圖層無法使用時，系統現在會記錄錯誤。
• Beta 版管道：改善預設進階標記的載入效能。

3.50.10

2022 年 10 月 20 日

修正錯誤：

• 修正 iOS 上的 InfoWindow 右側和底部邊框間距。

3.50.9

2022 年 10 月 13 日

變更：

• 選取的步驟現在會在路線面板中醒目顯示。
• 修正 PinView 建構函式的 TypeScript 型別。
• 修正 LagLngAltitude 建構函式的 TypeScript 型別。
• 更新 DirectionsRenderer 中的預設標記圖示圖片。

3.50.8

2022 年 10 月 6 日

變更：

• Beta 版：發布進階標記預先發布版。
• Beta 版管道：推出 isAdvancedMarkersAvailable 的說明文件，說明 getMapCapabilities() 回傳物件。
• 在 LocalContextMapView 的 API 說明中，以及 LocalContextMapViewOption 的 element 屬性中，新增「這個欄位為唯讀。」

修正錯誤：

• JSON 自訂樣式中的顏色現在會使用預設樣式的透明度，而非強制使用 100% 透明度。

3.50.7

2022 年 9 月 29 日

變更：

• 螢幕閱讀器現在會朗讀地圖和街景服務的互動方式說明。
• 在鍵盤快速鍵對話方塊中新增傾斜和旋轉鍵盤快速鍵。

3.50.6

2022 年 9 月 22 日

修正錯誤：

• 修正錯誤：iOS 上的 Voice Over 可以瀏覽鍵盤快速鍵對話方塊下方的元素。
• 為靜態地圖圖片新增替代文字。

變更：

• 現在，當呼叫 map.getMapCapabilities() 時，如果發生錯誤，則會在控制台中記錄錯誤。

3.50.5

2022 年 9 月 15 日

變更：

• 新增 MAX_BOUNDS 常數，用於 LatLngBounds，表示地圖的 LatLng 邊界上限
• 允許螢幕閱讀器對預設標記執行點擊動作。

3.50.3

2022 年 9 月 1 日

變更：

• Beta 版管道：更新 JavaScript Journey Sharing 的 DeliveryVehicle 類別，加入自訂屬性。
• 修正地圖傾斜後，事件中 LatLng 錯誤的問題。

3.50.2

2022 年 8 月 25 日

變更：

• Beta 版管道：變更 FleetEngineDeliveryFleetLocationProvider，接受字串送貨車輛篩選條件。
• 更新預設標記圖示圖片。

3.50.1

2022 年 8 月 18 日

變更：

• Beta 通道：向 Beta 通道引入地圖功能 API（getMapCapabilities 和 mapcapabilities_changed 事件）。
• Beta 版：在 google.maps.Geocoder 中導入 language 參數。
• Beta 版：在 google.maps.DistanceMatrixService 中導入 language 參數。
• Beta 版：在 google.maps.DirectionsService 中導入 language 參數。
• 修正多個 Places JS API 忽略區域代碼的錯誤。為各種 Place JS API 導入語言和區域參數。
• 如果網站的內容安全政策設定中沒有 googleapis.com 網域，Maps JavaScript API 街景服務將不再支援這類網站。詳情請參閱內容安全政策指南。

3.49.12

2022 年 8 月 4 日

變更：

• 新增 DEMO_MAP_ID，也就是地圖 ID，可用於需要地圖 ID 的程式碼範例。這個地圖 ID 不適用於正式版應用程式，也無法用於需要雲端設定的功能 (例如雲端式樣式設定)。
• 明確指出需要 FleetEngineDeliverFleetLocationProvider.locationRestriction 才能開始追蹤。

3.49.11

2022 年 7 月 28 日

變更：

• google.maps.VehicleType 現在可做為執行階段列舉參照。

3.49.10

2022 年 7 月 21 日

變更：

• 驗證標記圖示大小、標記圖示縮放大小或資訊視窗大小時，系統會拒絕 NaN 值。
• 修正錯誤：在街景服務中，iOS 裝置上不會顯示動作追蹤控制項。
• 修正 Embed API 中的錯誤，避免從右到左 (RTL) 語言的路線懸停文字遭到截斷。
• 讓大眾運輸資訊視窗更易於存取，且方便螢幕閱讀器使用。

3.49.9

2022 年 7 月 14 日

變更：

• 清楚說明在行程分享位置資訊提供者中使用 ID 欄位的方式。

3.49.8

2022 年 7 月 7 日

變更：

• 讓街景服務導覽連結可透過鍵盤存取，並支援螢幕閱讀器。
• 在 StreetViewPanorama 上推出新的 focus 方法。

3.49

2022 年 6 月 23 日

變更：

• Beta 版：發布Google 邊界資料導向樣式。

修正錯誤：

• 透過 google.maps.places.BusinessStatus 存取 BusinessStatus 列舉。

3.49.5

2022 年 6 月 16 日

變更：

• 在街景服務中新增鍵盤快速鍵控制項和對話方塊，提升鍵盤快速鍵的能見度。

修正錯誤：

• 修正關閉街景服務時表單會提交的錯誤。

3.49.4

2022 年 6 月 9 日

變更：

• 將 WebGLOverlayView、CameraParams、LatLngAltitude、moveCamera、分數縮放和 getVisibleRegion 移至每週管道。
• Map 的預設街景服務全景現在會在開啟時自動管理焦點。這是新的預設行為。
• 街景服務全景現在會在關閉時自動還原焦點 (如有可能)。
• 現在按下 ESC 鍵 (關閉按鈕啟用時)，即可關閉街景服務。
• geometry.spherical.computeSignedArea() 和 geometry.spherical.computeArea() 經過最佳化，可提高穩定性和準確度。

3.49.3a

2022 年 6 月 2 日

變更：

• 改善街景服務動作追蹤控制項的色彩對比度。
• 街景服務的動作追蹤控制項現在可透過鍵盤操作，且支援螢幕閱讀器。
• MapsNetworkError、MapsRequestError 和 MapsServerError 類別現在已公開，並提供相關文件。

3.49.2

2022 年 5 月 26 日

變更：

• 改善街景服務動作追蹤控制項的色彩對比度。
• 街景服務的動作追蹤控制項現在可透過鍵盤操作，且支援螢幕閱讀器。
• MapsNetworkError、MapsRequestError 和 MapsServerError 類別現已公開並有文件說明。

3.49.1

2022 年 5 月 19 日

變更：

• Beta 版管道：修正多個 Places JS API 忽略區域代碼的錯誤。為各種 Place JS API 導入語言和區域參數。
• 在深色模式下，改善全螢幕和指南針控制項的色彩對比。
• 讓街景服務的羅盤控制項、關閉按鈕和地址連結控制項可供存取，並支援螢幕閱讀器。

3.49

2022 年 5 月 12 日

變更：

• 每週版本更新至 3.49 版。
• 每季版本更新至 3.48 版。
• 如要使用 3.47 和 3.46 版，請依編號提出要求。
• 3.45 版已刪除，無法再使用。

3.48.11

2022 年 4 月 28 日

變更：

• Place Autocomplete 現在可接受更多類型。 瞭解詳情。
• 「isFractionalZoom」已移至每週頻道。

3.48.9

2022 年 4 月 14 日

變更：

• Beta 版：為 WebGLOverlayView 啟用 WebGL 2.0。
• Beta 版：將 JourneySharing 程式庫納入 Maps JavaScript API TypeScript 型別、外部函式和參考文件。
• google.maps.event.addDomListener() 和 google.maps.event.addDomListenerOnce() 函式已淘汰，不建議使用。請改用標準 addEventListener() 方法。這些方法會繼續運作，目前無停用計畫。
• 在街景服務標記圖示中新增 title 和 aria-label。
• 為 Fullscreen 控制項新增 aria-pressed 屬性。
• 改進了 地圖類型 控制項的下拉式選單間距。
• 更新 地圖類型 下拉控制項的 aria 標籤。

修正錯誤：

• 從預設地圖類型控制項中移除不允許的 aria-expanded 屬性。

3.48.8

2022 年 4 月 7 日

變更：

• 改善 Maps JS API 和 Embed API 中 Google 標誌的色彩對比。

3.48.7a

2022 年 3 月 31 日

變更：

• Beta 版：移除已淘汰的 WebGL 疊加層檢視 API。
• 為 Maps JavaScript API 客戶啟用 更新的底圖。更新後的基本地圖已在 Google 地圖消費者版中採用，可提供更豐富、更詳細的基本地圖，特別是陸地的自然地貌。

修正錯誤：

• 還原 map.fitBounds() 的先前修正 (縮短距離時，可簡化視埠轉場效果)，待分析。
• 修正了高對比度模式下地圖類型控制的顏色對比問題。
• 將地圖類型控制項核取方塊的無障礙名稱，與對應的視覺標籤相符。
• 修正高對比色彩模式下資訊視窗的色彩對比問題。

3.48.6

2022 年 3 月 24 日

變更：

• 修正 map.fitBounds()，縮短距離時可輕鬆轉換可視區域。

3.48.5

2022 年 3 月 17 日

變更：

• 僅限 Safari：確保關閉按鈕和內容容器在 open 上自動聚焦。

修正錯誤：

• 修正 sInfoWindows 上「在 Google 地圖上查看」連結的色彩對比問題。
• 修正了 StreetViewPanorama 位址控制項上「在 Google 地圖上查看」連結的顏色對比問題。

3.48.4

2022 年 3 月 10 日

變更：

• 推出適用於 InfoWindow 的新 visible 事件。
• 在 InfoWindow 上引入新的 focus 方法。

3.48.3

2022 年 3 月 3 日

變更：

• Beta 頻道：在 Maps JavaScript API 街景服務中啟用新的服務呼叫方式。您可能需要更新您的 內容安全策略，以確保這些呼叫不會在瀏覽器層級被封鎖。
• 為 InfoWindow 引入了一個新的 ariaLabel 屬性。

3.48.1

2022 年 2 月 17 日

變更：

• Beta 版：新增設定全域體驗 ID 的支援。請在此處查看 API 參考文件 。
• Beta 通道：fromLatLngAltitude 的第一個和第二個參數現在將合併為 LatLngAltitude，而不是 LatLng 和 number。
• 已將 LatLng 的 noWrap 參數重新命名為 noClampNoWrap。
• 現在螢幕閱讀器會在標記成為焦點時，朗讀標記的導覽說明。
• Maps JavaScript API 現在會報告遙測資訊。您可能需要更新內容安全性策略，以確保這些呼叫不會在瀏覽器層級被封鎖。詳情請參閱常見問題。
• 此版本不支援 Internet Explorer。若要繼續支援 Internet Explorer 11，請指定 v=3.47，該版本將持續到 2022 年 11 月。

3.48

2022 年 2 月 10 日

變更：

• 每週頻道已更新至 3.48 版本。
• 季度頻道已更新至 3.47 版本。
• 版本 3.46 和 3.45 仍可透過編號申請取得。

3.47.6

2022 年 1 月 20 日

修正錯誤：

• 修正了當鍵盤快速鍵控制項獲得焦點時頁面會捲動到頂部的問題。

3.47.4

2022 年 1 月 6 日

變更：

• Beta 通道：WebGLOverlayView API 更新（Beta 版） - 棄用名稱中帶有「gl」的所有類別和方法，改用名稱中帶有「GL」的新類別和方法；棄用 WebglCameraParams，改用新的 CameraParams 類別（繼承自 CameraOptions）。
• 更新了 PlaceOpeningHours 方法文檔，以反映其計算中不使用特殊營業時間。

3.47.3

2021 年 12 月 9 日

變更：

• LatLng、LatLngBounds 和 Circle 現在在建構子中接受同一類別的實例。

3.47.2

2021 年 12 月 2 日

變更：

• 現在，只要 LatLng 允許作為參數，LatLngLiteral 也允許作為參數用於 projections。

修正錯誤：

• 修正了在較小比例值（小於 1.0）下可能出現的一些渲染問題。

3.47.1

2021 年 11 月 18 日

變更：

• 現在，在幾何庫中，凡是允許使用 LatLng 的地方，都可以使用 LatLngLiteral 作為參數。
• 在 Maps JavaScript API 中新增了 onGIStateUpdateRequest API，以支援 WebGL。
• 修復了錯誤螢幕上的顏色對比。
• Internet Explorer 11 現已停用 v=beta 版本。支援 Internet Explorer 11 的 Maps JavaScript API 的最後一個版本是 v3.47。Internet Explorer 11 的支援將於 2022 年 11 月完全停止。
• 當 keyboardShortcuts 地圖選項設定為 false 時，地圖不再獲得 Tab 焦點。
• 當達到最大或最小縮放等級時，放大和縮小按鈕將被停用。
• 將 MapType 控制項轉換為使用語意元素，以改善 Maps Embed API 的可存取性和螢幕閱讀器體驗。
• 為錯誤畫面上的圖示新增了替代文字。
• 多項常規代碼健康改進。

修正錯誤：

• 將不符合 WCAG 標準的 controlHeight 和 controlWidth 屬性替換為符合標準的 data-* 屬性。

3.47

2021 年 11 月 11 日

變更：

• 每週頻道已更新至 3.47 版本。
• 季度頻道已更新至 3.46 版本。
• 版本 3.45 仍可透過電話申請取得。
• 3.44 版本已刪除，無法再使用。

3.46.12

2021 年 11 月 4 日

修正錯誤：

• 更新了地圖類型選單欄，新增了更準確的 ARIA 標籤。
• 嵌入式 API：為多個連結添加了 ARIA 標籤，以改善螢幕閱讀器體驗。
• 嵌入式 API：修復了部分文字項目的顏色對比問題。
• 修復了外部變數 google.maps.Marker.MAX_ZINDEX 的類型。

3.46.11

2021 年 10 月 28 日

變更：

• 將 getter 和 setter 轉換為使用 goog.a11y.aria。這有助於防止拼字錯誤。

3.46.8

2021 年 10 月 7 日

變更：

• 當地特色：從當地特色資訊視窗相片中移除出處連結。

3.46.6

2021 年 9 月 23 日

變更：

• 修正錯誤：地圖無法拖曳時，地圖游標會顯示手形。

3.46.5

2021 年 9 月 16 日

修正錯誤：

• 修正「地點自動完成」小工具的色彩對比度比例錯誤。

3.46.3

2021 年 9 月 2 日

變更：

• 捲動指令現在會顯示在開啟的 InfoWindow 和 CustomOverlay 上方。

3.46.2

2021 年 8 月 26 日

變更：

• Beta 版：現在會回報遙測資訊。您可能需要更新內容安全政策，以確保這些呼叫不會在瀏覽器層級被封鎖。詳情請參閱常見問題。

3.46

2021 年 8 月 18 日

Maps JavaScript API 3.46 版本現已發布。 請參閱版本管理指南。

變更：

• 在 PlaceResult、icon_mask_base_uri 和 icon_background_color 中新增了兩個新欄位。
• 每週版本已更新至 3.46 版。
• 每季版本已更新至 3.45 版。
• 版本 3.44 仍可透過電話申請取得。
• 3.43 版本已刪除，無法再使用。

淘汰項目：

• 我們即將停止支援 Internet Explorer。自 2021 年 8 月起，使用 Maps JavaScript API 3.46 版的 Internet Explorer 11 使用者，會在 Google 地圖頂端看到警告訊息。目前支援 Internet Explorer 11 的最新版 Maps JavaScript API 是 3.47 版。 我們將在 2022 年 11 月全面停止支援 Internet Explorer 11。

修正錯誤：

• 修正多邊形頂點在特定縮放等級下會位移的錯誤。
• 修正了多個資訊視窗內容相互重疊的錯誤。

3.45.8

2021 年 7 月 29 日

變更：

• Embed API：在內嵌地圖上，系統會保留縮放等級，然後將使用者重新導向至路線頁面。

3.45.7

2021 年 7 月 22 日

變更：

• 已棄用對 IE11 的支援。在 Beta 版管道中，IE11 的地圖現在會顯示橫幅。
• 更新嵌入式地圖中的「取得路線」連結，提升準確度。

修正錯誤：

• 修正 getFeatureById() 方法無法擷取 ID 為 0 的特徵問題。
• 修正了當 ComponentRestriction 值為 undefined 或 null 時拋出 UNKNOWN ERROR/SERVICE BACKGROUND ERROR 的問題。

3.45.6a

2021 年 7 月 15 日

變更：

• 開啟時，如果第一個可聚焦的控制項不在資訊視窗可視區域中，或 disableAutoPan=true，焦點現在會移至資訊視窗容器。

修正錯誤：

• 修正了從地圖中移除並重新新增繪圖​​管理器時，未完成的多邊形繪製會自動完成的錯誤。
• 修正錯誤：在部分語言中，「嵌入地圖」彈出式視窗的「路線」字串會遭到截斷。

3.45.5

2021 年 7 月 1 日

變更：

• 更新型別和 JS API 中 Maps Studio 的網址。

修正錯誤：

• 修正提供回呼時未處理的 Promise 拒絕問題。

3.45.4

2021 年 6 月 24 日

變更：

• 修正錯誤：表單提交時會開啟鍵盤快速鍵對話方塊。
• 修正「鍵盤快速鍵」按鈕未對齊的問題。
• 移除意外新增至 window (Spherical、PolylineCodec、PolyGeometry) 的物件。請改用完整命名空間存取這些物件。

3.45.3

2021 年 6 月 16 日

修正錯誤：

• 更新 InfoWindow，因此在與地圖例項化相同的執行迴圈中呼叫 open() 時，焦點不會移動。

變更：

• 更新 InfoWindowOpenOptions API 參考資料部分，提供更詳細的資訊。
• 修正在 Safari 中使用鍵盤導覽 (Tab + Option) 時的焦點環。

3.45.2

2021 年 6 月 10 日

修正錯誤：

• 修正問題：在 Embed API 中，鍵盤快速鍵對話方塊的背景無法正確疊加在地圖類型控制項上。
• 修正載入字型 CSS 樣式時可能導致錯誤的問題。
• 修正錯誤：平移地圖時，如果 InfoWindow 處於開啟狀態，可能會發生閃爍情形。

變更：

• 新增 InfoWindowOpenOptions.map 屬性。

3.45.1

2021 年 6 月 3 日

變更：

• 在 Data.StyleOptions 介面中，新增動畫、圖示、標籤和不透明度屬性的說明文件。
• 重新設計著作權對話方塊，提升無障礙支援。
• 現在開啟 InfoWindow 時，系統會自動管理焦點。這代表新的預設行為。
• 新增 InfoWindowOpenOptions API，讓開發人員控管開啟資訊視窗時的焦點管理方式。
• 現在只要按下 ESC 鍵，即可關閉資訊視窗。
• 使用螢幕閱讀器時，資訊視窗現在會以「對話方塊」的形式顯示。
• 現在已啟用 Polyfill 隔離功能，這項變更可防止系統在主機網頁上安裝 Maps API 內部 Polyfill。

修正錯誤：

• 修正問題：切換瀏覽器分頁時，地圖會顯示焦點環。
• 修正問題：在部分瀏覽器中，以滑鼠與地圖控制項、標記元素和地圖類型控制項子選單項目互動時，焦點環會錯誤顯示。

新功能：

• 在 Directions、Distance Matrix、Elevation、Geocoder、Maximum Zoom Imagery、StreetView 和 AutcompleteService.getPlacePredictions() 服務中，啟用 Promises 支援功能。
• 在地圖上新增鍵盤快速鍵控制項和對話方塊，方便使用者查看鍵盤快速鍵。
• 向量地圖現已在每週發布管道中推出 (僅限基本功能；WebGL 功能則在 Beta 版管道中提供)。

3.44.14

2021 年 5 月 13 日

變更：

• 現在，如果呼叫 InfoWindow.open() 時沒有相關聯的 Map 或 StreetView 執行個體，系統就會在控制台中記錄警告。

3.44.12

2021 年 4 月 28 日

修正錯誤：

• 修正問題：變更為新的地圖類型後，系統會將已移除或隱藏的已最佳化標記重新加回地圖。

當地特色：

• 新增支援沒有 @@iterator 方法的陣列，定義為有效的 placeTypePreferences 值。

3.44.11a

2021 年 4 月 20 日

變更：

• 使用 Icon 物件建立自訂標記時，效能有所提升。
• 防止焦點在懸停於按鈕上時，移至地圖類型下拉式選單。

修正錯誤：

• 修正錯誤：在初始化基本地圖之前載入靜態標記時，可能會發生錯誤。

3.44.9

2021 年 4 月 8 日

修正錯誤：

• 修正錯誤：啟用街景服務時，地圖控制項可透過鍵盤存取。

3.44.8

2021 年 4 月 1 日

變更：

• 當地特色資料庫：將「地點詳細資料」檢視畫面中的 Google 標誌移至內容底部。

3.44.7

2021 年 3 月 25 日

變更：

• 現在，當資訊視窗關閉時，鍵盤焦點會回到對應的元素上。

3.44.4

2021 年 3 月 4 日

變更：

• 45° 圖像 現在提供更廣泛的縮放級別，旋轉控制現在包括順時針和逆時針按鈕。

修正錯誤：

• 修復了重複渲染地圖時可能發生的記憶體洩漏問題。
• 修正了在地圖上新增或刪除圓形或矩形時可能發生的記憶體洩漏問題。

3.44.2

2021 年 2 月 25 日

變更：

• 修正了 beta 通道中 Places Autocomplete getPlacePredictions 函數呼叫錯誤地指向錯誤端點的錯誤。

3.44.1

2021 年 2 月 18 日

變更：

• 重新載入顯示的地點時，本地上下文地點選擇器按鈕將被停用。
• 未優化的標記現在可以聚焦，並且可以透過鍵盤存取。
• Beta 通道：已移除意外新增至 window 中的物件（Spherical、PolylineCodec、PolyGeometry）。這些物件應透過其完全限定的命名空間存取。
• 在 Beta 頻道中啟用 Polyfill 隔離。這意味著 Maps JavaScript API 將不再向宿主頁面安裝 polyfill。

3.43.8a

2021 年 2 月 25 日

僅更新了季度頻道。變更：

• 修復了多次渲染地圖時出現的記憶體洩漏問題

3.43.8

2021 年 2 月 5 日

變更：

• 在 AutocompleteService.getPlacePredictions() 中加入了對 Promises 的 beta 支援。

修正錯誤：

• 修正了即使 clickable 設定為 false，帶有標籤的 Markers 也會攔截點擊事件的問題。

3.43.7a

2021 年 1 月 28 日

修正錯誤：

• 修正了與繪製折線相關的各種問題。

3.43.6

2021 年 1 月 21 日

修正錯誤：

• 修正了 geojson 多邊形空洞有時會被填滿的錯誤。
• 修正了在地圖視圖和街景視圖之間切換時疊加層消失的錯誤。

3.43.5

2021 年 1 月 14 日

變更：

• 修改了選單中的複選框，使其更易於螢幕閱讀器存取。
• 增加了室內街景全景圖的 樓層 按鈕的尺寸。
• 修正街景服務中行動裝置動作追蹤控制項的位置。

修正錯誤：

• 現在鍵盤選單按鈕會觸發 contextmenu 事件。
• 修正了在某些情況下切換地圖和街景時全螢幕控制無法正常工作的錯誤。
• 修正了螢幕閱讀器無法導航到地圖中的標記的問題。
• 修正了導致 LocalContext 位置標記中的位置圖示消失的錯誤。

3.43.3

2020 年 12 月 9 日

變更：

• 將 google.maps.MouseEvent 介面重新命名為 google.maps.MapMouseEvent，並新增了 domEvent 屬性，從而可以直接從 DOM 存取底層事件。
• 改進了多邊形疊加層的記憶體行為。
• 現在已明確釋放 Canvas 內存，以避免 Safari 出現內存問題。

修正錯誤：

• 修正了在某些情況下切換地圖和街景視圖時全螢幕控制停止工作的錯誤。
• 修正了標記的 click 事件在控制台中記錄錯誤的問題。
• 修正了標記的可點擊區域繪製過大的錯誤。
• 修正了影響 IE11 上符號顯示的 polyfill 衝突錯誤。

3.43.2

2020 年 12 月 1 日

變更：

• 添加 contextmenu 事件，作為 rightclick 事件的更好替代方案。 contextmenu 事件增加了在 macOS 上回應 ctrl-click 的功能。
• 當提供 title 或 label 時，請向非最佳化標記新增輔助功能屬性。
• 為 MapType 控制項添加更多 ARIA 標籤和角色，以改善螢幕閱讀器體驗。
• 改進了螢幕閱讀器對 MapType 控制項的支援。當使用者離開該控制項時，下拉式選單會自動關閉。
• 更正螢幕閱讀器在下拉式選單中報告的項目數；這樣可以防止將行分隔符計為清單項目。
• 在 map 元素內新增一個焦點環，當透過鍵盤互動獲得焦點時，該焦點環會指示鍵盤焦點。
• 在 MapType 控制項中新增其他鍵盤控制項。 現在，當控制項失去焦點時，下拉式選單選項會自動關閉。 上下箭頭鍵開啟下拉式選單，Esc 鍵關閉下拉式選單。 Home 鍵和 End 鍵分別將遊標移到下拉式選單中的第一個和最後一個項目。

修正錯誤：

• 修正了一個錯誤，該錯誤會導致在某些情況下取消標記動畫時，該特定標記提前終止後續動畫。

3.43.1a

2020 年 11 月 20 日

變更：

• 在 MarkerLabel 介面中新增 className 屬性，以設定 label 元素的 CSS 類別。
• 在最大縮放圖像服務中，新增 Promises 的 Beta 版支援。
• 在 StreetView 服務中新增對 Promises 的 beta 支援。
• 當提供 title 或 label 時，請向未最佳化標記新增輔助功能文字。
• 從 MapType 控制項下拉選單按鈕中移除了 aria-pressed 標籤，以提高可存取性。
• 將 DropdownMenu 和 DropdownMenuItem 轉換為語義元素，以提高可訪問性。
• 修改版權資訊文本，使其符合顏色對比標準。
• 現在可以使用回車鍵或空白鍵來開啟和關閉下拉式選單。
• 現在可以聚焦下拉式選單項目了。
• 本機上下文庫：輪播圖控制按鈕現在在不起作用時會被停用，並且不再與清單中的第一個或最後一個項目重疊。

修正錯誤：

• 修正了當 GroundOverlays 越過 180 度子午線時可能發生的錯誤。
• 當 disableDefaultUI 設定為 true 時，鍵盤快速鍵不再預設為停用。
• 修正地圖切換按鈕的螢幕閱讀器文字錯誤。
• 將無障礙名稱和類型新增至 Map。
• 修正介面文件，先前文件錯誤地將部分選用屬性顯示為必要屬性。
• 修正了當傳遞 LatLngLiteral 時，noWrap LatLng 建構子參數被忽略的錯誤。

3.43

2020 年 11 月 18 日

Maps JavaScript API 3.43 版本現已發布。 請參閱版本管理指南。

• 每週頻道已更新至 3.43 版本。
• 季度頻道已更新至 3.42 版本。
• 如果要求使用特定號碼，仍可使用 3.41 版。
• 3.40 版已刪除，無法再使用。

3.42.9

2020 年 10 月 15 日

變更：

• 修正了螢幕閱讀器傳遞錯誤複選框狀態的錯誤。
• 修正了地圖控制項的問題，即 Tab/Shift+Tab 的順序錯誤。
• 將地圖按鈕從 div 轉換為原生按鈕，以提高可訪問性。
• WebGL 地圖的傾斜角度現在會根據縮放等級受到限制。
• 修正了當 controlSize 小於 27 時 Internet Explorer 中全螢幕按鈕部分消失的問題。

3.42.8

2020 年 10 月 7 日

變更：

• 在 Directions 服務中新增 Promise 的 Beta 版支援。
• 地理編碼器componentRestrictions現在對空字串執行驗證檢查。
• 修正了 Safari 瀏覽器中自訂標記符號遮擋標記標籤的錯誤。

支援更新後的地點圖標

2020 年 10 月 1 日

Place Details 和 Place Search 要求傳回的圖示已更新為使用新圖示字形。無需任何操作，新字形將自動顯示。

3.42.7

2020 年 9 月 29 日

變更：

• 修正了「報告地圖錯誤」控制項工具提示中 RTL（從右到左）語言的詞序錯誤問題。
• RTL 文字方向的置中標記標籤。

3.42.6

2020 年 9 月 21 日

變更：

• 在 距離矩陣服務 中加入了對 承諾 的 beta 支援。

3.42.5

2020 年 9 月 16 日

變更：

• 更新 LatLngBounds.union 方法，處理兩個界線超過 180 度的情況。

3.42.4

2020 年 9 月 8 日

變更：

• 現在，當偵測到無效的 Date.now() 實作時，會在控制台中記錄錯誤。
• 在 Elevation 服務方法中增加了對 Promise 的 beta 支援。
• 引入了一個新的 InfoWindow.minWidth 屬性，用於指定 InfoWindow 的最小寬度。
• 修正了更改目的地後路線導航變得模糊的錯誤。

3.42

2020 年 8 月 19 日

Maps JavaScript API 3.42 版現已推出。請參閱版本管理指南。

變更：

• 資訊視窗現在的預設寬度上限為 648 像素，您可以設定 InfoWindow 的 maxWidth 屬性來覆寫這項設定。現在 InfoWindow 的寬度可超過 648 像素，但仍會受限於地圖寬度。（以前，資訊視窗的寬度始終限制在 648 像素或地圖寬度的較小值。）
• 在算繪大型 GeoJSON 資料集時，避免預設樣式的算繪閃爍。

• 每週版本已更新至 3.42 版。
• 季度頻道已更新至 3.41 版本。
• 版本 3.40 仍然可以透過電話申請獲得。
• 3.39 版本已刪除，無法再使用。

3.41.7

2020 年 7 月 22 日

已修正：

• 修正錯誤：使用雲端樣式時，將 clickableIcons 屬性設為 false 無效。

3.41.5

2020 年 7 月 6 日

變更：

• 修復了受信任類型衝突問題。

3.41.2

2020 年 5 月 27 日

變更：

• Maps JavaScript API 中 Places Library 的地點欄位 permanently_closed 已淘汰。

3.41

2020 年 5 月 20 日

Maps JavaScript API 3.41 版現已推出。請參閱版本管理指南。

• 每週頻道已更新至 3.41 版本。
• 季度頻道已更新至 3.40 版本。
• 版本 3.39 仍可透過電話申請取得。
• 3.38 版本已刪除，無法再使用。

3.40.11

2020 年 4 月 28 日

變更：

• 在 Place Search 和 Place Details 結果中新增 business_status 欄位。請使用此欄位代替 permanently_closed。
• 修復請求時控制台警告不正確的問題（新增）PlaceResult.utc_offset_minutes現在會回傳警告PlaceResult.utc_offset，這已經是已棄用。

3.40.9

2020 年 4 月 14 日

變更：

• 如果傳遞的 mapDiv 不是 Element，Map 現在會拋出更容易診斷的 InvalidValueError 錯誤。
• Chrome 瀏覽器自動填入位址至 google.maps.places.Autocomplete 時，不應再觸發向伺服器傳送自動完成請求（這將避免計費）。
• 使 maxWidth 屬性更加準確。在此變更之前，如果您將 InfoWindow 的 maxWidth 指定為 100，則 InfoWindow 的實際最大寬度為 94px。 更改後，最大寬度實際上將為 100 像素。
• 修正了使用標記和地圖邊界時繪製請求產生器的記憶體洩漏問題。

3.40.6

2020 年 3 月 24 日

變更：

• 修正了 IE11 中旅行時間欄位的文字截斷問題。

3.40.4

2020 年 3 月 10 日

變更：

• 修正了兩次呼叫 setTilt() 會導致 Map 出現偏差的錯誤。

3.40.2

2020 年 2 月 23 日

變更：

• 地圖中隱藏的 iframe 已從標籤導航中移除。

3.40.1

2020 年 2 月 18 日

變更：

• 不要對 v=beta 發出 InvalidVersion 警告。
• 修正了顯示街景時滾動的問題。

3.40

2020 年 2 月 11 日

Maps JavaScript API 3.40 版本現已發布。 請參閱版本管理指南。

• 每週頻道已更新至 3.40 版本。
• 季度頻道已更新至 3.39 版本。
• 版本 3.38 仍可透過電話申請取得。
• 3.37 版已刪除，無法再使用。

3.39.6

2020 年 1 月 8 日

Maps JavaScript API 3.39.6 版本現已發布。 請參閱版本管理指南。

已修正：

• 對於路線請求，ZERO_RESULTS 現在會記錄到控制台，並且不再導致錯誤日誌。

3.39

2019 年 11 月 20 日

Maps JavaScript API 3.39 版本現已發布。 請參閱版本管理指南。

變更：

• Internet Explorer 10 已停止支援（3.38 是最後一個支援它的版本）。
• AutocompletePrediction 現在會傳回從指定的原點緯度/經度到所選位置的直線距離。

淘汰項目：

• 地點欄位 open_now 和 utc_offset 已於 2019 年 11 月 20 日棄用，並將於 2021 年 2 月 20 日關閉。請參閱 Places 欄位遷移 以瞭解更多資訊。

• 每週頻道已更新至 3.39 版本。
• 季度頻道已更新至 3.38 版本。
• 版本 3.37 仍可透過電話申請取得。
• 3.36 版已刪除，無法再使用。

3.38

2019 年 8 月 20 日

Maps JavaScript API 3.38 版現已推出。請參閱版本管理指南。

• 每週版本已更新至 3.38 版。
• 每季版本已更新至 3.37 版。
• 如果要求使用特定號碼，仍可使用 3.36 版。
• 3.35 版已刪除，無法再使用。
• Fusion Tables 已無法使用 (3.37 版是支援這項功能的最後版本)。
• 我們已淘汰 Internet Explorer 10 的支援服務，並將在 2019 年 11 月至 2020 年 5 月之間停止支援，具體時間取決於您使用的發布管道或版本號碼。

3.37

2019 年 5 月 15 日

Maps JavaScript API 3.37 版現已推出。請參閱版本管理指南。

• 每週版本已更新至 3.37 版。
• 每季版本已更新至 3.36 版。
• 如果要求使用號碼，仍可使用 3.35 版。
• 3.34 版已刪除，無法再使用。
• 系統不再支援 Internet Explorer 9 (3.34 是最後一個支援該瀏覽器的版本)。

3.36

2019 年 2 月 14 日

Maps JavaScript API 3.36 版現已推出。請參閱版本管理指南。

變更：

• 新增功能：
• 您現在可以使用 MapOption.controlSize 變更地圖控制項的大小。
• 您現在可以使用 MapOptions.restriction 限制地圖範圍。
• 資訊視窗已改善。
• 每週版本已更新至 3.36 版。
• 每季版本已更新至 3.35 版。
• 如果要求使用特定號碼，仍可使用 3.34 版。
• 3.33 版已刪除，無法再使用。

3.35

2019 年 1 月 29 日

變更：

• API 現在可以傳回每個地點的評論總數。
• 新增 Plus Code 支援。Plus Codes 是短代碼，可為全球各地提供地址，即使是沒有傳統街道地址的地區也適用。
• 系統已停止支援 Internet Explorer 9。

淘汰項目：

• Autocomplete 的 placeIdOnly 參數已淘汰。
• Maps JavaScript API 中的 Fusion Tables 圖層已於 2018 年 12 月 3 日淘汰。Fusion Tables 圖層將於 2019 年 12 月 3 日全面停用，屆時將無法再使用。瞭解詳情。

2018 年 11 月 13 日

Maps JavaScript API 3.35 版現已推出。請參閱版本管理指南。

變更：

• 每週版本已更新至 3.35 版。
• 每季版本已更新至 3.34 版。
• 如果透過號碼要求，仍可使用 3.33 版。
• 3.32 版已刪除，無法再使用。

3.34

2018 年 8 月 14 日

Maps JavaScript API 3.34 版現已推出。請參閱版本管理指南。

變更：

• 新的版本名稱已啟用。 現在您可以指定發布管道或版本號：
  • 每週頻道已更新至 3.34 版本。
  • 季度頻道已更新至 3.33 版本。
  • 3.32 版本仍然可用。
  • 3.31 版本已刪除，無法再使用。 指定版本 3.0 至 3.31 的客戶將收到其預設頻道，即每週頻道或每季頻道（請參閱 版本控制 指南）。
• 現在啟用了更大的控制介面。 隨著各種裝置上觸控操作的增加，我們調整了控制介面，使其能夠同時適應手指觸控和滑鼠點擊。 （可以透過在 API 中載入 v=quarterly、v=3.33 或 v=3.32 來選擇退出。）

3.33

2018 年 6 月 11 日

變更：

• 地點詳情請求現在支援使用欄位來指定要傳回的地點資料類型。
• 現在可以使用兩個新的「尋找地點」請求：
  • 依查詢找地點
  • 根據電話號碼查找地點
• 現在支援位置自動完成功能按會話計費。

2018 年 5 月 16 日

Maps JavaScript API 的 3.33 版本現已作為實驗版本提供。 請參閱 API 版本控制 指南。

變更：

• 新的 renderer 現在是預設值。
• 新的 base map 現在是預設值。

3.32

2018 年 2 月 13 日

變更：

• 一個新的實驗性渲染器 renderer 現已可用。
• 現在可以使用新的實驗性 base 地圖。

3.31

2018 年 2 月 13 日

變更：

• 預設情況下，將前 256 個標記設為 DOM 標記，然後將後續標記設為圖塊標記。目前預設設定為所有圖塊標記。
• 在高縮放等級（放大）下拖曳 Pegman 時，請優先選擇 NEAREST 全景圖，而不是 Google 選擇的 BEST 全景圖。
• 當在 mousedown 處理程序中更改 gestureHandling: none 時，它現在與 draggable: false 的工作方式相同（現在對 mousedown 生效）。

2017 年 11 月 21 日

Maps JavaScript API 的 3.31 版本現已作為實驗版本提供。 請參閱 API 版本控制 指南。

變更：

• 現在，地點詳情請求會傳回 region 欄位。

3.30

2017 年 8 月 16 日

Maps JavaScript API 的 3.30 版本現已作為實驗版本提供。 請參閱 API 版本控制 指南。

變更：

• 現在桌面端預設啟用全螢幕按鈕。
• 此版本為桌面應用程式引入了 gestureHandling 屬性，該屬性允許使用者使用滑鼠滾輪或觸控板進行互動。為了控制使用者與地圖互動的方式，建議您使用 gestureHandling 屬性，而不是 scrollwheel、disableDoubleClickZoom 和 draggable 屬性。

3.29

2017 年 5 月 16 日

Maps JavaScript API 的 3.29 版本現已作為實驗版本提供。詳情請參閱 API 版本管理指南。

變更：

• 由於基礎架構更新，使用者生成 (自訂) 街景服務全景的 panorama ID 格式已變更。這會稍微增加可用的全景數量。
• 在 Maps JavaScript API 中，使用舊全景 ID 要求使用者產生的全景 (自訂全景) 仍可正常運作。如果您嘗試使用 StreetViewPanoramaOptions 物件的 position 屬性尋找全景，結果會包含新的全景 ID。新舊全景 ID 都不會失效，因此不需要對應。
• 如果您依賴全景 ID 剖析和/或驗證邏輯，請注意全景 ID 的格式可能會變更。
• 如要回報任何問題，請使用問題追蹤工具。
• google.maps.Map 類別的 fitBounds 方法更新。
• 如要在隱藏地圖時變更可視區域，現在可以將地圖設為 visibility: hidden，確保地圖 div 具有實際大小。

3.28

2017 年 4 月 18 日

MapOptions 物件的 draggable 屬性已淘汰。如要在桌上型電腦上停用拖曳地圖功能，請使用 gestureHandling 屬性，並將其設為 none。

2017 年 2 月 15 日

Maps JavaScript API 3.28 版現已推出實驗版本。詳情請參閱 API 版本管理指南。

變更：

• Maps JavaScript API 3.28 以上版本不再支援登入地圖。

3.27

2017 年 2 月 2 日

已修正：

• 問題 11331：無法選取 InfoWindow 內的文字

2017 年 1 月 10 日

現在起，您可以限制 Autocomplete 預測只顯示來自多個國家/地區的結果。方法是在 AutocompleteOptions 的 componentRestrictions 欄位中指定最多 5 個國家/地區。

2016 年 11 月 15 日

Maps JavaScript API 3.27 版現已推出實驗版本。(請參閱 API 版本管理指南)。

變更：

• MapOptions 物件中的新 gestureHandling 選項可協助您，在使用者透過行動裝置與地圖互動時，提供最佳體驗。可用的值包括：
  • greedy：使用者在螢幕上滑動 (拖曳) 時，地圖一律會平移 (向上或向下、向左或向右)。換句話說，單指滑動和雙指滑動都會平移地圖。
  • cooperative：使用者必須以單指滑動來捲動頁面，並以雙指平移地圖。如果使用者以一根手指滑動地圖，地圖上會顯示疊加層，提示使用者以兩根手指移動地圖。在行動裝置上查看上述範例，即可瞭解合作模式的實際運作方式。
  • none：地圖無法平移或縮放。
  • auto (預設)：行為為 cooperative 或 greedy，視網頁是否可捲動而定。

  如需更多詳細資料和範例，請參閱開發人員指南。

• 行動裝置預設會顯示全螢幕控制項，方便使用者放大地圖。地圖處於全螢幕模式時，使用者可以單指或雙指平移地圖。注意：iOS 裝置不支援全螢幕功能，因此不會顯示全螢幕控制項。

已淘汰的登入地圖

2016 年 10 月 6 日

登入功能已淘汰。 Maps JavaScript API 3.27 版和更早版本仍支援已登入的地圖。日後推出的版本將不再支援已登入的地圖，但仍會支援使用資訊視窗或 SaveWidget 將地點儲存至 Google 地圖的功能。進一步瞭解已登入地圖。

路線規劃服務回應中的中途路線控點變更

2016 年 8 月 29 日

Directions 服務回應中的 via_waypoints 欄位包含原始請求中未指定的航點陣列。via_waypoints 欄位將繼續出現在可拖曳方向回應中，但在備選路線回應中已棄用 。版本 3.27 將是最後一個在備用路由中支援 via_waypoints 的 API 版本。

建議的做法是請求替代路線，然後將所有路線顯示為不可拖曳，並將主路線顯示為可拖曳。用戶可以拖曳主路線，直到它與替代路線相符。via_waypoints 欄位在產生的路線中可用（由使用者拖曳）。

3.26

2016 年 8 月 18 日

Maps JavaScript API 的 3.26 版本現已作為實驗版本提供。(請參閱 API 版本管理指南)。

變更：

• 全新的街景渲染器帶來了渲染方面的改進，包括更流暢的過渡和動畫、改進的物件建模、更好的行動裝置支援以及更清晰的控制。詳情請參閱 Google Geo Developers Blog。
• API 現在支援街景中的裝置方向事件，因此行動裝置用戶可以透過行動手機來環顧四周。作為開發者，您可以啟用或停用此功能。詳情請參閱開發者指南。

3.25

2016 年 5 月 25 日

Maps JavaScript API 的 3.25 版本現已作為實驗版本提供。(請參閱 API 版本管理指南)。

Internet Explorer 9 支援終止

2016 年 5 月 2 日

截至 2016 年 4 月 30 日，Internet Explorer 9 已不再受到 Maps JavaScript API 的官方支援。查看 個支援的瀏覽器清單。

3.24

2016 年 4 月 14 日

變更：

• 現在您可以停用地圖圖示的點擊功能。地圖圖示代表興趣點，也稱為 POI。請參閱 google.maps.Map 上的 setClickableIcons 方法。

2016 年 3 月 31 日

已修正：

• 問題 9507: Safari 中的街景連結現在可以再次正常運作了。

2016 年 3 月 28 日

已修正：

• 問題 9394：當使用者開啟底圖圖示的資訊視窗時，資訊視窗會自動關閉，反之亦然。
• 當使用地圖上的 styles 屬性設定底圖樣式時，顯示白色 Google 標誌（以前，只有在使用 StyledMapType 應用程式樣式時，標誌才會變成白色）。

2016 年 3 月 18 日

已修正：

• 第 9424 期: new LatLng({lat: 0, lng: 0})
• 修正了使用新的街景渲染器（使用 google.maps.streetViewViewer = 'photosphere'）時的滑鼠平移問題。

2016 年 2 月 15 日

變更：

• 使用 google.maps.controlStyle = 'azteca' 選擇退出新控制的功能已移除。

3.23

2016 年 1 月 18 日

變更：

• 本次更新包含地圖的全新全螢幕控制功能。使用者可以點擊控制項將地圖最大化，使其佔據整個螢幕。 預設情況下，此控制項處於關閉狀態。您可以在 MapOptions 中啟用它，並使用 FullscreenControlOptions 對其進行配置。它的預設位置是RIGHT_TOP。
• 街景的全螢幕控制功能預設為啟用。您可以透過 StreetViewPanoramaOptions 停用它，並透過 FullscreenControlOptions 配置它。其預設位置現在是RIGHT_TOP。

2016 年 1 月 4 日

已修正：

• 問題 9009：從觸控合成滑鼠事件時，請使用左鍵而非中鍵，以相容於 jQuery。
• 問題 4201：API 不再使用 eval()。 因此，現在可以使用 API，而不需使用unsafe-eval 內容安全政策指令。

2015 年 12 月 21 日

變更：

• 地圖選項：停用已登入地圖的登入按鈕 (會顯示已登入使用者的虛擬人偶，仍允許透過已登入的動作 (例如加上星號) 登入，但設定這個選項後，地圖上不會再顯示登入按鈕)。
• 文字搜尋要求的介面已變更。自 2016 年 3 月 1 日起，types 參數已淘汰，取而代之的是新的 type 參數，每個搜尋要求僅支援一種型別。此外，系統將不再支援 establishment、food 和 grocery_or_supermarket 類型做為搜尋參數 (但這些類型仍可能會在搜尋結果中傳回)。使用舊版 types 參數的請求將支援至 2017 年 3 月 1 日，之後所有文字搜尋都必須使用新版實作方式。

2015 年 12 月 2 日

變更：

• Autocomplete 建構函式會驗證是否已提供輸入元素。
• 在未登入模式下，基礎地圖興趣點資訊視窗顯示的內容與登入模式相同。
• Google Maps API 外部函式現在會為列舉指定型別 (數字或字串)。

2015 年 11 月 25 日

變更：

• 已將 .toJSON() 方法新增至 LatLng 和 LatLngBounds 物件。這些方法應透過 JSON.stringify() 使用。

2015 年 11 月 19 日

變更：

• 樣式化地圖適用的白色 Google 標誌

已修正：

• 問題 8674：錯誤：防範 img { max-width: 100%; }

3.22

2016 年 1 月 7 日

已修正：

• 問題 9009：從觸控合成滑鼠事件時，請使用左鍵而非中鍵，以相容於 jQuery。

2015 年 11 月 10 日

變更：

• 如果交通方式為開車，路線規劃服務和距離矩陣服務現在會傳回預估的交通時間 (在回應欄位 duration_in_traffic 中)。如要接收預測的行程時間，請在要求中加入 drivingOptions 物件常值，並指定目前或未來的 departureTime。您也可以指定 trafficModel，讓系統在計算行程時間時，採用樂觀、悲觀或最佳預測 (預設) 的假設。詳情請參閱「Directions 服務」和「Distance Matrix 服務」的開發人員指南。注意：duration_in_traffic 僅適用於 Google 地圖平台付費方案客戶。

已淘汰：

• durationInTraffic 要求欄位現已淘汰。先前我們建議 Google 地圖平台付費方案客戶使用這個欄位，指定結果是否要加入系統考量目前路況後算出的時間長度。建議您現在改用 drivingOptions 欄位。

2015 年 11 月 5 日

已淘汰：

• AdSense 程式庫已於 2015 年 5 月淘汰，且不再提供實驗版本 Maps JavaScript API。這個程式庫很快就會從 API 的發布和凍結版本中移除。替代方案是 Google AdSense。請參閱建立 AdSense 廣告單元的指南。

2015 年 9 月 22 日

變更：

• 在發出路線規劃和距離矩陣要求時，新增地點 ID 支援功能：DirectionsRequest.origin、DirectionsRequest.destination 和 DirectionsWaypoint.location 現在接受 Place 物件，而 DistanceMatrixRequest.origins 和 DistanceMatrixRequest.destinations 現在接受 Place 物件陣列。

2015 年 9 月 15 日

變更：

• 地圖和街景服務全景上的許多控制項，預設位置和外觀都已變更。無論地圖是否使用登入模式，使用者體驗現在都一致，且與 Google 地圖網站更為一致。如要繼續使用舊版控制項一段時間，可以在 v3.22 中設定 google.maps.controlStyle = 'azteca'。
• 街景服務中的新「全螢幕」控制項可讓使用者以全螢幕模式開啟街景服務全景。

已淘汰：

• 總覽地圖控制項已停用。
• 地圖上的平移控制功能已無法使用。若要平移視圖，使用者可以點擊並拖曳或滑動地圖。（請注意，街景視圖中的平移控制功能仍然可用。）
• 縮放控制項只有一種樣式，因此 google.maps.ZoomControlStyle 不再適用。

2015 年 9 月 1 日

變更：

• 增加了 LatLngBounds 字面量
• 修正了 CSS 類別過於寬泛的問題
• 改進了地圖縮放後圖塊的載入速度

Internet Explorer 8 支援終止

2015 年 8 月 31 日

截至 2015 年 8 月 31 日，Internet Explorer 8 已不再受到 Maps JavaScript API 的官方支援。查看 個支援的瀏覽器清單。如需 Microsoft 的瀏覽器支援政策相關資訊，請參閱 2014 年 8 月 7 日的 IEBlog 貼文。

3.21

2015 年 8 月 5 日

變更：

• 效能提升：僅載入可見圖塊。
• 多項文件改善

2015 年 7 月 21 日

變更：

• 帶標籤的記號筆上市
• 已修正：iOS7 在高解析度螢幕上處理 poly 時出現的記憶體不足錯誤。
• 修復了 IE10+ 中的觸控事件
• 現在，對開發者提供的輸入進行錯誤驗證時，會將結果輸出到控制台，而不是拋出錯誤。

2015 年 7 月 6 日

已修正：

• 問題 8159：錯誤：StrokePosition.OUTSIDE 的渲染不正確

2015 年 6 月 17 日

變更：

• 已修正：問題 6321：錯誤：“未捕獲的類型錯誤：無法讀取未定義物件的屬性 'x'”，僅在 Android/iOS 瀏覽器中出現

2015 年 6 月 2 日

變更：

• 已棄用：CloudLayer、PanoramioLayer
• 已修正：問題 8098：錯誤：加權熱圖在只有一個點時無法正確渲染

2015 年 6 月 2 日

變更：

• 新增功能：將 placeId 地理編碼為地址/緯度和經度
• 透過地理編碼 API 傳回 placeIds

2015 年 5 月 28 日

變更：

• 已修正：問題 6358：SVG 路徑表示法在 HDPI 裝置上無法正確渲染

2015 年 5 月 19 日

已修正：

• 問題 7673：使用地圖類型下拉式選單後控制鬆散位置
• 問題 7589： 地圖大小調整時，衣夾人會跳動。

3.20

2015 年 4 月 24 日

已修正：

• 提高地形最大縮放比例，即使在最大縮放比例下也能載入高 DPI 圖塊。

2015 年 4 月 13 日

已修正：

• 問題 7820：從 file:// 載入的頁面上遊標無法正常運作
• 問題 7591：錯誤：當 radius 參數不是整數時，StreetViewService.getPanoramaByLocation 失敗

2015 年 3 月 25 日

已修正：

• 問題 7733： 錯誤：KML 區域/圖片疊加層突然變得非常低解析度
• 保存小部件文本，使其與星形圖標更好地對齊

2015 年 3 月 17 日

已修正：

• 問題 7756: Bug: Safari 8 效能回歸
• 已移除人口統計層
• 對 InfoWindow Chrome 的改進

2015 年 2 月 17 日

目前 Maps JavaScript API 實驗版本（3.19）將成為正式發布版本。

3.17 版本將被移除。現在對 3.17 或任何先前版本的請求將提供 3.18 版本。

版本控製文件可在以下網址取得：https://developers.google.com/maps/documentation/javascript/versions

續約後可用的版本：

實驗版: 3.20

發布版本：3.19

冰雪奇緣：3.18

3.19

2015 年 4 月 24 日

已修正：

• 已登入模式下的遊標。

2015 年 3 月 19 日

已修正：

• 問題 7756: Bug: Safari 8 效能回歸

2015 年 1 月 20 日

已修正：

• 問題 7475: Bug: phantomjs TypeError: 無法移除屬性

2015 年 1 月 13 日

已修正：

• 現在螢幕閱讀器已對圖塊隱藏

2014 年 12 月 17 日

已修正：

• 問題 6917：錯誤：形狀不遵循地圖的「可拖曳」屬性
• 問題 7445：錯誤：使用 v3 Maps API 的登入功能時出現顯示錯誤

2014 年 12 月 2 日

已修正：

• 問題 7390：錯誤：weather.com 超連結無法正常運作
• 問題 7376：錯誤：WebGL 已關閉（現已重新啟用）
• ES6 命名與符號衝突

2014 年 11 月 25 日

已修正：

• 問題 7333: Bug: IE9 中資訊視窗的插入符顯示異常

3.18

2014 年 12 月 4 日

已修正：

• 問題 7390：錯誤：weather.com 超連結無法正常運作

2014 年 9 月 18 日

已修正：

• 問題 7136：Firefox 中多個標記標題無法正常運作

2014 年 9 月 9 日

已修正：

• 問題 7098：設定街景視角方向時拋出錯誤

2014 年 8 月 26 日

3.18 版已發布至實驗版。

3.17 現已穩定。

3.17

2014 年 8 月 20 日

已修正：

• 問題 6937: 3.17 版本迴歸：無法讀取未定義物件的屬性「remove」（在 Places 中）

2014 年 8 月 12 日

已修正：

• 問題 6968: Bug: 鍵盤方向鍵在 v=3.exp 中無法運作

2014 年 7 月 31 日

已新增：

• 地圖面板 提供了關於 DOM 事件如何在其中傳播的明確文件。 新增了 overlayMouseTarget 窗格。

2014 年 7 月 7 日

已新增：

• 已將 toGeoJson 新增至資料圖層和各個資料圖層要素，允許將幾何圖形匯出為 GeoJSON。

2014 年 6 月 24 日

已新增：

• place_id，一個地點的唯一標識符，已添加到地點庫中，用於自動完成和地點詳細資訊。
• overview_path 加到 DirectionsRoute 上，得到一條編碼折線，表示路線的整個過程。

2014 年 5 月 26 日

已新增：

• Maps API URL 中不再需要 sensor 參數。

2014 年 5 月 20 日

3.17 版本已發布至實驗階段。

3.16

2014 年 4 月 15 日

已修正：

• 標記現在具有與其他幾何類型相符的不透明度 - https://developers.google.com/maps/documentation/javascript/3.exp/reference#MarkerOptions

2014 年 4 月 8 日

已新增：

• 繪製過程中，滑鼠移動時地圖會平移。

已修正：

• 在更多地方接受 LatLngLiteral。
• 當 Roboto 載入完成後，資訊視窗會自動調整大小（問題 5713）

2014 年 3 月 31 日

已修正：

• IE 8 中半透明 KML 圖層不再透明（問題 6540）

2014 年 3 月 26 日

已修正：

• 移除了 Chrome 瀏覽器中的 event.returnValue 調用，以防止控制台警告。
• IE11 中捏合縮放功能無法使用（問題 5747）

2014 年 3 月 18 日

已新增：

• 資料層已上線 - https://developers.google.com/maps/documentation/javascript/datalayer

2014 年 3 月 12 日

已新增：

• 在大多數接受 google.maps.LatLng 的地方都支援 LatLngLiteral - https://developers.google.com/maps/documentation/javascript/3.exp/reference#LatLngLiteral

2014 年 2 月 24 日

已新增：

• 距離矩陣和方向服務支援渡輪。

2014 年 2 月 17 日

3.16 版本已發布至實驗階段。

3.15

2014 年 3 月 3 日

已修正：

• Chrome 的漏洞已修復，現在可以在 Chrome Windows 和 Linux 中重新啟用硬體加速（https://code.google.com/p/chromium/issues/detail?id=336676）

2014 年 2 月 10 日

已修正：

• 停用 Chrome/Linux 上的所有圖塊硬體加速，以解決 Chrome 硬體加速的主要問題。

2014 年 2 月 3 日

已修正：

• 捲動滾輪無法在 IE 11 中運作 (問題 5944)

2014 年 1 月 29 日

已修正：

• 在 Chrome/Windows 上停用所有圖塊硬體加速功能，解決較大的 Chrome 硬體加速問題。( 問題 6219)

2014 年 1 月 22 日

已修正：

• 載入繪圖管理工具時，暫時停用 Chrome/Windows 的硬體加速功能，即可解決 Chrome 問題： https://code.google.com/p/chromium/issues/detail?id=336676 ( Issue 6224)

2014 年 1 月 16 日

已修正：

• 視覺化更新 CSS 的具體程度較低，可覆寫較少使用者設定的樣式。

2013 年 11 月 27 日

已修正：

• 例項化地圖後建立標記會擲回「contains」未定義錯誤 (問題 5798)

2013 年 11 月 19 日

已修正：

• Firefox 無法正常顯示路線面板的轉彎圖示

3.14

2013 年 9 月 10 日

已修正：

• 官方 Google 資訊視窗中的連結不會在新分頁/視窗中開啟 (問題 5794)

2013 年 8 月 15 日

• 在 API 的發布版本中，視覺化更新會成為預設地圖轉譯模式。
• DynamicMapsEngineLayer：向量、圖像和 KML 圖層的功能報表

3.13

2013 年 6 月 25 日

已新增：

• DynamicMapsEngineLayer

2013 年 6 月 11 日

已新增：

• 「disableDefaultUI」選項，可透過 StreetViewPanoramaOptions 停用預設使用者介面。

已修正：

• 錯誤：自訂街景服務全景和 90 度向下 ( 問題 4875)

3.12

2013 年 6 月 4 日

已修正：

• 當 visualRefresh=true 時，資訊視窗 domready 不會觸發 ( 問題 5415)
• 錯誤：iOS 上的 visualRefresh 資訊視窗 ( 問題 5396)

2013 年 5 月 15 日

已新增：

• Google 地圖視覺更新： https://developers.google.com/maps/documentation/javascript/basics#VisualRefresh

2013 年 4 月 29 日

已修正：

• 在 Android 和 Dolphin 瀏覽器中，移除的標記仍會顯示在地圖上

3.11

2013 年 2 月 19 日

已修正：

• 在繪圖時變更 DrawingMode 會導致錯誤
• 按一下路線面板中的步驟，即可變更縮放比例

2013 年 2 月 12 日

已修正：

• 無法拖曳的多邊形可透過觸控輸入，拖曳可拖曳的多邊形 (問題 4868)
• 當 travelMode 切換時，路線替代方案面板中的大眾運輸圖示不正確 (Issue 4581)
• 在某些情況下，panTo(latLng) 不一定會將地圖中心精確置於 latLng

2013 年 1 月 29 日

已新增：

• 新增 StreetViewCoverageLayer，以程式輔助方式新增涵蓋範圍層
• 公開 StreetViewPanoramas 的 StreetViewPov

已修正：

• 使用 Google 地圖 JavaScript V3.8 時，記憶體用量增加會導致當機 (在 IE 9、Chrome 等瀏覽器中觀察到此現象)。( 問題 4162 )
• InfoWindow 中的下拉式 (選取) 選單不會在 Firefox 上跟隨地圖平移

2013 年 1 月 22 日

已新增：

• 可拖曳的折線、多邊形、圓形、矩形
• PlaceResult 中的 price_level 欄位

2013 年 1 月 15 日

已修正：

• 某些折線的重複折線圖示繪製不正確（問題 4333）

2013 年 1 月 7 日

已修正：

• 捲動地圖時，頁面也會捲動 (問題 1605、問題 3652)。

2012 年 12 月 17 日

已新增：

• 新增語言：烏都文和冰島文

已修正：

• IE9 導航後地圖模糊/朦朧（問題 3875）

2012 年 12 月 17 日

已新增：

• 新增語言：烏都文和冰島文

已修正：

• IE9 導航後地圖模糊/朦朧（問題 3875）

2012 年 12 月 10 日

已新增：

• 能夠載入帶有 crossorigin 屬性集的圖像

已修正：

• 近景中顯示帶有遠端影像的標記的問題（第 4616 號問題）
• 在 IE 7/8 上重新顯示折線上的符號時發生 JS 錯誤

2012 年 12 月 3 日

已修正：

• Markermanager 程式庫無法搭配 Maps API JS v3 使用 (問題 4543)

2012 年 11 月 27 日

已新增：

• 在高 DPI 裝置上使用高 DPI 畫布，以最佳化標記

已修正：

• MapTypeControl 未清除樣式 ( 問題 4588)

3.10

2013 年 2 月 4 日

已修正：

• 使用 Google 地圖 JavaScript V3.8 時，記憶體用量增加，導致當機 (在 IE 9、Chrome 等瀏覽器中觀察到此現象)。( 問題 4162 )

2012 年 9 月 25 日

已新增：

• 室內街景服務
• 圖示序列的 fixedRotation 選項
• 「目前車流量下的時間」到「路線」

2012 年 9 月 11 日

新功能：

• 為多邊形、矩形和圓形添加了描邊位置屬性
• computeOffsetOrigin 至幾何圖形程式庫
• API 新增四種語言：南非荷蘭文、阿姆哈拉文、史瓦希里文、祖魯文

2012 年 8 月 28 日

已新增：

• types 至 Places API textSearch

已修正：

• 符號物件無法在 GWT 下傳遞至 MarkerOptions
• 迴歸：在 iOS 5 上捲動網頁時，無法使用雙指縮放手勢 ( 問題 4046)

2012 年 8 月 14 日

顯著異動：

• 修改 KmlLayer 介面，接受網址做為 MVC 屬性，而非建構函式引數。

3.9

2012 年 9 月 10 日

已修正：

• 在 GWT 下，符號物件無法傳遞至 MarkerOptions
• 迴歸：在網頁捲動時，於 iOS 5 上使用雙指撥動縮放 ( 問題 4046)

2012 年 8 月 9 日

已修正：

• Android 3.x 的語法錯誤

2012 年 7 月 31 日

顯著異動：

• 在自訂投影上隱藏街景服務疊加層

已修正：

• 當比例大於 35 時，標記符號不會在 Safari 上觸發事件。
• 自訂地圖 (地圖類型 + 投影) 上的標記未引發點擊事件

2012 年 7 月 25 日

已修正：

• Autocomplete 的 componentRestrictions ( 問題 4302)

2012 年 7 月 17 日

已修正：

• 在 IE 的資訊視窗中，文字方塊無法點選
• bounds_changed 應在 zoom_changed 之前觸發 ( 問題 1399)
• 在叫用 Streetview 後，系統不會保留地圖選項 backgroundColor
• 從樣式化地圖切換至衛星地圖時，會不必要地載入地圖圖塊
• 繪圖模式下會忽略地圖的可拖曳/滾輪屬性 (問題 4012)
• 顯示多個世界副本時，LatLngBounds 應傳回完整經度範圍
• 不要在雙擊時繪製空白形狀 ( Issue 3964)
• 點擊時出現多餘的標記事件 ( 問題 3911)

顯著異動：

• 將搜尋和查詢端點重新命名為 nearbySearch 和 textSearch

2012 年 7 月 10 日

顯著異動：

• 讓 google.maps.event.removeListener() 接受空值做為引數

2012 年 6 月 27 日

已新增：

• TRANSIT DirectionsMode： http://mapsplatform.googleblog.com/2012/06/public-transit-routing-and-layer-now.html

• 分頁、評論、textSearch 至 Places API： http://mapsplatform.googleblog.com/2012/07/add-flexible-search-and-google-reviews.html

顯著異動：

• 將「透明」視為顏色。

2012 年 6 月 23 日

已新增：

• 符號
• HeatmapLayer

http://mapsplatform.googleblog.com/2012/06/powerful-data-visualization-with.html

• 新增「weight」和「color」樣式選項：

http://mapsplatform.googleblog.com/2012/06/google-maps-api-now-with-even-more.html

2012 年 5 月 15 日

已新增：

• Autocomplete 的國家/地區限制 (AutocompleteOptions.componentRestrictions) (問題 3899)
• 區域和城市類型篩選器

3.8

2012 年 5 月 1 日

已修正：

• 有時已刪除的標記會重新顯示 (問題 4087)。
• 標記陰影有時不會算繪 ( 問題 3993)

2012 年 4 月 23 日

已修正：

• 關閉街景服務後，衣夾人會留在地圖上，且地圖類型為自訂 ( 問題 4076)
• 移除的動畫標記無法重新加入地圖 ( 問題 4052)

2012 年 4 月 18 日

已修正：

• Firefox 上的天氣資訊視窗一律顯示下雨圖示 (問題 4063)

已新增：

• FusionTablesLayer 的 orderBy、limit 和 offset ( 問題 3557)

2012 年 4 月 10 日

已修正：

• 即使整個可視區域沒有空拍圖像，仍會顯示空拍圖像 (問題 3913)

2012 年 4 月 3 日

已新增：

• WeatherLayer 和 CloudLayer ( 問題 3555)
• DemographicsLayer

已修正：

• IE 9 怪癖：多邊形的圖塊邊界可見
• 在 Canvas 街景服務中平移時，標記會跳動

2012 年 3 月 28 日

已修正：

• 使用小寫標記名稱，以符合 XHTML 格式 ( Issue 3868)
• 變更 Apple 觸控板的縮放行為，降低感應靈敏度 (問題 2416)。

2012 年 3 月 20 日

已修正：

• 使用不存在的陰影圖片建立標記會導致錯誤 (問題 4014)。

已新增：

• 按一下即可前往/放大 街景服務 ( Issue 2447)

顯著異動：

• 街景服務預設停用按兩下縮放功能

2012 年 3 月 6 日

已修正：

• 快速放大時 OverviewMapControl 發生錯誤 ( 問題 3882)
• 從網頁移除地圖 div 時，IE 發生錯誤 ( 問題 3971)
• IE 9 以下版本無法正確顯示縮放的標記 ( 問題 3912、 問題 3908)

已新增：

• 不透明度至 GroundOverlay ( 問題 2767)
• utc_offset 和 opening_hours 至 PlaceResult ( 問題 2431)
• clickToGo 選項至 StreetViewPanoramaOptions ( 問題 2447)

2012 年 2 月 21 日

已修正：

• IE 9 上的地圖模糊不清 ( 問題 3875)
• LatLng 空間中由共線邊緣組成的折線簡化不正確 (問題 3739)

已新增：

• google.maps.geometry.poly.containsLocation() 和 isLocationOnEdge() ( 問題 1978)

2012 年 2 月 15 日

已修正：

• 迴歸：使用無效的「size」參數時，縮放標記的顯示方式有誤 (問題 3908)
• 使用者拖曳控制點時呼叫 setEditable(false)，地圖會停留在編輯模式 (問題 3842)

顯著異動：

• 在街景服務全景之間淡入淡出。

3.7

2012 年 2 月 7 日

已修正：

• 標記在放置動畫前，會在最終位置閃爍 ( 問題 3608)
• 同時開啟 InfoWindow 並設定縮放層級，會導致地圖中心位置不正確 (Issue 3738)。
• 拖曳標記時忽略按下滑鼠右鍵的動作 ( Issue 3237)
• 標記標題有時不會顯示在 Firefox 上 (問題 3773)

顯著異動：

• 現在可在 Canvas 中顯示縮放標記 (如適用)

新增：

• ImageMapType 的 setOpacity() ( 問題 3125)
• 區域疊加層的 setOpacity() ( 問題 2767)
• ImageMapType 的「tilesLoaded」事件 ( 問題 1744)
• MouseEvent 的 stop()，可停止事件傳播 ( Issue 2172)

2012 年 1 月 31 日

已修正：

• 已修正：在世界各地平移後出現錯誤的韓國地圖方塊 (問題 2722)
• 已修正：無法準確放置小人以顯示街景（問題 3861）
• 新增多邊形「可見」屬性 ( Issue 2861)
• 即使視埠相距遙遠，panTo 和 panBy 動畫仍會正常運作 (迴歸)

2012 年 1 月 24 日

已修正：

• 滑鼠事件會透過 InfoWindow 冒泡 ( Issue 3573)
• 在 IE9 上啟用 CSS 變形效果
• 在 StreetViewPanorama 中新增 imageDateControl
• 在 IE 9、Opera 和 Safari/Windows 上啟用 Canvas 街景服務

2012 年 1 月 16 日

已修正：

• 在繪圖模式下，應無法拖曳小飛人
• 正確觸發事件，並遵守多邊形和其他圖層的 zIndex
• 新增 KmlLayer「status」屬性 ( Issue 3015)

2012 年 1 月 10 日

已修正：

• 如果 disableDefaultUI 為 true 且 streetViewControl 為 true，則顯示衣夾人

2011 年 12 月 7 日

已修正：

• 高速公路/收費快速道路可與高速公路分開設定樣式 (road.highway.controlled_access)
• 使用者在自動完成功能中按下「Enter」鍵時，會觸發 place_changed ( 問題 3407)

1011 年 11 月 28 日

已修正：

• 視窗大小調整時，重新調整自動完成功能的位置。「resize」 事件 可在 Autocomplete 物件上觸發。

2011 年 11 月 22 日

已修正：

• 現在計算資訊視窗內容大小時，會將層疊樣式表納入考量
• 空照地圖旋轉控制項與地圖建立時的航向不符

2011 年 11 月 7 日

顯著異動：

• 預設控制選項的新視覺樣式
• 可編輯的形狀 (多邊形、折線、圓形、矩形)
• New DrawingManager for adding new overlays
• 新的 PlaceResult 欄位：網站和國際電話號碼
• 新增 ElevationResult 欄位：解析度

已修正：

• 路線結果中的起點和終點圖示現在會以透明背景在 IE 7 以上版本中顯示

3.6

2011 年 10 月 31 日

已修正：

• 在 IE7 上使用 Prototype Library 時，Maps API 發生錯誤

2011 年 10 月 25 日

已修正：

• 在圖層載入完成前變更 KmlLayer 地圖時發生錯誤
• 在 IE 中新增及移除多邊形時發生記憶體流失

2011 年 10 月 18 日

顯著異動：

• 在 PlaceSearchRequest 中新增關鍵字欄位
• 已從街景服務中移除道路線

2011 年 10 月 10 日

已修正：

• 街景服務預覽中的地址過長

2011 年 9 月 27 日

已修正：

• 如果縮放等級已變更，總覽圖控制項會一併更新中心和縮放等級

2011 年 9 月 27 日

已修正：

• Chrome 中初始圖塊的雙重擷取
• 平移時發生記憶體流失問題
• 平移至涵蓋範圍外的區域時，請勿放置街景服務衣夾人
• 迴歸：跨越 -180 經度的 GroundOverlay 消失
• 回歸：在平移和縮放時開啟資訊視窗，地圖中心位置不正確

顯著異動：

• 拖曳衣夾人時顯示街景服務預覽畫面

2011 年 9 月 20 日

已修正：

• 使用 Canvas 算繪標記時，Chrome/Windows 發生記憶體洩漏
• 航拍檢視畫面標記的算繪結果，方向為 90 度或 270 度

顯著異動：

• 無法透過地圖類型登錄存取預設的 Google 地圖類型 (防止存取地圖圖塊)
• 離開及進入空照圖時的旋轉動畫

2011 年 9 月 12 日

已解決的問題：

• 在 Firefox 4 以上版本中，工具提示顯示後，標記會卡在凸起位置 ( 問題 3334)

顯著異動：

• GeocoderResult.formatted_address 未記錄。

2011 年 9 月 6 日

已修正：

• 在 Firefox 中，選擇元素（下拉式選單）資訊視窗不會跟隨地圖平移。
• 韓國某些行動裝置上的磁貼

2011 年 8 月 29 日

顯著異動：

• 允許自訂控制項的 z-index 值高於 API 控制項。
• 連結會將使用者引導至 maps.google.com 的對應語言版本。
• 如果沒有資訊視窗的 HTML 程式碼、名稱或描述，請不要在 KML 功能上開啟資訊視窗。
• 已修復迴歸問題：高 DPI 圖塊損壞

2011 年 8 月 24 日

已解決的問題：

• 已停用 Chrome/Mac 的硬體加速：修正標記渲染問題和疊加層點擊問題（問題 3544，問題 3551）
• 修正了 Android 系統頁面捲動時捏合縮放的問題（問題 3373）

顯著異動：

• 商務圖示現在預設開啟。

2011 年 8 月 17 日

顯著異動：

• 可點擊的地圖圖標，用於顯示興趣點。
• 可以在 MapOptions 中設定樣式，並將其套用至所有預設地圖類型。
• 除非明確停用，否則 Pegman 會顯示在自訂地圖類型中。

3.5

2011 年 8 月 10 日

已修正：

• 在街景視圖中，當標記拖曳到地平線時，標記會卡在向上拖曳的位置。
• 當地圖或視窗調整大小時，街景服務不會隨之調整大小。
• 街景視圖與共享的資訊視窗導致瀏覽器崩潰

2011 年 8 月 2 日

已解決的問題：

• IE 瀏覽器資訊視窗中的超連結無法正常運作（問題 3503）
• 縮放控制項不列印（問題 2966）
• 迴歸：使用有樣式地圖的 OverviewMapControl 時發生錯誤（問題 3489）

顯著異動：

• 現在大多數控制項的右鍵選單已停用。
• 資訊視窗內的街景全景圖/地圖在滑鼠懸停於資訊視窗上時不會平移。
• 現在可以在 iPad 上捲動資訊視窗了。

2011 年 7 月 18 日

已解決的問題：

• iOS 4.1 及更高版本中頁面滾動時，事件 LatLng 不正確（問題 3373）

2011 年 7 月 11 日

已解決的問題：

• 已修正：觸控裝置上的資訊視窗中的 <select> 無法點選（問題 3232）
• 已修正：如果 MapOptions.draggable 為 false，則在地圖上按滑鼠右鍵後不會觸發點擊事件（問題 3071）

顯著異動：

• 具有相同 z-index 的標記現在在圖塊邊界上保持一致的順序。
• 現在可以在 iOS 的資訊視窗中滾動了。
• 地圖投影方式改變時，系統現在會重新繪製標記和多邊形

2011 年 7 月 5 日

已解決的問題：

• 已修正：地圖不可拖曳時標記遊標不顯示（問題 3120）

顯著異動：

• 新增了自訂「地點自動完成」控制項和下拉式選單樣式的功能
• 使用者選取建議後，Place Autocomplete 小工具會保留伺服器傳回的說明

2011 年 6 月 30 日

已解決的問題：

• 已修正：初始地圖圖塊會被重複獲取
• 已修正：在 3.4 版本之後建立地圖時，maptypeid_changed 事件會被多次觸發（問題 3051）

顯著異動：

• 地點自動完成功能已變更為附加到主體，而不是附加到輸入框父元素。
• BOTTOM_RIGHT 現在可正確定位

2011 年 6 月 8 日

已解決的問題：

• 已修正：縮放等級變化大於 2 時，縮放動畫不再顯示（問題 3033）

顯著異動：

• 已修正： OverlayView.set('map', foo) 現在與 OverlayView.setMap 相同
• 已移除 GeocoderRequest 的「language」選項

2011 年 5 月 17 日

已解決的問題：

• 已修正：IE7 中的街景檢視轉譯問題 ( 問題 3272)

顯著異動：

• 載入和變更地圖類型時，啟用地圖圖塊的淡出轉場效果。

2011 年 5 月 7 日

沒有明顯變化。

3.4

2011 年 5 月 7 日

沒有明顯變化。

2011 年 5 月 6 日

已解決的問題：

• 已修正：街景服務全景不會顯示在 IE7 中 (問題 3272)
• 已修正：在 IE7 和 IE8 中，具有 ImageMapType 的半透明 PNG 會失去透明度 (問題 3275)

顯著異動：

• 距離矩陣服務

2011 年 4 月 14 日

已解決的問題：

• 已修正：支援多邊形 strokeColor 和 fillColor 的具名 CSS 顏色
• 已修正：如果 strokeOpacity 設為 0.0，多邊形不會顯示的問題 (問題 3241)。
• 已修正：在 IE8 中，當 AdUnit 可見時平移會發生錯誤 (問題 3159)。
• 允許地圖類型控制項中的地形和混合型地圖，但不允許地圖和衛星地圖 ( Issue 3089)
• 高 DPI 螢幕會載入高 DPI 圖塊 (問題 2614)

顯著異動：

• 啟用空照圖時，空照圖預設會傾斜 45 度，
• 改善 iPad 上的雙指撥動行為
• 將 DirectionsTravelMode 和 DirectionsUnitSystem 重新命名為 TravelMode 和 UnitSystem (舊名稱仍可回溯相容)

2011 年 4 月 14 日

已解決的問題：

• 已修正：IE6 不再將標記圖示和陰影設為透明
• 已修正：縮放時標記不再閃爍
• 已修正：在北極/南極附近的圖塊邊界，算繪多邊形時發生問題

顯著異動：

• 現在盡可能在 Canvas 中算繪折線和多邊形。
• 現在，折線和多邊形邊界上的事件 LatLng 會對齊線上的最近點。

2011 年 4 月 5 日

已解決的問題：

• 在觸控裝置上，panTo 不會產生動畫效果 (問題 3066)。
• Marker.MAX_ZINDEX 未定義 ( Issue 3184)

2011 年 3 月 28 日

已解決的問題：

• 在衛星模式下，無法變更街景服務的方位 ( 問題 3174)
• 停用 VML 時地圖會中斷 (問題 3119)

顯著異動：

• 街景道路疊加層現在會以傾斜模式顯示

2011 年 3 月 22 日

已解決的問題：

• 衣夾人會顯示在自訂地圖類型中 (問題 3154)。

顯著異動：

• 已修正：巨型標記會在圖塊邊界遭到裁剪
• 已修正：傾斜模式中的街景服務疊加層
• 已修正：總覽地圖控制項會在列印模式中顯示

2011 年 3 月 17 日

已解決的問題：

• 45 度圖像 ( 問題 2412)
• 總覽圖控制項 ( Issue 1470)
• 支援 GIF 動畫 - 新增「已最佳化」選項 (問題 3095)
• Marker.getVisible() 會傳回未定義 ( 問題 3114)

顯著異動：

• 已修正：圓形和矩形會忽略 zIndex
• 已修正：當標記正在動畫化時，滑鼠事件會觸發兩次事件
• 已修正：如果在地圖類型 ID 設定後，將地圖類型新增至登錄檔，樣式化地圖不會使用樣式
• 已修正：非樣式化地圖類型採用樣式化地圖類型的樣式
• 標記現在會觸發 MouseEvent，而非 DOM 事件

2011 年 3 月 11 日

已解決的問題：

• 現在按兩下標記不會再縮放地圖 (問題 3090)。
• 錨點現在可搭配自訂標記陰影使用 (問題 3112)

顯著異動：

• Panoramio 圖層
• 修正路線標記 z-index
• 修正預設陰影位置

2011 年 3 月 2 日

顯著異動：

• 現在會盡可能在 Canvas/VML 中算繪標記
• 在支援觸控的裝置上，加大折線、多邊形和 KML 的點擊目標

2011 年 2 月 22 日

已解決的問題：

• 透過「anchorPoint」MVC 屬性公開的 InfoWindow 錨點 (問題 2860)
• 修正縮放比例為 0 和 1 時的混合模式 ( 問題 3062)
• 修正快速新增/移除地圖中的圓形/矩形時發生的問題 ( 問題 3052)
• draggable: false fixed on touch devices ( Issue 3044)

2011 年 2 月 18 日

已解決的問題：

• 街景服務中的標記只會縮小，不會放大 (問題 2969)
• 現在 routeIndex 不是 0 時，可拖曳的路線也能正常運作 ( Issue 2995)
• 修正 Flash 與地圖拖曳之間的衝突 ( 問題 2956)
• 在 maptypeid_changed 監聽器中變更 mapTypeId 時，地圖類型控制項現在會保持一致

顯著異動：

• 現在從地圖類型控制項點選「衛星」模式時，標籤預設為開啟狀態。

2011 年 2 月 8 日

顯著異動：

• 全新階層式地圖類型控制項，方便觸控操作！
• 新標誌 (問題 2574)
• MarkerShape.coord 已重新命名為 MarkerShape.coords，以符合 HTML <area> coords 屬性

3.3

2011 年 3 月 17 日

已解決的問題：

• 多邊形未顯示

2011 年 2 月 8 日

已解決的問題：

• Chrome 中未取消圖塊要求 (問題 3011)
• FF/Mac 中未觸發 rightclick 事件 ( Issue 2920)
• Safari/Mac 中的文字轉譯問題 ( 問題 3024)
• IE 無法正確列印路線地圖

2011 年 1 月 21 日

顯著異動：

• 球體幾何程式庫現在接受 MVCArray
• 修正 IE6 中拖曳標記時，標記下方顯示十字的問題
• 地圖容器 div 不再設定 z-index

2011 年 1 月 17 日

已解決的問題：

• 修正 zoom_changed 的時間不正確，導致 fromLatLngToContainerPixel 的結果不正確的問題 (問題 2539)

2011 年 1 月 6 日

已解決的問題：

• 新增幾何圖形程式庫，提供球面幾何圖形和折線編碼公用程式 (問題 2540、問題 2595、問題 2246)
• 可在地圖上設定最小/最大縮放等級 ( Issue 1624)

顯著異動：

• 縮放和平移控制項已分開 (不再是導覽控制項)。這些設定可以分別設定。
• 觸控裝置上新增的觸控友善縮放控制項
• 現在可以呼叫 clear()，清除 MVCArray 的內容。
• 修正 IE8 中新增及移除標記時的記憶體流失問題
• 使用改良的簡化演算法，更快算繪多邊形

2010 年 12 月 23 日

已解決的問題：

• 路線控點點擊處理常式 已修正可拖曳路線中的問題 ( 問題 2871)

2010 年 12 月 21 日

已解決的問題：

• 在地圖上拖曳時新增動量 (問題 2592)
• 修正街景服務中的 CSS 錯誤 (問題 2666)
• 修正在 IE 中顯示資訊視窗時，地圖寬度為 0 的 JS 錯誤 ( 問題 2536)

顯著異動：

• 在觸控裝置上，無論要求的是 ZOOM_PAN 或 SMALL 導覽控制項，我們現在都會顯示適合觸控操作的縮放控制項。如果裝置支援瀏覽器中的多點觸控，系統就不會顯示縮放控制項，因為縮放是透過雙指撥動完成。

2010 年 12 月 9 日

已解決的問題：

• 資訊視窗現在可在 IE 中順利列印 ( 問題 1343)
• 修正 IE8 中 ImageMapType 的不透明度

顯著異動：

• 拖曳時，自訂圖示的「標記」下方會顯示十字，且 raiseOnDrag 已啟用

2010 年 12 月 5 日

已解決的問題：

• 提供介面，方便您瞭解特定地點的衛星圖像支援哪個最大縮放等級。( 問題 2049)
• 新增選項 (raiseOnDrag)，在拖曳標記時啟用/停用動畫。( 問題 2910)

顯著異動：

• 現在拖曳標記時，標記會抬起，放開時則會彈跳。
• 您可以使用 setAnimation 函式，以程式輔助方式控制標記動畫。

2010 年 11 月 28 日

已解決的問題：

• maptypeid_changed 不再觸發兩次 ( 問題 2449)
• 現在可以存取 MarkerImage 物件的「size」屬性 (問題 2465)。
• 標記形狀會參照圖示，而非精靈 ( Issue 2629)
• 改善在拖曳標記時平移地圖的功能，適用於較小的地圖 (Issue 2868)。

重大異動：

• 現在列印地圖時，不必啟用背景圖片列印功能，
• 修正錯誤：即使「draggable」設為 false，可拖曳方向標記仍可拖曳

2010 年 11 月 16 日

已變更的問題：

• 問題 2076： 提供方法，將 InfoWindow 傳遞至 DirectionsRenderer ( 問題 2076)
• 問題 2524： 實作 streetViewControlOptions
• 問題 2557：新增 disable zoom to Street view

顯著異動：

• 修正錯誤：在 FF 中，如果以 Shift 鍵點選標記，會開啟新視窗。
• 指定 markerOptions 時，DirectionsRenderer 會遺失字母標記圖示

3.2

2010 年 11 月 11 日

顯著異動：

• 修正錯誤：在 IE7/IE8 上使用 RTL 時，多邊形會遭到剪裁/截斷
• 修正 Safari 5 上的核取方塊因 3D 轉換而隱藏的錯誤。
• 跨越赤道的測地線折線缺少詳細資料
• 新增 LEFT_CENTER、LEFT_BOTTOM、RIGHT_CENTER、RIGHT_BOTTOM 的控制項位置。
• 控制項位置已重新命名，LEFT 改為 LEFT_TOP、RIGHT 改為 RIGHT_TOP、TOP 改為 TOP_CENTER，BOTTOM 改為 BOTTOM_CENTER

2010 年 10 月 11 日

已變更的問題：

• 問題 2478： Streetview - Compass Misalignment/Missing in some browsers
• 問題 2528： ImageMapTypeOptions opacity broken in IE8
• 問題 2661： 資訊視窗 - 在輸入欄位上按一下滑鼠右鍵時，不會顯示內容選單
• 問題 2741：在 iOS 4 上平移地圖後，標記位置無法正常運作

顯著異動：

• 街景服務預設為啟用
• 修正「this」未傳遞至 .getTileUrl 的錯誤
• InfoWindow domready 事件現在會在視窗顯示後觸發

2010 年 9 月 28 日

已變更的問題：

• 問題 2712： 記憶體洩漏 (新增/移除標記、顯示/隱藏標記、縮放/平移地圖)

顯著異動：

• V2 和 V3 地圖在同一網頁上時，效果會更好
• 修正快速向下拖曳時，HTML5 街景服務發生的錯誤

2010 年 9 月 16 日

已變更的問題：

• 問題 2701： 初始街景服務導覽器控制項的方位不會跟隨視角

2010 年 9 月 14 日

已變更的問題：

• 第 157 期： 支援可拖曳的行車路線
• 問題 1852： google.maps.Marker 上的「rightclick」事件會觸發，但沒有引數
• 問題 2673：變更位置後，小飛人會消失

顯著異動：

• 標記效能已提升

2010 年 8 月 31 日

已變更的問題：

• 問題 2658：高資訊視窗

顯著異動：

• 改善高縮放程度的測地線

2010 年 8 月 24 日

已變更的問題：

• 問題 2648： 在 V3.2.1 中，觸發地圖大小調整事件會導致 Firefox 發生錯誤

顯著異動：

• 現在，如果重複放大或縮小 (例如使用捲軸時)，系統會從中間縮放層級載入較少的圖塊。

2010 年 8 月 16 日

已變更的問題：

• 問題 2416： Apple Magic Mouse 的平移和縮放功能過於敏感
• 問題 2606： 在地圖上將 draggable 設為 false 會停用連結
• 問題 2640： 瀏覽器重新整理 / 卸載時未清除記憶體 (IE)

顯著異動：

• 系統會根據距離調整街景服務標記的大小
• 平移時更新縮放滑桿

2010 年 8 月 9 日

顯著異動：

• 已移除已淘汰的 KMLMouseEvent.position 和 FusionTablesMouseEvent.position 屬性。請改用 .latLng
• 已移除已淘汰的 StreetViewService.getNearestPanorama 屬性。請改用 .getPanoramaByLocation

3.1 次

2010 年 9 月 28 日

顯著異動：

• 修正問題：如果路線的起點和目的地相同，會擲回 JS 錯誤。

2010 年 8 月 9 日

顯著異動：

• 已修正變更 OverlayView 的地圖問題
• 已修正呼叫 GroundOverlay.setMap(null) 的問題
• IE 不再出現縮放/平移時的記憶體洩漏問題

2010 年 8 月 5 日

已變更的問題：

• 問題 2588：在 IE 瀏覽器中，對附加了監聽器的 Panorama 物件呼叫 setVisible(false) 會導致 JS 錯誤。

顯著異動：

• 修正 IE6 中標記在縮放變更時消失的問題

2010 年 7 月 29 日

已變更的問題：

• 問題 2337：遺失折線
• 問題 2497：圓形圖示的點擊選項不起作用。

顯著異動：

• 自訂全景圖「originHeading」已被棄用，請改用「centerHeading」。
• 韓國混合式圖塊現在會顯示道路
• 現在點擊操作可以穿過地圖上不可點擊的多邊形。

2010 年 7 月 22 日

已變更的問題：

• 問題 1856：支援 Opera 中的多邊形渲染
• 問題 2159： 使用捲軸縮放後，會觸發 dragend 事件
• 問題 2385：在 Internet Explorer 中，放大到一定程度時，GroundOverlay 會變成黑色。
• 問題 2337： 遺失折線
• 問題 2427：在自動平移模式下，開啟資訊視窗並拖曳會導致標記「懸掛」
• 問題 2493：IE7 中標記無法正確清除
• 問題 2500：使用 !Marker.setIcon(<scaled MarkerImage>) 設定現有標記時，標記影像被裁剪
• 問題 2549：Google 下拉式選單的 CSS 會產生警告

顯著異動：

• 拖曳多邊形時，系統不會再觸發點擊事件
• 點選展開至 InfoWindow 外部的表單選取元素時，不再觸發地圖點選事件
• 點擊 KML 疊加層不再觸發地圖點擊事件
• 現在街景視圖會自動平移以適應螢幕上資訊的視窗。
• KML 和 FusionTables MouseEvent LatLng 從 'position' 改為 'latLng'
• Android 縮放控制項不再將點擊操作傳遞給地圖。

2010 年 6 月 17 日

已變更的問題：

• 問題 2346：停用平滑動畫的選項

顯著異動：

• 修正標記閃爍錯誤
• InfoWindow 的 DOMReady 事件觸發機制已改進。
• DirectionsRoute.bounds 現已公開

2010 年 6 月 11 日

已變更的問題：

• 問題 2389：IE7 中街景功能無法正常運作
• 問題 2460：定位點位置錯誤

重大異動：

• 修復了標記記憶體洩漏
• 首次地理編碼延遲已改善
• 提供對 StreetViewService 的存取權限

3.0

2010 年 5 月 18 日

已變更的問題：

• 問題 2037: GPolylineOptions 測地線

重大異動：

• 修正了自訂地圖類型中 Google 版權資訊不正確的錯誤
• 為多邊形和折線添加了測地線屬性
• 在多邊形和折線中新增可點擊選項
• 地面覆蓋層新增了可點擊選項

2010 年 5 月 13 日

已變更的問題：

• 問題 1724：透過元素而非字串設定內容時，資訊視窗大小/邊距不正確

顯著異動：

• 修正了跨越國際日期變更線時地面疊加層過早裁剪的錯誤。
• 標記 setIcon 現在支援 URL 中包含反斜線 (\)。
• 在 IE 中觸發多邊形和折線的 mouseout 事件
• 更改標記圖示不再閃爍

2010 年 5 月 7 日

已變更的問題：

• 問題 1458： 功能要求：Google API v3 支援 KML
• 問題 1658：新增 流量重疊
• 問題 2209: 堆疊溢位
• 問題 2254：對 Circle 物件多次呼叫「setMap(gMap)」和「setMap(null)」會改變其描邊和填滿不透明度

顯著異動：

• 新增了 KML 和 GeoRSS 圖層
• 新增 地面疊加層
• 新增圖層： 車流量和 單車
• 已針對 DirectionsRendererOptions 新增「suppressBicyclingLayer」屬性。
• 修正錯誤，確保 MapType 變更時，系統會正確參照縮放圖層
• 將 DirectionsResult 屬性「start/end_point」重新命名為「start/end_location」。
• 將 DirectionsLeg 屬性「start/end_geocode」重新命名為「start/end_address」。
• 已將 DirectionsRoute「optimized_waypoint_order」屬性重新命名為「waypoint_order」
• 移除對舊方向屬性名稱（setTripIndex、getTripIndex、hideTripList、provideTripAlternatives）的支持，並繼續記錄警告。此外，也會移除將路線轉換為路段、將行程轉換為路線的步驟。
• 已將 GeocoderGeometry.latLng 更新為 GeocoderGeometry.location

2010 年 4 月 30 日

已變更的問題：

• 問題 2230：地圖初始化時未套用預期的自訂投影

顯著異動：

• 現在點按地圖會將鍵盤焦點移至地圖
• 現在支援 iPad 的捏合縮放功能

2010 年 4 月 26 日

已變更的問題：

• 問題 1826：在多邊形和折線上新增 mouseover 和 mouseout 事件
• 問題 2177：在「maptypeid_changed」事件期間，map.setZoom(z) 無法正常運作。
• 問題 2247： DirectionsRenderer 的 hideRouteList 選項無法正常運作

顯著異動：

• 修正自訂圖示在平移地圖時，會從地圖底部消失的錯誤。

2010 年 4 月 13 日

已變更的問題：

• 問題 2275： MarkerImage 無法重複使用
• 問題 2181： 加入 google.maps.Marker 後，使用滑鼠滾輪放大或縮小時，標記會隱藏

2010 年 4 月 11 日

沒有明顯變化或變更的問題。

2010 年 4 月 5 日

已變更的問題：

• 問題 1976： 自訂圖示和可拖曳標記問題
• 問題 2107： 拖曳標記時，如果拖曳到地圖外，標記就會消失
• 問題 2181：基本地圖的投影屬性不存在

顯著異動：

• 在 DirectionsRoute 中公開路線總覽折線，做為 overview_path。
• 將地圖的目前投影方式公開為唯讀屬性。

2010 年 3 月 23 日

顯著異動：

• API 現在會顯示海拔高度
• 改善網路連線緩慢時的圖塊載入速度。

2010 年 3 月 15 日

顯著異動：

• 現在變更樣式時，多邊形會正確重新繪製。
• 使用舊版「Directions」時，系統會透過 console.log 提供已淘汰的警告訊息。

2010 年 3 月 10 日

已變更的問題：

• 問題 1801：折線/多邊形 zIndex
• 問題 2144： DirectionsRequest 應提供 avoidHighways 選項
• 問題 2207： 錯誤：IE 中會填入折線
• 問題 2113： 1 月發布後，FF 在高縮放層級中斷折線

顯著異動：

• 新增 自行車路線！
• 新增了 DirectionsRequest 選項：
• avoidHighways
• avoidTolls
• optimizeWaypoints
• 提升多邊形/折線的算繪速度
• 下列 Directions 物件已重新命名。舊名稱仍受支援。
• DirectionsRoute 到 DirectionsLeg
• DirectionsTrip to DirectionsRoute

2010 年 3 月 3 日

已變更的問題：

• 問題 2136： 在 google.maps.MarkerImage 中模糊處理不應參照的屬性

顯著異動：

• 修正地圖跳動錯誤。
• 改善連續兩次縮放功能。
• 標記拖曳事件 .latLng 不再經過模糊處理。

2010 年 2 月 26 日

已變更的問題：

• 問題 1651： 地圖畫布的 mousemove / mouseover / mouseout
• 問題 2142： DirectionsRendererOptions 應允許使用者完全隱藏標記
• 問題 2148: event.latLng 缺失！
• 問題 2109: Bug: NavigationControlStyle.ZOOM_PAN 在 IE8 中顯示不正確
• 問題 2153: MVCArray.push() 不回傳新的長度

顯著異動：

• 為 ImageMapType 新增不透明度。
• 修正了右鍵單擊矩形/圓形時無法觸發的錯誤。
• 隱藏訊息視窗時，訊息視窗的內容事件不再被刪除。

2010 年 2 月 8 日

已變更的問題：

• 問題 2135： 錯誤：如果在折線中重複使用多邊形的 MVCArray，折線會關閉。

顯著異動：

• 新增 矩形類別
• 新增 Circle 類別
• 修復了創建和刪除標記時出現的記憶體洩漏問題。
• 停止對 LatLngs 的 MVCArray 進行註釋以閉合多邊形，因為這會導致共享相同 MVCArray 的折線也被閉合（參見 問題 2135）。
• 修正了地圖縮​​放設定為當前值時有時會隱藏螢幕上標記的錯誤。
• 修正了 ImageMapType 在 Android 上正確顯示的問題。
• 更改了多邊形裁剪方案，允許包含北極或南極的多邊形。
• 在浮點精度允許的範圍內，將墨卡托投影的緯度範圍增加到最大可能值。

2010 年 1 月 28 日

已變更的問題：

• 問題 1367：功能請求：向開發人員公開 LayoutManager，以便在「控制流」中放置 DIV
• 問題 1916：功能請求：新增縮放標記影像的功能
• 問題 1443: extend() 和 union() 應該回傳 LatLngBounds 對象
• 1997 年第 1 期：'size' MapOption 的文檔
• 問題 2074：當世界地圖尺寸與地圖容器尺寸完全匹配時，地圖無法渲染

顯著異動：

• 新增對印度語言的支援：
• bn、gu、kn、ml、mr、ta、te
• 在 event 命名空間 中新增了新的靜態方法：
• addListenerOnce
• addDomListenerOnce
• 在 DirectionsStep 物件新增了新的「encoded_lat_lngs」屬性，以壓縮 ASCII 格式公開緯度值集。
• 透過移除螢幕外標記 DOM 元素來提高效能
• 修復了 Google Chrome 瀏覽器中的平移錯誤
• 修正了 iPhone 上的捏合縮放錯誤

2010 年 1 月 19 日

已變更的問題：

• 問題 1422：功能請求：允許開發者建立自訂地圖類型
• 問題 1523：功能請求：從容器像素到經緯度（反之亦然）
• 問題 1443: extend() 和 union() 應該回傳 LatLngBounds 對象
• 問題 1960: bug: 使用 provideTripAlternatives 提供的資訊不完整
• 問題 1675：教學文件錯誤
• 問題 1676：教學文件錯誤 - 控制選項
• 問題 1856：Opera 中多邊形無法渲染！ ！ ！
• 問題 1954: 保加利亞語本地化不正確。
• 問題 1976： 錯誤：自訂圖示和可拖曳標記問題
• 問題 2063：壓縮 OverlayView 子類別時出現的變數名稱衝突

顯著異動：

• 已發布對自訂地圖類型的支持，包括底圖類型、疊加地圖類型和投影方式：
• http://code.google.com/apis/maps/documentation/v3/overlays.html#CustomMapTypes
• 新增 ImageMapType 對象，以支援自訂地圖瓦片
• http://code.google.com/apis/maps/documentation/v3/reference.html#ImageMapType

2009 年 12 月 17 日

顯著異動：

• 修正了地圖平移動畫開始前出現的初始抖動問題。
• 修正了使用滾輪或雙擊放大超過最大縮放等級時地圖跳到不同位置的問題。
• 版權、地圖類型和導航控制會調整大小以適應地圖大小。
• 舊式的 getter、setter 和事件名稱已被正式棄用，不再定義。

2009 年 12 月 10 日

已變更的問題：

• 問題 1820：使用滑鼠滾輪放大地圖時，似乎會放大到超過最大縮放級別，並且地圖位置會「跳過/跳躍」。
• 問題 1743：滾動縮放會導致地圖移動到完全不同的位置

其他顯著異動：

• 新增方法 panToBounds。
• 新增地圖動畫。影響所有瀏覽器中的拖曳、平移、縮放以及對 setCenter/setZoom 的呼叫。
• 如果使用了 已棄用的方法，則新增控制台日誌警告訊息。

2009 年 11 月 25 日

已變更的問題：

• 問題 1696：功能請求：地圖控制項放置
• 問題 1909：地圖中心更改後 getBounds 函數出錯
• 問題 1938: map.setOptions 無法辨識控制選項

其他顯著異動：

• 新增 RTL 支持，可啟用以下語言：阿拉伯語、波斯語、希伯來語
• 為 DirectionsResult 步驟公開 lat_lngs 屬性。

2009 年 11 月 11 日

已變更的問題：

• 問題 1742：自訂圖示標記總是顯示在預設標記之上

其他顯著異動：

• 新增對三種語言的支援。
• 巴斯克文
• 加里西亞文
• 塔加路文

2009 年 10 月 29 日

已變更的問題：

• 問題 1421：功能請求：向 API v3 新增 Directions 類

其他顯著異動：

• 參考文件已更新，包含 DirectionsRenderer 和 DirectionsService

2009 年 10 月 26 日

已變更的問題：

• 問題 1647：功能請求：為資訊視窗 DOM 就緒提供事件
• 問題 1710：雙擊取消使用者縮放事件的功能

其他顯著異動：

• 當向 `new google.maps.LatLng()` 傳遞無效參數時，會拋出 JS 錯誤。
• 修正了以下錯誤：靜態地圖在地圖載入時載入了兩次

2009 年 10 月 15 日

已變更的問題：

• 問題 1525：在低縮放層級發生 get_bounds 錯誤
• 問題 1757: fitBounds() 在 180 度經線上不起作用
• 問題 1790: map.setOptions 無法設定遊標
• 問題 1767: Bug 事件傳播問題

其他顯著異動：

• 說明文件更新：
• 新增方法：LatLngBounds.isEmpty()
• 依名稱對所有方法、事件、屬性和常數進行排序
• 修正了折線和多邊形選項屬性中的錯誤類型

2009 年 9 月 28 日

• 提升多邊形渲染效能。
• 修正了 SVGView 的 JS 警告問題。

2009 年 9 月 22 日

已變更的問題：

• 問題 1420：功能：為 API 新增折線類
• 問題 1371：地圖移動時 map.bounds_changed 事件會重複觸發
• 問題 1700：Firefox 3.5 縮小後點選位置不正確
• 問題 1702：當父元素存在滾動偏移時，按一下和雙擊事件中報告的 latLng 值不正確
• 問題 1723：在 iPhone 上拖曳地圖時地圖會跳動

其他顯著異動：

• 已發布折線和多邊形！這些功能可讓您在地圖上繪製線條或填滿區域，指定描邊和填滿樣式，並支援大多數滑鼠事件（即目前還不支援滑鼠懸停）。它們可在所有支援的瀏覽器（IE6.0+、Firefox 2.0+、Safari 3.1+、Chrome）上運行，包括支援的行動裝置。
• 為 折線 和 多邊形 的開發者指南新增了兩個新章節。
• API 參考文件中新增了兩個類別：折線 和 多邊形。
• 新增地圖事件“idle”，當地圖一段時間沒有移動時觸發。解 問題 1371。
• 修正了點擊事件返回的 LatLng 值不正確的問題。
• 修復了 iPhone 上的捏合縮放錯誤。參見第 1723 期。

2009 年 9 月 10 日

已變更的問題：

• 問題 1659：Firefox 3.5 在平移後，按一下和雙擊事件中報告的 latLng 不正確
• 問題 1621：在 IE8 中使用 dooctype 點選地圖後位置錯誤
• 問題 1642: 資訊視窗溢位：自動
• 問題 1531：資訊視窗的高度會隨著每次開啟而增加

其他顯著異動：

• 已修改 get/set 方法和事件名稱的語法，如下所示。為確保回溯相容性，系統仍支援舊語法。例如：
• set_funBoat() => setFunBoat()
• get_funBoat() => getFunBoat()
• funBoat_changed => funboat_changed
• 在 OverlayView 介面中新增「onAdd」方法，這個方法會在窗格和投影首次初始化時呼叫。這個 地址 問題 1377。
• OverlayView 介面的「remove」方法已重新命名為「onRemove」。為了確保回溯相容性，系統仍支援舊名稱。

2009 年 9 月 2 日

已變更的問題：

• 問題 1525：在低縮放層級發生 get_bounds 錯誤
• 問題 1596： 平移超過世界地圖的北端或南端邊緣時，會傳回錯誤
• 問題 1643： 錯誤：地圖捲動輪不必要
• 問題 1379：我無法在 V3 中查看韓國地圖資料

其他顯著異動：

• 在 Chrome、Safari 4 和 Firefox 3.5 上啟用連續滾輪和雙擊縮放功能
• 提升地圖拖曳效能
• 按兩下即可在縮放地圖後將地圖置中

2009 年 8 月 24 日

已變更的問題：

• 問題 1567： map.set_center 無法設為附近位置。
• 問題 1605： 捲動地圖時，頁面也會捲動
• 問題 1467：平移地圖函式 + 動畫

其他顯著異動：

• 預設啟用滾輪縮放功能。如要停用這項功能，請將地圖選項的 scrollwheel 屬性設為 false。
• 說明文件已更新，加入 panTo 和 panBy 函式。

2009 年 8 月 14 日

已變更的問題：

• 問題 1575：錯誤 在可拖曳標記方法 set_draggable() 中

其他顯著異動：

• 已啟用滾輪縮放功能。
• 修正 iPhone 上的問題：拖曳後地圖會跳動。

2009 年 8 月 4 日

已變更的問題：

• 問題 1393：允許拖曳標記
• 問題 1448： 錯誤：API v3 需要 checkResize() 函式 (或同等函式)
• 問題 1404： Opera 中的游標發生錯誤
• 問題 1514： 使用 HTML 4.01 strict 時，MapType 選取箭頭顯示不正確
• 問題 1426： 資訊視窗 z-index 控制項

其他顯著異動：

• 在 iPhone 上，雙指撥動和拖曳操作應更穩定。
• 在 InfoWindow 物件中新增 zIndex 設定器和擷取器。

說明文件異動：

• 新增標記 get_draggable 和 set_draggable 方法
• 新增了標記拖曳、拖曳開始、拖曳結束、可拖曳變更事件
• 標記可拖曳屬性已新增
• 資訊視窗新增了 get_zIndex 和 set_zIndex 方法
• 資訊視窗 zIndex_changed 事件已新增
• 資訊視窗 zIndex 屬性已新增

2009 年 7 月 13 日

已變更的問題：

• 問題 1415: 資訊視窗內容：可選擇 true/ false
• 問題 1432：呼叫 set_icon 後 Mouseout 事件不會觸發
• 問題 1365：地圖類型控制項在嚴格的 doctype 中無法正確算繪

其他顯著異動：

• 開發人員不必再為 MarkerImage 指定大小，API 會在未提供大小時偵測。附帶一提，MarkerImage 的大小、錨點和來源引數都是選用引數。
• 開發人員不再需要在 OverlayView 子類別的建構函式中呼叫 OverlayView.call(this)。
• OverlayView 的「changed」方法已從介面移除。這不應該影響開發者的程式碼，因為這些方法之前實際上並沒有被使用過。
• 從地理編碼器請求物件中移除了部分匹配選項。如果開發人員繼續傳遞該參數，則不會對查詢產生任何影響。

2009 年 6 月 12 日

已變更的問題：

• 問題 1363： 錯誤：iPhone 上不會傳送地圖點擊事件

其他顯著異動：

• 所有瀏覽器都可點選大型縮放控制項
• 資訊視窗「清除」了大型縮放控件，將自身完全置於地圖和控件內部。
• 移動版權使用精美圖片
• 圖塊從中心而非左上角載入
• 使用者將無法再選擇地圖類型按鈕的文字或任何控制圖像。
• 主要程式庫縮小約 1.9 KB