
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 ×tamp=1733428634 &key=YOUR_API_KEY
資源
下表匯總 Time Zone 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 下載,也可以在 GitHub 找到安裝操作說明和程式碼範例。
後續步驟
- 瞭解如何提出 Time Zone 要求:請參閱「Time Zone 要求和回應」。
- 遵循最佳做法:請參閱「Web 服務最佳做法」。