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=1733428634
    &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 下載這些用戶端或相關貢獻項目，並查看安裝操作說明和程式碼範例。

後續步驟