淘汰項目

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

正在淘汰的項目

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


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 APIMaps JavaScript API Places Library 支援三種搜尋地點的方法:Text SearchNearby SearchFind 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 季停用,之後 Maps JavaScript API 會拒絕使用 CSP 指令且未指定 googleapis.com 的所有要求。

如要避免網站體驗中斷,請在 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 版和更新版本。 請改用 locationBiaslocationRestriction

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.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 欄位已由 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 版


地點欄位: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 和 Place Picker 的現有版本已於 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 版。