淘汰項目

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

淘汰流程簡介

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

正在淘汰的項目

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

google.load 中的地圖模組

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

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

setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner 協助程式方法已於 2020 年 8 月 10 日 (3.10.0 版) 淘汰。自 4.0.0 版開始，我們不再提供這項功能。請改用 locationBias 或 locationRestriction。

initWithBounds:filter 方法已於 2020 年 8 月 10 日 (3.10.0 版) 淘汰。自 4.0.0 版開始，我們不再提供這項功能。請改為在 GMSAutocompleteFetcher 中使用 initWithFilter:。

如要繼續使用這些已淘汰的功能，請停留在 3.10.0 版。

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

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

Places SDK for iOS GMSPlaceField 現在使用 NS_OPTIONS 巨集 (而不是 NS_ENUM 巨集)，以利支援 Swift。進一步瞭解改用 NS_OPTIONS 的 GMSPlaceField。

如要繼續讓 GMSPlaceField 使用 NS_ENUM，請停留在 3.10.0 版。

「地點自動完成」中的 GMSCoordinateBounds (2020 年 5 月 26 日 - 2021 年 5 月 26 日)

iOS「地點自動完成」服務中使用 GMSCoordinateBounds 的多個屬性/參數已於 2020 年 5 月 26 日淘汰，並將於 2021 年 5 月 26 日停用。

「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 (2020 年 5 月 26 日 - 2021 年 5 月 26 日)

Places SDK for iOS 的地點欄位/屬性 GMSPlace.openNowStatus 已於 2020 年 5 月 26 日淘汰，並將於 2021 年 5 月 26 日停用。請改用函式 GMSPlace.isOpen 或 GMSPlace.isOpenAtDate。包含上述函式的 Places SDK for iOS 最低版本為 3.3.0 版。

地點欄位：permanently_closed (2020 年 5 月 26 日 - 2021 年 5 月 26 日)

Places API 和 Places Library、Maps JavaScript API 中的地點欄位 permanently_closed 已於 2020 年 5 月 26 日淘汰，並將於 2021 年 5 月 26 日停用。請改為使用 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 日 - 2021 年 2 月 20 日)

Places Library、Maps JavaScript API 中的地點欄位 open_now 和 utc_offset 已於 2019 年 11 月 20 日淘汰，並將於 2021 年 2 月 20 日停用。

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

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

包含 isOpen() 和 utc_offset_minutes 的 Places Library、JavaScript API 最低版本為 3.39 版。詳情請參閱地點欄位遷移。

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

地點欄位 reference、id、alt_id 和 scope 已於 2019 年 9 月 3 日淘汰，並將於 2020 年 6 月 3 日停用。

  • id 和 reference 要求參數已為 place_id 要求參數所取代。
  • alt_id 和 scope 欄位沒有對等的欄位，因為這些欄位僅用於「地點新增」服務，而該服務已於 2018 年 7 月停用。

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

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

Maps JavaScript API 2 版已於 2010 年 5 月 19 日淘汰，並將於 2021 年 5 月 26 日停用。雖然您可以在 2021 年 5 月 26 日之前繼續使用 Maps JavaScript API 2 版，但自 2020 年 10 月 26 日起，您網站上使用 2 版 API 的地圖亮度會變暗，並顯示浮水印文字：「僅供開發使用」。為避免出現上述情況時帶來任何不便，或造成使用者混淆，強烈建議您在 2020 年 10 月 26 日前為網站改用 Maps JavaScript API 3 版。進一步瞭解如何將 Maps JavaScript API 應用程式從 2 版升級至 3 版。

已淘汰完成的項目

本節會列出淘汰期已結束的所有產品和功能。這些產品和功能已不再提供。

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 版。