淘汰項目

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

淘汰流程簡介

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

SDK 版本淘汰

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

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

請參閱相關指南,瞭解如何管理 Maps SDK for AndroidMaps SDK for iOSPlaces SDK for AndroidPlaces SDK for iOS.的版本淘汰。

正在淘汰的項目

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


過時地點 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 Library、Maps JavaScript API GMSPlaceField 現在會使用 NS_OPTIONS 巨集 (自 4.0.0 版起)

從 Places Library、Maps JavaScript API 4.0.0 版開始,為了改善 Swift 支援,GMSPlaceField 現在會使用 NS_OPTIONS 巨集,而非 NS_ENUM。進一步瞭解如何改用 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 版和更新版本。 請改用 locationBiaslocationRestriction

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

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

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


「地點自動完成」中的 GMSCoordinateBounds (3.9.0 版 - 4.0.0 版)

在 Places Library 和 JavaScript API 自動完成服務中使用 GMSCoordinateBounds 的幾個屬性/參數自 3.9.0 版起淘汰,且不適用於 4.0.0 版和更新版本。已淘汰屬性/參數的最高支援版本為 3.10.0 版

GMSAutocompleteViewController 中的 Bounds

下列 GMSAutocompleteViewController 屬性已淘汰:

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

findAutocompletePredictionsFromQueryautocompleteQuery 中的 Bounds

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

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


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

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

請改用函式 GMSPlace.isOpenGMSPlace.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_nowutc_offset (已於 2019 年 11 月 20 日淘汰)

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

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

  • open_now 欄位已由「地點詳細資料」中的 PlaceResult.opening_hours.isOpen() 取代。如要取得「附近地點搜尋」及「文字搜尋」功能,可以使用 openNow:true 要求參數來篩選目前營業中的地點。「尋找地點」功能則沒有對等的功能。如要取得這個值,您現在必須提出「地點詳細資料」要求。
  • utc_offset 欄位已由「地點詳細資料」中的 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 版


地點欄位:referenceidalt_idscope (2019 年 9 月 3 日 - 2020 年 8 月 10 日)

地點欄位 idalt_idscope 已於 2020 年 8 月 10 日停止提供。地點欄位 reference 已淘汰,因此不應使用。

  • id 回應欄位已由 place_id 回應欄位取代。
  • reference 回應欄位已由 place_id 回應取代,因此不應使用。
  • alt_idscope 欄位沒有對等的欄位,因為這些欄位僅用於「地點新增」服務,而該服務已於 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 中)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(GMSAutocompleteResultsViewController 中)
locationRestrictionlocationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(GMSAutocompleteTableDataSource 中)
locationRestrictionlocationBias
initWithBounds:filter
(GMSAutocompleteFetcher 中)
initWithFilter:
autocompleteBoundsautocompleteBoundsMode
(GMSAutocompleteViewController 中)
GMSAutocompleteViewController.autocompleteFilter,搭配 locationBiaslocationRestriction 使用。
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callbackautocompleteQuery:bounds:filter:callbackautocompleteQuery:bounds:boundsMode:filter:callback
(GMSPlacesClient 中)
findAutocompletePredictionsFromQuery:filter:sessionToken:callback,搭配 locationBiaslocationRestriction 使用。

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