开始使用

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

示例请求和响应

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

以下查询请求的是美国内华达州的时区。时间戳设置为 2012 年 3 月 8 日。

网址

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

cURL

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

您可以通过在网络浏览器中输入网址来测试此 API(请务必将 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 地图网络服务 API 的开发工作。Time Zone API 在适用于 Google 地图服务的 Java 客户端、Python 客户端、Go 客户端和 Node.js 客户端中提供。

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

身份验证

如需使用 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,并提供了有关可用参数的参考资料。