开始使用

时区 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
  ×tamp=1733428634
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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 地图 Web 服务 API 进行开发。适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端中提供了 Time Zone API。

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

身份验证

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

配额和价格

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

政策

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

了解详情

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

Time Zone API 开发者指南面向的是希望在 Google Maps Platform API 之一提供的地图中添加时间数据的网站和移动应用开发者。其中介绍了如何使用该 API，并提供了有关可用参数的参考资料。