Jetzt starten

Die Time Zone API bietet Zeitverschiebungsdaten für Orte auf der Erdoberfläche. Fordern Sie die Zeitzoneninformationen für ein bestimmtes Paar aus Breiten- und Längengrad an. Die API gibt den Namen dieser Zeitzone, die Zeitverschiebung von UTC und die Sommerzeit zurück.

Beispielanforderung und -antwort

Greifen Sie über eine HTTPS-Schnittstelle auf die Time Zone API zu. Dabei werden Anfragen als URL-String erstellt. Dabei werden die Koordinaten (Breiten- und Längengrad) für location, timestamp für das Datum und Ihr API-Schlüssel verwendet.

Durch die folgende Abfrage wird eine Zeitzonenanforderung für Nevada, USA, durchgeführt. Der Zeitstempel ist auf den 8. März 2012 festgelegt.

URL

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))
}

Postbote

Die OpenAPI-Spezifikation ist auch als Postman-Sammlung verfügbar.

In Postman ausführen

Du kannst dies testen, indem du die URL in deinen Webbrowser eingibst. Achte dabei darauf, YOUR_API_KEY durch deinen tatsächlichen API-Schlüssel zu ersetzen. Die Antwort enthält die Zeitzonendaten für den angegebenen Standort und das Datum (timestamp).

Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern und zum Verstehen der Antwort finden Sie im Entwicklerleitfaden.

Nachfolgend ist ein Antwortbeispiel im JSON-Format aufgeführt:

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>

Codierung mit unseren Clientbibliotheken

Die Clientbibliotheken vereinfachen die Entwicklung mit den Google Maps-Webdienst-APIs und bieten einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Anfragedrosselung und automatischer Wiederholungsversuch. Die Time Zone API ist im Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.

Authentifizierung, Kontingente, Preise und Richtlinien

Authentifizierung

Damit Sie die Time Zone API verwenden können, müssen Sie zuerst die API aktivieren und die entsprechenden Authentifizierungsdaten abrufen. Weitere Informationen findest du unter Erste Schritte mit der Google Maps Platform.

Kontingente und Preise

Details zu Kontingenten und Preisen für die Time Zone API finden Sie auf der Seite Nutzung und Abrechnung.

Richtlinien

Die Time Zone API muss den API-Richtlinien entsprechen.

Weitere Informationen

In der Time Zone API können Sie auch einen Sprachparameter festlegen, um Ergebnisse in anderen Sprachen als der Standardsprache zu erhalten. Weitere Beispiele und Informationen findest du im Time Zone API-Entwicklerleitfaden.

Der Entwicklerleitfaden für die Time Zone API richtet sich an Entwickler von Websites und mobilen Apps, die Zeitdaten auf Karten einfügen möchten, die über eine der Google Maps Platform APIs bereitgestellt werden. Sie enthält eine Einführung in die Verwendung der API und des Referenzmaterials zu den verfügbaren Parametern.