Die Zeitzonen-API liefert Zeitverschiebungsdaten für Orte auf der Erdoberfläche. Fordern Sie die Zeitzoneninformationen für ein bestimmtes Breiten-/Längenpaar und Datum an. Die API gibt den Namen der Zeitzone, die Zeitverschiebung von UTC und die Sommerzeitverschiebung zurück.

Beispielanforderung und -antwort

Zugriff auf die Zeitzonen-API über eine HTTPS-Schnittstelle, wobei die Anforderungen als URL-Zeichenfolge konstruiert sind und Breitengrad/Längengrad-Koordinaten zur Angabe des location, ein timestamp zur Angabe des Datums und Ihren API-Schlüssel verwenden.

Das folgende Beispiel fordert die Zeitzonendaten für Washington, DC, USA, am 15. März 2016 im JSON-Format an:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Sie können dies testen, indem Sie die URL in Ihren Webbrowser eingeben (achten Sie darauf, YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel zu ersetzen). Die Antwort enthält die Zeitzonendaten für den angegebenen Ort und das Datum (timestamp).

Weitere Informationen zur Erstellung von Anfrage-URLs und verfügbaren Parametern sowie zum Verständnis der Antwort finden Sie im Entwicklerhandbuch.

Nachfolgend finden Sie eine Beispielantwort in JSON:

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Starten Sie die Codierung mit unseren Client-Bibliotheken

Client-Bibliotheken erleichtern die Entwicklung mit den Google Maps-Webdienst-APIs, indem sie einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Anfragebeschränkung und automatische Wiederholung bereitstellen. Die Zeitzonen-API ist im Java-Client, Python-Client, Go-Client und Node.js-Client für Google Maps Services verfügbar.

Authentifizierung, Kontingente, Preise und Richtlinien

Authentifizierung

Um die Zeitzonen-API zu verwenden, müssen Sie die API zunächst aktivieren und die richtigen Authentifizierungsdaten erhalten. Weitere Informationen finden Sie unter Erste Schritte mit Google Maps Platform.

Kontingente und Preise

Auf der Seite Nutzung und Abrechnung finden Sie Details zu den Kontingenten und Preisen für die Zeitzonen-API.

Richtlinien

Die Verwendung der Zeitzonen-API muss mit den API-Richtlinien übereinstimmen.

Weiteres

In der Zeitzonen-API können Sie auch einen Sprachparameter festlegen, um Ergebnisse in anderen Sprachen als der Standardsprache Englisch zurückzugeben. Weitere Beispiele und Details finden Sie im Time Zone API Developer Guide.