Time Zone API 總覽

時區 API 是一項服務，可接受經緯度座標和所選日期/時間的 HTTP 要求。傳回位置的時區資料，包括世界標準時間和日光節約時間的偏移量。

使用 Time Zone API 的好處

您可以使用時區 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 用戶端都是社群支援的用戶端程式庫，並依據阿帕契 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端或相關貢獻項目，並查看安裝操作說明和程式碼範例。

後續步驟