Time Zone API 總覽

Time Zone API 服務可接受緯度/經度座標的 HTTP 要求，以及所需的日期和時間。它會傳回該位置的時區資料，包括世界標準時間 (UTC) 和日光節約時間。

使用 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 用戶端都是社群支援的用戶端程式庫，並依據阿帕契 2.0 授權的條款提供開放原始碼。 您可以從 GitHub 下載，或參考安裝指示和程式碼範例。

後續步驟