本頁面列出目前處於淘汰期的所有 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.的版本淘汰。
正在淘汰的項目
本節列出目前處於淘汰期的所有產品和功能。
Maps JavaScript API 的當地特色資料庫 (自 3.51.2 版淘汰)
這項 Beta 版功能的採用率不高,因此自 3.51.2 版起會淘汰當地特色資料庫。在我們進一步通知前,當地特色資料庫會持續運作,但建議不要加進新專案。
如果想要自行打造類似當地特色資料庫的體驗,建議查看快速建構工具中的「探索鄰近地區」解決方案,或是使用 Maps JavaScript API 中的 Places Library。Places Library 的程式碼範例和程式碼研究室可以助您一臂之力。
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 地圖平台 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.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
如需對等屬性,請使用 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 替代方案匯總
下表列出每個已淘汰方法或屬性的替代方案。
包含替代屬性的 Places SDK for iOS 最低版本為 3.8.0 版。