API 更新

杨竹青

http://ditu.google.com/maps?file=api&v=2 网址中的 v 参数表示 Google 地图 API 使用的版本号。 多数API用户可能想通过在该网址中传递 v=2 参数而使用当前“版本 2”API。您可以通过传递 v=2.x 获取最新版本（包含最新功能）。但是，注意最新版本可能不如 v=2 版本可靠。我们经常更新 Google 地图 API（有时每周更新一次），当前 v=2.x 版本中的功能已迁移到 v=2 版本（除非发现问题）。

此外，还可以通过传递 v=2.s 参数使用 API 的“稳定”版本。此版本更新频率较低，大约每几个月更新一次。由于 v=2 和 v=2.x 版本大约每两周更新一次，一些开发人员更喜欢使用稳定的 v=2.s。请注意稳定版本可能比当前版本落后几个版本，因此也许不包含一些最新功能。

我们更新 API 时，其版本都会更新（例如“版本 2.76”）。当我们更新 API 时，基于先前版本的较旧代码可能偶尔会和声明的行为方式不同。如果一定需要将应用程序绑定在特定的 API 版本上，可以通过在 v 参数中明确包含该版本而执行此操作（例如，v=2.75）。但不建议这样做。将您的产品基于最新代码始终是最佳选择。

当将来对 API 进行重大更新时，我们将更改主版本号，并在 Google 代码和地图 API 开发人员论坛上发布声明。当发生这种情况时，我们期望同时支持这两个版本至少一个月，以允许您迁移代码。

地图团队还使用最新的错误修订和性能增强功能透明地更新 API。这些错误修订只会提高性能和修订错误，但我们可能会意外损坏某些 API 客户端。请使用地图 API 开发人员论坛报告此类问题。