开始使用

Time Zone API 可提供地球表面各位置的时间偏移数据。请求获取特定经纬度对和日期的时区信息。该 API 会返回该时区的名称、与世界协调时间 (UTC) 的时间偏移值以及夏令时偏移值。

示例请求和响应

通过 HTTPS 接口访问 Time Zone API，请求以网址字符串的形式构建，使用经纬度坐标指定 location，使用 timestamp 指定日期，并提供您的 API 密钥。

以下查询会针对美国内华达州执行时区请求。时间戳设置为 2012 年 3 月 8 日。

网址

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

您可以在网络浏览器中输入该网址，以测试此请求。请务必将 YOUR_API_KEY 替换为您的实际 API 密钥。响应中包含指定位置和日期 (timestamp) 的时区数据。

如需详细了解如何构建请求网址和可用参数以及如何理解响应，请参阅开发者指南。

以下示例展示了 JSON 格式的响应：

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

开始使用客户端库进行编码

客户端库提供常见任务（例如身份验证、请求限制和自动重试）的简单内置实现，从而简化了使用 Google Maps Web Service API 进行开发的过程。Time Zone API 包含在适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端中。

身份验证、配额、价格和政策

身份验证

如需使用 Time Zone API，您必须先启用该 API 并获取适当的身份验证凭证。如需了解详情，请参阅 Google Maps Platform 使用入门。

配额和价格

如需详细了解为 Time Zone API 设置的配额和价格，请参阅用量和结算。

政策

使用 Time Zone API 时，必须遵守 API 政策。

了解详情

在时区 API 中，您还可以设置语言参数，以返回非默认英语的结果。如需查看更多示例和其他详细信息，请参阅 Time Zone API 开发者指南。

Time Zone API 开发者指南可帮助网站和移动开发者在 Google Maps Platform API 提供的地图上添加时间数据。它介绍了如何使用该 API，并提供了有关可用参数的参考资料。