Time Zone API 概览

Time Zone API 服务可接受纬度/经度坐标的 HTTP 请求以及所需的日期和时间。它返回该位置的时区数据，包括世界协调时间 (UTC) 的偏移量和夏令时。

为何要使用 Time Zone API

借助 Time Zone API，您可以开发为地图上的特定位置提供时区 ID 和时间的应用。例如，您可以显示以下时区数据：

  • Google Maps Platform 中地图位置的本地化时区名称。
  • 时区与世界协调时间 (UTC) 的时差，以及夏令时。

如果您希望网站或应用显示基于用户的时间数据，时区数据会特别有用。

Time Zone API 的用途

借助 Time Zone API，您可以请求地球表面各个位置的时区，同时设置当地时间与世界协调时间 (UTC) 的时差，以及各个位置对应夏令时。

Time Zone API 的工作原理

Time Zone API 接受纬度/经度坐标的 HTTPS 请求、所需的时间戳作为时间戳以及（可选）语言代码。它以请求指定的格式返回数据。以下示例展示了针对美国内华达州的请求，以及 JSON 格式的请求输出。

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY

资源

下表汇总了 Time Zone API 提供的资源及其返回的数据。

数据资源 返回的数据 返回格式
时区

您需要提供请求以及位置信息和时间戳。请参阅必需参数。

  • 时区 ID。
  • 时区名称（可选本地化）
  • 相对于世界协调时间 (UTC) 的偏移量（以秒为单位）
  • DST 的偏移量（以秒为单位）
  • 有关具体响应示例，请参阅“时区”。
  • JSON
  • XML

如何使用 Time Zone API

1 开始设置 从设置 Google Cloud 项目开始，完成后面的设置说明即可。
2 尝试提交时区请求 拥有 API 密钥后，您就可以直接通过浏览器开始测试 Time Zone API。如需了解详情，请参阅时区请求和响应指南中的时区示例。
3 了解回复基础知识 了解如何在您的应用或网站中使用时区数据。 如需了解详情，请参阅时区响应 。
5 将时区数据整合到您自己的应用中！ 您可以使用时区数据，为基于不同时间的语言区域的用户增强应用和网站。

可用的客户端库

通过以下客户端库之一，以您选择的语言调用此 API：

适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端是由社区提供支持的客户端库，并且根据 Apache 2.0 许可开放源代码。您可以从 GitHub 下载这些文件，也可以在其中找到安装说明和示例代码。

后续步骤