Time Zone API 總覽

Time Zone API 服務接受 HTTP 要求 經緯度座標以及所選日期和時間。其會傳回時間 位置的區域資料,包括世界標準時間和日光節約時間的偏移量 讓應用程式從可以最快做出回應的位置 回應使用者要求

使用 Time Zone API 的原因

透過 Time Zone 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=1733428634
    &key=YOUR_API_KEY
  

資源

下表概略說明透過 Time Zone API 可用的資源,以及該 API 傳回的資料。

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

提出要求時,請一併提供位置和時間戳記。請參閱必要參數

  • 時區 ID。
  • 時區名稱 (選用本地化)
  • 與世界標準時間的偏移量 (以秒為單位)