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 下载,您还可以在这里找到安装说明和示例代码。

后续步骤