Time Zone API 總覽

Time Zone API 服務可接受經緯度座標和指定日期時間的 HTTP 要求,這項服務會傳回該位置的時區資料,包括世界標準時間 (UTC) 和日光節約時間的時差。

使用 Time Zone API 的好處

您可以使用 Time Zone API 開發應用程式,提供地圖上特定位置的日期和時間時區 ID 和名稱。例如,您可以顯示下列時區資料:

  • Google Maps Platform 中地圖位置的在地化時區名稱。
  • 時區與世界標準時間和日光節約時間的時差。

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

Time Zone API 的用途

您可以使用 Time Zone API,要求地球上各個位置的時區,以及每個位置與世界標準時間 (UTC) 的時間偏移和日光節約時間。

Time Zone API 的運作方式

Time Zone 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 提供的資源,以及傳回的資料:

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

您提供要求,以及位置和時間戳記。請參閱必要參數。

  • 時區 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 下載,也可以在 GitHub 找到安裝操作說明和程式碼範例。

後續步驟