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
×tamp=1331161200
&key=YOUR_API_KEY
资源
下表总结了
Time Zone API 及其返回的数据。
数据资源 |
返回的数据 |
返回格式 |
时区
您需提供请求以及位置和时间戳。请参阅
必需
参数。
|
- 时区 ID。
- 时区名称(可选择进行本地化)
- 世界协调时间 (UTC) 的偏移量(以秒为单位)
- DST 的偏移量(以秒为单位)
- 有关具体响应示例,请参阅“时区”。
|
|
如何使用 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 上找到安装说明和示例代码。
后续步骤
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-20。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u6700\u540e\u66f4\u65b0\u65f6\u95f4 (UTC)\uff1a2024-09-20\u3002"}
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2024-09-20。"]]