本页面列出了当前处于弃用期的所有 Google Maps Platform 产品和功能,包括地图、路线和地点下的产品。
弃用的工作原理
产品或功能的弃用期从公布弃用的当天开始算起。产品或功能在弃用期(通常为 12 个月)内仍可继续使用。弃用期结束后,产品或功能将被停用,不再提供。
处于弃用期
本部分列出了当前处于弃用期的所有产品和功能。
google.load 中的 Maps 模块
为 google.load
提供“Maps”模块的服务自 2020 年 10 月 13 日起弃用,自 2021 年 10 月 13 日起停用。停用之后,请求加载 google.load
中的“Maps”模块将导致错误,并且不会加载任何地图。如需了解详情,请参阅迁移指南。
Places SDK for iOS 的方法:setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
、initWithBounds:filter
(从 v4.0.0 开始)
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
辅助方法自 2020 年 8 月 10 日起弃用 (v3.10.0)。从 v4.0.0 开始,此功能将不再提供。请改用 locationBias
或 locationRestriction
。
initWithBounds:filter
方法自 2020 年 8 月 10 日起弃用 (v3.10.0)。从 v4.0.0 开始,此功能将不再提供。请在 GMSAutocompleteFetcher
中改用 initWithFilter:
。
如需继续使用这些已弃用的功能,请继续使用 v3.10.0。
如需详细了解替换方法,请参阅附录 1。
Places SDK for iOS 的 GMSPlaceField
现在采用 NS_OPTIONS
宏(从 v4.0.0 开始)
Places SDK for iOS 的 GMSPlaceField
现在采用 NS_OPTIONS
宏(而非 NS_ENUM
),以获得更好的 Swift 支持。如需详细了解,请参阅改用采用 NS_OPTIONS 的 GMSPlaceField。
如需继续使用采用 NS_ENUM
的 GMSPlaceField
,请继续使用 v3.10.0。
地点自动补全中的 GMSCoordinateBounds
(2020 年 5 月 26 日 - 2021 年 5 月 26 日)
在 iOS 地点自动补全服务中利用 GMSCoordinateBounds
的一些属性/参数自 2020 年 5 月 26 日起弃用,自 2021 年 5 月 26 日起停用。
GMSAutocompleteViewController
中的边界
以下 GMSAutocompleteViewController
属性将弃用:
GMSAutocompleteViewController.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
如需实现同等功能,请将 GMSAutocompleteViewController.autocompleteFilter
与 GMSAutocompleteFilter.locationBias
或 GMSAutocompleteFilter.locationRestriction
结合使用。具有这些属性的最低 Places SDK for iOS 版本是 v3.8.0。
findAutocompletePredictionsFromQuery
和 autocompleteQuery
中的边界
- 用于以下各项的
bounds
和boundsMode
参数:
如需实现同等功能,请将 findAutocompletePredictionsFromQuery:filter:sessionToken:callback
与 GMSAutocompleteFilter.locationBias
或 GMSAutocompleteFilter.locationRestriction
结合使用。具有这些属性的最低 Places SDK for iOS 版本是 v3.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 版本是 v3.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 版本是 v3.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 和 Maps JavaScript API 版本是 v3.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 v2(2010 年 5 月 19 日 - 2021 年 5 月 26 日)
Maps JavaScript API 第 2 版自 2010 年 5 月 19 日起弃用,自 2021 年 5 月 26 日起停用。尽管您在 2021 年 5 月 26 日之前可以继续使用 Maps JavaScript API v2,但自 2020 年 10 月 26 日起,使用 v2 的地图将在您网站的 v2 地图上显示暗色地图,并带有“仅用于开发目的”的文字水印。为了避免这种情况带来不便或让用户感到困惑,我们强烈建议您在 2020 年 10 月 26 日之前为您的网站改用 Maps JavaScript API v3。如需了解详情,请参阅将您的 Maps JavaScript API 应用从 v2 升级到 v3。
弃用期结束
本部分列出了弃用期结束的所有产品和功能。这些产品和功能均不再提供。
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 日起停用。
- 更新至最新版本的 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 版本是 v3.8.0。