開始使用

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

curl

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 格式的回應:

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 地圖平台」一文。

配額和價格資訊

如要進一步瞭解 Time Zone API 的配額和定價,請參閱「用量與計費」。

政策

使用 Time Zone API 時,必須遵守 API 政策。

瞭解詳情

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

Time Zone API 開發人員指南可協助網站和行動開發人員,在 Google Maps Platform API 提供的地圖上加入時區資料。其中包含 API 使用方式簡介,以及可用參數的參考資料。