Time Zone API 總覽

Time Zone API 服務接受 HTTP 要求 經緯度座標以及所需的日期和時間。其會傳回時間 位置的區域資料，包括世界標準時間和日光節約時間的偏移量 。

使用 Time Zone API 的好處

透過 Time Zone API，您可以開發應用程式 特定地區的日期和時間的時區 ID 和名稱 。例如，您可以顯示下列內容： 時區資料：

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

如果您想查看 網站或應用程式會根據時間顯示與使用者相關的資料。

Time Zone API 的用途

使用 Time Zone API 時 分別在地球表面的位置和 世界標準時間和日光節約時間 這些位置

Time Zone API 的運作方式

Time Zone 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 和其傳回的資料。

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

提出要求時，請一併提供位置和時間戳記。詳情請見 必要 參數

  • 時區 ID。
  • 時區名稱 (選用本地化)
  • 與世界標準時間的時差 (以秒為單位)
  • DST 的偏移量 (以秒為單位)
  • 如需具體回應範例，請參閱「時區」。
  • 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 下載這些範例，也可以在其中找到安裝操作說明和程式碼範例。

後續步驟