淘汰項目

本頁面列出目前處於淘汰期的所有 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.的版本淘汰。

正在淘汰的項目

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

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

如需對等屬性，請使用 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 日淘汰，因此不應使用。

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

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

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

已淘汰完成的項目

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

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 和「地點挑選程式」的現有版本已於 2019 年 1 月 29 日淘汰，並於 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 版。