時區 API 可提供地表位置的時差資料。要求特定經緯度配對和日期的時區資訊。 API 會傳回該時區的名稱、與世界標準時間的時差,以及日光節約時間的時差。
要求和回應範例
透過 HTTPS 介面存取 Time Zone API,並使用緯度/經度座標建構要求做為網址字串,以指定 location、使用 timestamp 指定日期,以及提供 API 金鑰。
以下查詢會對美國內華達州提出時區要求。時間戳記設為 2012 年 3 月 8 日。
網址
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
如要測試,請在網頁瀏覽器中輸入網址 (請務必將 YOUR_API_KEY 替換成實際的 API 金鑰)。
回應會包含指定地點和日期的時區資料 (timestamp)。
如要進一步瞭解如何 建構要求網址和可用參數,以及 解讀回應,請參閱開發人員指南。
以下是 JSON 格式的回應範例:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
使用用戶端程式庫開始編寫程式碼
用戶端程式庫提供常見工作的簡單原生實作項目,例如驗證、要求節流和自動重試,因此可讓您更輕鬆地使用 Google 地圖網路服務 API 進行開發。時區 API 適用於 Google 地圖服務適用的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端。
驗證、配額、定價和政策
驗證
如要使用 Time Zone API,請先啟用 API 並取得適當的驗證憑證。詳情請參閱「開始使用 Google 地圖平台」一文。
配額與價格
如要瞭解 Time Zone API 的配額和定價,請參閱用量與計費頁面。
政策
使用 Time Zone API 時,必須遵守 API 政策。
瞭解詳情
在時區 API 中,您也可以設定語言參數,傳回非預設語言 (英文) 的結果。如需更多範例和其他詳細資料,請參閱 時區 API 開發人員指南。
時區 API 開發人員指南適用於網站和行動應用程式開發人員,他們想在 Google 地圖平台 API 提供的地圖中加入時間資料。這份文件會簡介如何使用 API,並提供可用參數的參考資料。