開始使用

Time Zone API 可在 Google 地球。針對特定經緯度組合和日期要求時區資訊。 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'

您可以在網路瀏覽器中輸入網址來進行測試 (請務必將 以您實際的 API 金鑰執行 YOUR_API_KEY)。 回應會包含指定地點和日期的時區資料 (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 用戶端程式庫編寫程式碼

用戶端程式庫可讓開發人員輕鬆使用 Google Maps Web 服務 API 進行開發， 常見任務的原生實作，例如驗證、要求 調節和自動重試。Time Zone API 已可使用 的 Java 用戶端 Google 地圖服務適用的 Python 用戶端、Go Client 和 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 的參考資料 參數。