弃用

本页面列出了当前处于弃用期的所有 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.autocompleteFilter 与 GMSAutocompleteFilter.locationBias 或 GMSAutocompleteFilter.locationRestriction 结合使用。具有这些属性的最低 Places SDK for iOS 版本是 v3.8.0。

findAutocompletePredictionsFromQuery 和 autocompleteQuery 中的边界

如需实现同等功能，请将 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 日起停用。

“地点添加”和“地点删除”（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 版本是 v3.8.0。