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 接受 HTTP 要求,包括經緯度座標、以所需日期與時間做為時間戳記,以及視需要提供的語言代碼。系統會以要求指定的格式傳回資料。以下範例顯示美國內華達州的要求,並以 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 下載,您也可以在此找到安裝指示和程式碼範例。

後續步驟