開始使用

Time Zone API 提供地表上的地點時間偏移資料。要求取得特定經緯度組合的時區資訊。API 會傳回該時區的名稱、以世界標準時間為準的時間偏移，以及日光節約偏移。

要求與回應範例

透過 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) 的時區資料。

請參閱開發人員指南，進一步瞭解如何 建立要求網址和可用參數和 瞭解回應。

以下是採用 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 進行開發。Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端提供 Time Zone API。

驗證、配額、定價和政策

驗證

如要使用 Time Zone API，您必須先啟用 API 並取得適當的驗證憑證。詳情請參閱「開始使用 Google 地圖平台」一文。

配額與價格

如要進一步瞭解 Time Zone API 設定的配額與定價，請參閱用量與計費頁面。

政策

使用 Time Zone API 時，必須遵守 API 政策的規定。

瞭解詳情

在 Time Zone API 中，您也可以設定語言參數，讓系統傳回英文預設值以外的結果。如需更多範例和其他詳細資訊，請參閱 Time Zone API 開發人員指南。

Time Zone API 開發人員指南適用於網站和行動開發人員，可納入 Google 地圖平台 API 所提供的地圖資料。並介紹使用 API 以及參考可用參數的參考資料。