開始使用

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=1733428634
  &key=YOUR_API_KEY

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 格式的回應範例：

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

<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 中，您也可以設定語言參數，以便以預設的英文以外的語言傳回結果。如需更多範例和其他詳細資訊，請參閱 時區 API 開發人員指南。

時區 API 開發人員指南適用於希望在 Google 地圖平台 API 提供的地圖上加入時間資料的網站和行動應用程式開發人員。這篇文章將介紹如何使用 API，並提供可用參數的參考資料。