开始使用

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=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'

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

查看开发者指南 如需详细了解 <ph type="x-smartling-placeholder"></ph> 构建请求网址和可用参数 和 理解响应内容。

下面是一个 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>

使用客户端库编码入门指南

客户端库通过提供简单、 常见任务的原生实现，例如身份验证、请求 限制和自动重试。Time Zone API 已推出 在 Java 客户端 适用于 Google 地图服务的 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 的使用方法以及可用的 参数。