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 ×tamp=1331161200 &key=YOUR_API_KEY
資源
下表概略說明透過 Time Zone API 可用的資源,以及該 API 傳回的資料。
資料資源 | 傳回的資料 | 傳回格式 |
---|---|---|
時區
提出要求時,請一併提供位置和時間戳記。請參閱必要參數。 |
|
|
如何使用 Time Zone API
1 | 做好準備 | 請先設定 Google Cloud 專案,然後完成後續的設定說明。 |
2 | 嘗試使用時區要求 | 取得 API 金鑰後,您就可以直接透過瀏覽器測試 Time Zone API。詳情請參閱「時區要求和回應」指南中的「時區範例」。 |
3 | 瞭解回覆的基本概念 | 瞭解如何在應用程式或網站中使用時區資料。 查看時區回應 。 |
5 | 將時區資料加入自己的應用程式! | 您可以使用時區資料,為不同時區的使用者改善應用程式和網站。 |
可用的用戶端程式庫
如要呼叫這個 API,請使用 從以下用戶端程式庫中擇一:
Google 地圖服務適用的 Java、Python、Go 和 Node.js 用戶端都是社群支援的用戶端程式庫,並依據 Apache 2.0 授權的條款提供開放原始碼。您可以從 GitHub 下載這些用戶端或相關貢獻項目,並查看安裝操作說明和程式碼範例。
後續步驟
- 瞭解如何提出時區要求:請參閱「時區要求和回應」一文。
- 遵循最佳做法:請參閱Web 服務最佳做法。