Time Zone API 概览

Time Zone API 是一项服务，可接受 纬度/经度坐标和所需的日期和时间。它会返回 该位置的时区数据，包括世界协调时间 (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 下载它们，您还可以在 GitHub 上找到安装说明和示例代码。

后续步骤