開始使用

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 Maps 網路服務 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 地圖平台 API 所提供的地圖時間資料。本文介紹如何使用 API,以及可用參數的參考資料。