Time Zone API 總覽

Time Zone API 服務接受 HTTP 要求 經緯度座標以及所選日期和時間。其會傳回時間 位置的區域資料,包括世界標準時間和日光節約時間的偏移量 讓應用程式從可以最快做出回應的位置 回應使用者要求

使用 Time Zone API 的原因

透過 Time Zone API,您可以開發應用程式 特定地區的日期和時間的時區 ID 和名稱 。舉例來說,您可以顯示下列時區資料:

  • Google 地圖平台中地圖位置的本地化時區名稱。
  • 時區與世界標準時間的偏移值,以及日光節約時間。

如果您希望網站或應用程式顯示與使用者相關的時間資料,時區資料就特別實用。

Time Zone API 的用途

您可以使用 Time Zone API 要求地球表面上各個位置的時區,以及這些位置相對於世界標準時間的時間偏移量,以及夏令時間。

Time Zone API 的運作方式

時區 API 會接受經緯度座標的 HTTPS 要求、所需日期和時間做為時間戳記,以及選用的語言代碼。並以要求指定的格式傳回資料。 以下範例顯示美國內華達州的資料要求,並要求以 JSON 格式傳回輸出內容。

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY
  

資源

下表概略說明透過 Time Zone API 可用的資源,以及該 API 傳回的資料。

資料資源 傳回的資料 傳回格式
時區

提出要求時,請一併提供位置和時間戳記。請參閱必要參數

  • 時區 ID。
  • 時區名稱 (選用本地化)
  • 與世界標準時間的偏移量 (以秒為單位)
  • 夏令時間的偏移量 (以秒為單位)
  • 如需具體回應範例,請參閱「時區」。
  • JSON
  • XML

如何使用 Time Zone API

1 做好準備 請先設定 Google Cloud 專案,然後完成後續的設定說明。
2 嘗試使用時區要求 取得 API 金鑰後,您就可以直接透過瀏覽器測試 Time Zone API。詳情請參閱「時區要求和回應」指南中的「時區範例」。
3 瞭解回覆的基本概念 瞭解如何在應用程式或網站中使用時區資料。 查看時區回應
5 將時區資料加入自己的應用程式! 您可以使用時區資料,為不同時區的使用者改善應用程式和網站。

可用的用戶端程式庫

如要呼叫這個 API,請使用 從以下用戶端程式庫中擇一:

Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據 Apache 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端或相關貢獻項目,並查看安裝操作說明和程式碼範例。

後續步驟