版本控制

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

Maps JavaScript API 团队会定期更新 API,以加入新功能、修复 bug 并提升性能。本页介绍了可用于您的应用的 API 版本。

发布版本和版本号

在您的应用中,您可以指定发布渠道或版本号:

  • 每周渠道v=weekly 指定。
    此渠道每周更新一次,并且是最新的。
  • 每季度渠道使用 v=quarterly 指定。
    此渠道每个季度更新一次,并且是最可预测的。
  • Beta 渠道使用 v=beta 指定。
    此频道基于“weekly”频道,每周更新一次。其中包含针对早期测试和反馈的其他变更。
  • 版本号通过 v=n.nn 指定。
    您可以选择 v=3.50v=3.49v=3.48v=3.47
    版本号每季度更新一次(请参阅季度更新)。

如果您未明确指定渠道或版本,则默认情况下将收到每周渠道。如果您是从高级计划迁移而来,并且未明确指定渠道或版本,则默认情况下您将收到季度渠道。如果您指定的版本无效,您会收到默认频道。

选择每周渠道

对于大多数应用,我们建议使用每周渠道。这是最新的最新版本,包含最新的问题修复和性能改进。您可以通过使用以下脚本标记加载 Maps JavaScript API 来指定每周渠道:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

目前,每周版本为 3.50。 此版本每周都会更新,以加入新功能、修复问题并提升性能。

11 月中旬,每周版本将更新到 3.51。届时,新版本可能会移除已弃用的功能和/或引入向后兼容性。

选择季度渠道

某些应用可受益于更少但规模更大的更新,因为它可以提高可预测性。这些应用应使用季度渠道。如果您希望 bug 修复和性能改进在预期的时间(见季度更新)出现,请使用此方法。您可以通过使用以下脚本标记加载 Maps JavaScript API 来指定季度频道:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

目前,季度渠道为 3.49 版本。在本季度,此版本将不再接收新功能、问题修复或性能改进。 我们可能会不时在此版本中引入安全 bug 修复。

从 11 月中旬开始,季度频道将更新到 3.50 版本。届时,新版本将包含新功能、移除已弃用的功能和/或引入前三个月的向后兼容性。

选择 Beta 渠道

使用 Beta 版试用新的 Beta 版功能和变更。Beta 版功能完整,但可能存在一些未解决的问题(请使用问题跟踪器报告问题并提供反馈)。Beta 版不在任何服务等级协议 (SLA) 或弃用政策的涵盖范围内,并且某些更改可能无法向后兼容早期版本。

此频道基于weekly频道,每周更新一次。

您可以通过使用以下脚本标记加载 Maps JavaScript API 来指定 Beta 版:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

选择版本号

请仅在定期测试和更新应用时指定版本号。 这是因为随着每个季度创建新版本,编号版本最终会被删除。您可以通过使用以下脚本标记加载 Maps JavaScript API 来指定版本号:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.49
        &key=YOUR_API_KEY&callback=initMap">
</script>

目前,您可以指定 v=3.50v=3.49v=3.48v=3.47

  • 版本 3.50 会收到新功能更新、问题修复和性能改进的每周更新。
  • 版本 3.49 不会收到每周更新。
  • 版本 3.48 不会收到每周更新。
  • 版本 3.47 无法接收每周更新。
  • 我们可能会不时地在任何版本中引入安全 bug 修复。
  • 我们可能会在创建新版本时引入不向后兼容的更改。

11 月中旬之后,您将能够指定 v=3.51v=3.50v=3.49v=3.48

  • 版本 3.51 将收到每周更新,包含新功能、问题修复和性能改进。
  • 版本 3.50 将不会再收到每周更新。
  • 版本 3.49 将不会再收到每周更新。
  • 版本 3.48 将不会再收到每周更新。
  • 我们可能会不时地在任何版本中引入安全 bug 修复。
  • 版本 3.47 将不再提供。任何尝试加载此版本的操作都将被忽略,而您会收到默认渠道。

下图显示了来年的各个渠道将会提供的版本。

一项更新影响了我的应用

我们在更新发布渠道时,可能会影响您的应用。这可能是因为您的应用依赖于未经记录或已弃用的功能,或者是我们引入的错误或 bug 修复。

您可以暂时将应用改写为使用旧版本。

  1. 在浏览器开发者工具中打开控制台,然后查看 google.maps.version 的值。
  2. 更新用于加载 API 的脚本标记,并请求旧版本
    例如,如果 google.maps.version 为“3.50.2”,请在脚本标记中使用 v=3.49
    这种临时解决方法仅在有限的时间内有效。

临时解决方法准备就绪后,您将有时间(通常为 3 到 6 个月)更新应用,因此该应用不会再使用未记录或已弃用的功能,并且会将 bug 或 bug 修复纳入考虑范围。

然后,您应该还原到原始脚本标记以加载该 API。

您也可以创建支持请求报告问题

季度动态

Maps JavaScript API 团队每季度发布一个新版本。这种情况发生在 2 月中旬、5 月中旬、8 月中旬和 11 月中旬。下一次更新时间:11 月中旬。 新的每周渠道将提供版本 3.51,届时其他渠道会进行更新。

每周频道更新

每周版本目前指向版本 3.50。

11 月中旬,每周渠道将从 3.50 版更新为 3.51 版。 此时,新版本将包含新功能,移除已弃用的功能和/或引入向后兼容性。更新渠道后,您可能需要测试这些更改。

在整个季度内,新版本将每周更新,并包含新功能、修复 bug 并提升性能。 此操作不会移除已弃用的功能,也不会引入不向后兼容性。

季度频道更新

季度版渠道目前指向版本 3.49。

从 11 月中旬开始,季度频道将从版本 3.49 更新为版本 3.50。更新后,此版本将包含新功能、移除已弃用的功能和/或引入前三个月的向后兼容性。更新渠道后,您可能需要测试这些更改。

在整个季度内,此版本将不再包括新功能、问题修复或性能改进。 此操作不会移除已弃用的功能,也不会引入不向后兼容性。

版本更新

从 11 月中旬开始,系统会滚动版本号,以适应新版本发布。

版本 3.51

我们将于 11 月中旬发布 3.51 版这一新版本。 与 3.50 版相比,此版本将包括新功能、移除已弃用的功能和/或引入向后兼容性。 您应在更改版本号时测试您的应用。

在本季度,新版本将每周更新,并包含新功能、修复 bug 并提升性能。 此操作不会移除已弃用的功能,也不会引入不向后兼容性。

版本 3.50

与版本 3.49 相比,此版本包含新功能,移除了已弃用的功能和/或引入了向后兼容性。 您应在更改版本号时测试您的应用。

11 月中旬之后,此版本将不再包含新功能、修复 bug 或提升性能。 此操作不会移除已弃用的功能,也不会引入不向后兼容性。

版本 3.49

与版本 3.48 相比,此版本增加了新功能,移除了已弃用的功能和/或引入了向后兼容性。 您应在更改版本号时测试您的应用。

此版本将不再包含新功能、问题修复或性能改进。 它不会移除此版本已弃用的功能,也不会引入新的向后不兼容性。

版本 3.48

与版本 3.47 相比,此版本包含新功能,移除了已弃用的功能和/或引入了向后兼容性。 您应在更改版本号时测试您的应用。

此版本将不再包含新功能、问题修复或性能改进。 它不会移除此版本已弃用的功能,也不会引入新的向后不兼容性。

版本 3.47

11 月中旬之后,此版本将被删除,不再使用。 任何尝试加载此版本的操作都将被忽略,而您会收到默认渠道。

版本支持

在任意一个季度,我们都会提供四种版本。上述四种版本均受支持。

版本检查

如需进行调试,请使用 google.maps.version 属性来获取应用中的当前版本的 Maps JavaScript API。 以下代码示例将 API 版本写入浏览器控制台。(如需详细了解浏览器控制台,请参阅在浏览器中检查错误指南。)

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

各 API 版本的文档

开发者指南始终介绍每周版本。

此外,各版本还有单独维护的参考资料: