![Timezone API 概览](https://developers.google.cn/static/maps/images/landing/places-api_480.png?authuser=5&hl=da)
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 ×tamp=1331161200 &key=YOUR_API_KEY
资源
下表总结了 Time Zone API 及其返回的数据。
数据资源 | 返回的数据 | 返回格式 |
---|---|---|
时区
您需提供请求以及位置和时间戳。请参阅 必需 参数。 |
|
|
如何使用 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 上找到安装说明和示例代码。