弃用

本页面列出了当前处于弃用期的所有 Google Maps Platform 产品和功能,包括地图、路线和地点下的产品。

弃用的工作原理

产品、功能或版本的弃用期从公布弃用的当天开始算起。产品、功能或版本在弃用期(通常为 12 个月)内仍可继续使用。弃用期结束后,产品、功能或版本将被停用,不再提供。

SDK 版本的弃用

在 SDK 和 Maps JavaScript API 中,功能的弃用与版本可用性相关。新的主要版本声明了一些重大更改(包括功能的弃用及版本说明),指明了支持每个已弃用功能的最高版本。只要支持已弃用功能的最高 SDK 版本可用,您就可以继续使用已弃用的功能。要升级到 SDK 的下一个主要版本,您必须从代码中移除已弃用的功能或迁移到其替换版本。

详细了解遵循季度发布和停用时间表的 Maps JavaScript API 版本可用性

请参阅相关指南,了解如何管理 Maps SDK for AndroidMaps SDK for iOSPlaces SDK for AndroidPlaces SDK for iOS 的版本依赖项。

处于弃用期

本部分列出了当前处于弃用期的所有产品和功能。


已作废的地点 ID(2021 年 3 月 16 日 - 2022 年 3 月 30 日)

自 2022 年 3 月 30 日起,所有 Google Maps Platform API 将停止接受已作废的地点 ID。自 2022 年 3 月 30 日起,使用作废的地点 ID 的所有请求都将被拒绝,并返回错误代码 INVALID_REQUEST。为防止用户体验变差,请刷新所有地点 ID(早于 2021 年 3 月 30 日的 ID)。


google.load 中的 Maps 模块(2020 年 10 月 13 日 - 2021 年 10 月 13 日)

google.load 提供“Maps”模块的服务自 2020 年 10 月 13 日起弃用,自 2021 年 10 月 13 日起停用。停用之后,请求加载 google.load 中的“Maps”模块将导致错误,并且不会加载任何地图。如需了解详情,请参阅迁移指南


Places Library、Maps JavaScript API GMSPlaceField 现在采用 NS_OPTIONS 宏(从 v4.0.0 开始)

从 Places Library 开始,Maps JavaScript API v4.0.0 GMSPlaceField 现在采用 NS_OPTIONS 宏,而非 NS_ENUM,以获得更好的 Swift 支持。如需详细了解,请参阅改用采用 NS_OPTIONS 的 GMSPlaceField

如需继续使用采用 NS_ENUMGMSPlaceField,请在依赖项中指定 v3.10.0 或更早版本。


Places SDK for iOS 的方法:setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 - v4.0.0)

setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner 辅助方法自 v3.10.0 起已弃用,在 v4.0.0 或更高版本中不受支持。请改用 locationBiaslocationRestriction

initWithBounds:filter 方法自 v3.10.0 起弃用,在 v4.0.0 及更高版本中不受支持。请在 GMSAutocompleteFetcher 中改用 initWithFilter:

支持已弃用的方法的最高版本是 v3.10.0

如需详细了解替换方法,请参阅附录 1


地点自动补全中的 GMSCoordinateBounds (v3.9.0 - v4.0.0)

在 Places Library 和 JavaScript API 自动补全服务中利用 GMSCoordinateBounds 的一些属性/参数自 v3.9.0 起弃用,并且在 v4.0.0 及更高版本中不受支持。支持已弃用的属性/参数的最高版本是 v3.10.0

GMSAutocompleteViewController 中的边界

以下 GMSAutocompleteViewController 属性将弃用:

如需实现同等功能,请将 GMSAutocompleteViewController.autocompleteFilterGMSAutocompleteFilter.locationBiasGMSAutocompleteFilter.locationRestriction 结合使用。具有替换属性的最低 Places SDK for iOS 版本是 v3.8.0。

findAutocompletePredictionsFromQueryautocompleteQuery 中的边界

如需实现同等功能,请将 findAutocompletePredictionsFromQuery:filter:sessionToken:callbackGMSAutocompleteFilter.locationBiasGMSAutocompleteFilter.locationRestriction 结合使用。具有替换属性的最低 Places SDK for iOS 版本是 v3.8.0

如需详细了解替换方法,请参阅附录 1


“地点”字段 GMSPlace.openNowStatus (v3.0.0 - v4.0.0)

Places SDK for iOS 中的“地点”字段/属性 GMSPlace.openNowStatusv3.0.0 起弃用,在 v4.0.0 及更高版本中不受支持。支持已弃用的字段的最高版本是 v3.10.0

请改用 GMSPlace.isOpenGMSPlace.isOpenAtDate 函数。具有这些替换函数的最低 Places SDK for iOS 版本是 v3.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 版本是 v3.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 字段已替换为 PlaceResult.opening_hours.isOpen()。对于“附近搜索”和“文本搜索”,请使用 openNow:true 请求参数过滤出当前打开的地点。没有为“查找地点”提供对应项。如需获得此值,您现在必须发送“地点详情”请求。
  • 在“地点详情”中,utc_offset 字段已替换为 PlaceResult.utc_offset_minutes

如需了解详情,请参阅“地点”字段迁移


弃用期结束

本部分列出了所有已停用的产品和功能。这些产品和功能均不再提供。


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

Maps JavaScript API 第 2 版自 2021 年 5 月 26 日起不再提供。因此,您网站的 v2 地图将停止运行,并返回 JavaScript 错误。若要继续在您的网站上使用地图,请改用 Maps JavaScript API v3。如需了解详情,请参阅将您的 Maps JavaScript API 应用从 v2 升级到 v3


“地点”字段: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 和地点选取器自 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.autocompleteFilterlocationBiaslocationRestriction 结合使用。
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callbackautocompleteQuery:bounds:filter:callbackautocompleteQuery:bounds:boundsMode:filter:callback
(在 GMSPlacesClient 中)
findAutocompletePredictionsFromQuery:filter:sessionToken:callbacklocationBiaslocationRestriction 结合使用。

具有替换属性的最低 Places SDK for iOS 版本是 v3.8.0