開始使用

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Time Zone API 可針對地球表面上的位置提供時區偏移資料。要求特定經緯度組合和日期的時區資訊。API 會傳回該時區的名稱、與世界標準時間相差的時間,以及日光節約時間。

要求與回應範例

透過 HTTPS 介面存取 Time Zone API,將要求建構為網址字串,並使用經緯度座標來指定 locationtimestamp 來指定日期,以及您的 API 金鑰。

以下查詢會針對美國內華達州執行時區要求。時間戳記已設為 2012 年 3 月 8 日。

網址

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

郵報

OpenAPI 規格也提供 Postman 集合。

在 Postman 中執行

如要測試,請在網路瀏覽器中輸入網址 (請務必將 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 Maps Web Services API,讓您輕鬆進行開發作業。Time Zone API 適用於適用於 Google 地圖服務的 Java 用戶端、Python 用戶端、Go 用戶端和 Node.js 用戶端

驗證、配額、定價與政策

驗證

如要使用 Time Zone API,您必須先啟用 API 並取得適當的驗證憑證。如想進一步瞭解相關詳情,請參閱「開始使用 Google 地圖平台」一文。

配額和價格資訊

請參閱用量和計費頁面,進一步瞭解 Time Zone API 所設的配額與定價。

政策

使用 Time Zone API 時,必須遵守 API 政策

瞭解詳情

在 Time Zone API 中,您也可以設定語言參數,以英文以外的語言傳回結果。如需更多範例和其他詳細資料,請參閱 Time Zone API 開發人員指南

網站和開發人員開發人員可利用 Time Zone API 開發人員指南,瞭解如何針對使用 Google Maps Platform API 的地圖,納入時間資料。本文介紹如何使用 API 和可用參數的參考資源。