弃用

本页面列出了当前处于弃用期的所有 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 JavaScript API v2(2010 年 5 月 19 日 - 2021 年 5 月 26 日)

Maps JavaScript API 第 2 版自 2010 年 5 月 19 日起弃用,自 2021 年 5 月 26 日起停用。因此,您网站的 v2 地图将停止运行,且返回 JavaScript 错误。为了避免这种情况带来不便,我们强烈建议您在 2021 年 5 月 26 日之前为您的网站改用 Maps JavaScript API v3。如需了解详情,请参阅将您的 Maps JavaScript API 应用从 v2 升级到 v3


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

“地点”字段:referenceidalt_idscope(2019 年 9 月 3 日 - 2020 年 8 月 10 日)

“地点”字段 referenceidalt_idscope 自 2019 年 9 月 3 日起弃用,自 2020 年 8 月 10 日起停用。

  • idreference 响应字段已替换为 place_id 响应字段。
  • alt_idscope 字段没有对应项,因为它们仅用于在 2018 年 7 月停用的“地点添加”服务。

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


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