淘汰項目

本頁面列出目前處於淘汰期的所有 Google 地圖平台產品和功能，包括地圖介面集、路徑介面集和地點介面集的子產品。

淘汰流程簡介

各產品、功能或版本在公告淘汰當天即進入淘汰期。淘汰期間 (通常為 12 個月) 您還是可以繼續使用這些產品、功能或版本。淘汰期結束後，產品、功能或版本將會停用，不再提供使用。

電子郵件地址有人監管的專案擁有者，會在變更對各項專案有影響時收到主動通知。隨時掌握重大更新、淘汰項目和其他異動。

SDK 版本淘汰

在 SDK 和 Maps JavaScript API 中，功能的淘汰標準取決於版本可用性。新的主要版本會宣告破壞性變更 (包括功能淘汰和版本資訊)，說明每個已淘汰功能的最高支援版本。只要 SDK 支援版本上限的版本仍可用，您就能繼續使用已淘汰的功能。如要升級至 SDK 的下一個主要版本，您必須移除程式碼中已淘汰的功能，或將其遷移至替代方案。

進一步瞭解 Maps JavaScript API 版本可用性，目前每季公布版本釋出和停用資訊。

請參閱相關指南，瞭解如何管理 Maps SDK for Android、Maps SDK for iOS、Places SDK for Android 和 Places SDK for iOS.的版本淘汰。

正在淘汰的項目

本節列出目前處於淘汰期的所有產品和功能。

Places SDK for Android 適用的地點介面集相容性程式庫 (截至 2022 年 3 月 31 日)

Places SDK for Android 所有版本的地點介面集相容程式庫已於 2022 年 3 月 31 日淘汰。我們即將停止開發 Places SDK for Android 2.6.0 版的地點介面集相容性程式庫 (在依附元件中指定為 com.google.android.libraries.places:places-compat:2.6.0)。

上述日期過後，我們不會再發布這個程式庫的任何新版本。接下來只能使用 Places SDK for Android 存取 Places SDK for Android 2.6.0 以上版本的功能和錯誤修正檔。

地點介面集相容性程式庫於 2019 年 1 月推出，主要是為了加速舊版 SDK (適用於 Play 服務) 遷移至獨立式 Places SDK for Android 的過程。

請按照遷移指南直接使用 Places SDK for Android。地點介面集相容性程式庫和 Places SDK for Android 中的一些狀態碼、方法名稱和 Autocomplete 類別名稱互不相同。請參閱「版本」說明文件，瞭解如何指定及維護 Places SDK for Android 版本的依附元件。

我們目前不打算停用地點介面集相容性程式庫。如果您要繼續使用現有的地點介面集相容性程式庫版本，請特別留意舊版 SDK 的支援限制。

Places API 和 Maps JavaScript API Places Library 中不支援的 Place Search 查詢 (2022 年 3 月 31 日至 2023 年 3 月 31 日)

Places API 和 Maps JavaScript API Places Library 中不適用於 Text Search、Nearby Search 和 Find Place 的 Place Search 查詢，已於 2022 年 3 月 31 日淘汰，且自 2023 年 3 月 31 日起會收到 INVALID_REQUEST 錯誤回應。

Places API 和 Maps JavaScript API Places Library 支援三種搜尋地點的方法：Text Search、Nearby Search 及 Find Place。每一種都接受使用支援參數組合的要求，並拒絕參數組合不受支援的多數要求。

到目前為止，系統並未正確拒絕幾個不支援的參數組合：

query 參數空白或遺漏，且不含支援的 type 參數的 Text Search 要求。
包含 query=* 的 Text Search 要求。
包含 keyword=* 的 Nearby Search 要求。
包含 name=* 的 Nearby Search 要求。
包含 input=* 的 Find Place 要求。

您必須將這些不支援的 Place Search 要求換成下列其中一個項目：

不含 keyword (或 name) 參數的 Nearby Search 要求可用於搜尋附近的建築物。此外，建議搭配使用 type 參數和其中一種支援的類型 (請參閱「表 1：地點類型」)。如果 Text Search 要求的 query 參數空白或遺漏，上述做法就能產生與這些要求的目前行為最相符的項目。
包含 latlng 參數的 Geocoding API 要求可用於搜尋最近的地址。這種做法可以產生與下列要求的目前行為最相符的項目：
- 包含 query=* 的 Text Search 要求。
- 包含 keyword=* 的 Nearby Search 要求。
- 包含 name=* 的 Nearby Search 要求。
- 包含 input=* 的 Find Place 要求。

內容安全政策更新 (2022 年 3 月 21 日 - 2023 年 5 月)

如果網站使用內容安全政策 (CSP)，且未在 Maps JavaScript API 中指定 googleapis.com，我們提供的支援只到 v3.49 版本，v3.50 起不再提供相關支援。最後一個支援版本 v3.49 將於 2023 年第 2 季停用，往後對於使用 CSP 指令且未指定 googleapis.com 的所有要求，Maps JavaScript API 將一律拒絕。

如要避免網站體驗中斷，請在 CSP 中指定 googleapis.com。目前所有可用的 Maps JavaScript API 版本都支援 CSP。

Google 地圖平台遊戲服務 (2021 年 10 月 18 日 - 2022 年 12 月 31 日)

Google 地圖平台遊戲服務已於 2021 年 10 月 18 日淘汰，並將於 2022 年 12 月 31 日停用。淘汰期間，Google 會持續提供重大錯誤和服務中斷問題的相關支援和修正。請參閱遊戲服務轉換指南中的資源，為專案規劃後續步驟。

過時地點 ID (2021 年 3 月 16 日 - 2022 年 3 月 30 日)

自 2022 年 3 月 30 日起，所有 Google Maps Platform API 都會停止接受某些過時的地點 ID。自 2022 年 3 月 30 日起，凡是使用過時地點 ID 提出的要求都會遭拒，並傳回錯誤代碼 INVALID_REQUEST。為避免使用者體驗變差，請在 2022 年 3 月 30 日前更新超過 12 個月的所有地點 ID。

google.load 中的地圖模組 (2020 年 10 月 13 日 - 2021 年 10 月 13 日)

為 google.load 提供「地圖」模組的服務已於 2020 年 10 月 13 日淘汰，並將於 2021 年 10 月 13 日停用。之後提出在 google.load 中載入「地圖」模組的要求將會導致錯誤，且不會載入任何地圖。詳情請參閱遷移指南。

Places SDK for iOS `GMSPlaceField` 現在使用 `NS_OPTIONS` 巨集 (自 4.0.0 版起)

自 Places SDK for iOS 4.0.0 版起，GMSPlaceField 現在使用 NS_OPTIONS 巨集，而非 NS_ENUM，以便改善 Swift 支援。進一步瞭解如何改用 NS_OPTIONS 的 GMSPlaceField。

如要繼續使用 GMSPlaceField 做為 NS_ENUM，請在依附元件中指定 3.10.0 版或更舊版本。

Places SDK for iOS 方法： setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner、initWithBounds:filter (3.10.0 版 - 4.0.0 版)

setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner 協助程式方法自 3.10.0 版起淘汰，且不適用於 4.0.0 版和更新版本。請改用 locationBias 或 locationRestriction。

initWithBounds:filter 方法自 3.10.0 版起淘汰，且不適用於 4.0.0 版和更新版本。請改為在 GMSAutocompleteFetcher 中使用 initWithFilter:。

這些已淘汰方法的最高支援版本為 3.10.0 版。

如要進一步瞭解替代方法，請參閱附錄 1。

Place Autocomplete 中的 `GMSCoordinateBounds` (3.9.0 版 - 4.0.0 版)

Places SDK for iOS Autocomplete 服務中使用 GMSCoordinateBounds 的多個屬性/參數已於 3.9.0 版淘汰，且不適用於 4.0.0 版和更新版本。已淘汰屬性/參數的最高支援版本為 3.10.0 版。

`GMSAutocompleteViewController` 中的 Bounds

下列 GMSAutocompleteViewController 屬性已淘汰：

如需對等屬性，請使用 GMSAutocompleteViewController.autocompleteFilter 搭配 GMSAutocompleteFilter.locationBias 或 GMSAutocompleteFilter.locationRestriction。包含這些替代屬性的 Places SDK for iOS 最低版本為 3.8.0 版。

`findAutocompletePredictionsFromQuery` 和 `autocompleteQuery` 中的 Bounds

以下項目的 bounds 和 boundsMode 參數：

如需對等屬性，請使用 findAutocompletePredictionsFromQuery:filter:sessionToken:callback 搭配 GMSAutocompleteFilter.locationBias 或 GMSAutocompleteFilter.locationRestriction。包含這些替代屬性的 Places SDK for iOS 最低版本為 3.8.0 版。

如要進一步瞭解替代方法，請參閱附錄 1。

地點欄位 `GMSPlace.openNowStatus` (3.0.0 版 - 4.0.0 版)

Places SDK for iOS 中的地點欄位/屬性 GMSPlace.openNowStatus 自 3.0.0 版起淘汰，且不適用於 4.0.0 版和更新版本。已淘汰欄位的最高支援版本為 3.10.0 版。

請改用函式 GMSPlace.isOpen或 GMSPlace.isOpenAtDate。包含這些替代函式的 Places SDK for iOS 最低版本為 3.3.0 版。

地點欄位：`permanently_closed` (已於 2020 年 5 月 26 日淘汰)

Places API 和 Places Library、Maps JavaScript API 中的地點欄位 permanently_closed 已淘汰，因此不應使用。請改為使用 business_status (Places API) 或 business_status (Places Library、JavaScript API) 來取得商家營業狀態。包含 business_status 的 Places Library、Maps JavaScript API 最低版本為 3.40 版。

地點欄位 `open_now`、`utc_offset` (已於 2019 年 11 月 20 日淘汰)

Places Library、Maps JavaScript API 中的地點欄位 open_now 和 utc_offset 已於 2019 年 11 月 20 日淘汰，因此不應使用。

只有 Maps JavaScript API 中的 Places Library 淘汰這些欄位。

open_now 欄位已由 Place Details 中的 PlaceResult.opening_hours.isOpen() 取代。如要取得「附近地點搜尋」及「文字搜尋」功能，可以使用 openNow:true 要求參數來篩選目前營業中的地點。「尋找地點」功能則沒有對等的功能。如要取得這個值，您現在必須提出 Place Details 要求。
utc_offset 欄位已由 Place Details 中的 PlaceResult.utc_offset_minutes 取代。

詳情請參閱「地點欄位遷移」一文。

Maps JavaScript API：`google.maps.event.addDomListener()` 和 `google.maps.event.addDomListenerOnce()` (已於 2022 年 4 月 7 日淘汰)

Maps JavaScript API 中的 [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) 和 [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) 函式已淘汰，不建議使用。請改用標準 addEventListener() 方法。

這些方法會繼續運作，目前無停用計畫。

已淘汰完成的項目

本節列出已停用的所有產品和功能。這些產品和功能已不再提供。

Maps JavaScript API 2 版 (2010 年 5 月 19 日 - 2021 年 5 月 26 日)

Maps JavaScript API 2 版已於 2021 年 5 月 26 日停止提供。因此，您網站的 2 版地圖會停止運作，並傳回 JavaScript 錯誤。如要繼續在您的網站上使用地圖，請遷移至 Maps JavaScript API 3 版。進一步瞭解如何將 Maps JavaScript API 應用程式從 2 版升級至 3 版。

地點欄位：`reference`、`id`、`alt_id`、`scope` (2019 年 9 月 3 日 - 2020 年 8 月 10 日)

地點欄位 id、alt_id 和 scope 已於 2020 年 8 月 10 日停止提供。地點欄位 reference 已淘汰，因此不應使用。

id 回應欄位已由 place_id 回應欄位取代。
reference 回應欄位已由 place_id 回應取代，因此不應使用。
alt_id 和 scope 欄位沒有對等的欄位，因為這些欄位僅用於「地點新增」服務，而該服務已於 2018 年 7 月停用。

詳情請參閱「地點欄位遷移」一節。

Maps SDK for iOS 5.0 中的 iOS 10 版和 ARMv7 32 位元架構

自 Maps SDK for iOS 5.0 版起，不再支援 iOS 10 和 ARMv7 32 位元架構。

Places SDK for iOS

隨著 Places SDK for iOS 5.0 推出，GMSCoordinateBounds 會停用，並由 GMSPlacesViewportInfo 取代。

Fusion Tables 圖層 (實驗功能) (2018 年 12 月 3 日 - 2019 年 12 月 3 日)

Maps JavaScript API 中的 Fusion Tables 圖層已於 2019 年 12 月 3 日停用，且自 3.38 版起便不再提供此功能 (3.37 版是支援 Fusion Tables 圖層的最後版本)。瞭解詳情。

Places SDK for Android 和 Places SDK for iOS (2019 年 1 月 29 日 - 2019 年 7 月 29 日)

自 2019 年 1 月 29 日起，最新 Places SDK for Android 和 Places SDK for iOS 會取代現有的 Places SDK 版本。Places SDK for iOS、Places SDK for Android 和 Place Picker 的現有版本已於 2019 年 1 月 29 日淘汰，並於 2019 年 7 月 29 日停用。

更新至最新版 Places SDK for iOS。
更新至最新版 Places SDK for Android。
「地點挑選程式」服務已於 2019 年 7 月 29 日停用。

「地點新增」和「地點刪除」(2017 年 6 月 30 日 - 2018 年 6 月 30 日)

「地點新增」和「地點刪除」功能已於 2018 年 6 月 30 日停用，不再提供使用。

附錄 1：Places SDK for iOS 已淘汰 API 替代方案匯總

下表列出每個已淘汰方法或屬性的替代方案。

已淘汰的方法/屬性	替代方案
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteViewController` 中)	`locationRestriction` 和 `locationBias`
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteResultsViewController` 中)	`locationRestriction` 和 `locationBias`
`setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner` (`GMSAutocompleteTableDataSource` 中)	`locationRestriction` 和 `locationBias`
`initWithBounds:filter` (`GMSAutocompleteFetcher` 中)	`initWithFilter:`
`autocompleteBounds` 和 `autocompleteBoundsMode` (`GMSAutocompleteViewController` 中)	`GMSAutocompleteViewController.autocompleteFilter`，搭配 `locationBias` 或 `locationRestriction` 使用。
`findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback`、`autocompleteQuery:bounds:filter:callback` 和 `autocompleteQuery:bounds:boundsMode:filter:callback` (`GMSPlacesClient` 中)	`findAutocompletePredictionsFromQuery:filter:sessionToken:callback`，搭配 `locationBias` 或 `locationRestriction` 使用。

包含替代屬性的 Places SDK for iOS 最低版本為 3.8.0 版。