Time Zone API – Übersicht

Die Time Zone API ist ein Dienst, der eine HTTP-Anfrage mit Koordinaten für Breiten- und Längengrad sowie einem gewünschten Datum und einer gewünschten Uhrzeit akzeptiert. Die Funktion gibt die Zeitzonendaten für den Ort zurück, einschließlich der Zeitverschiebung bezüglich UTC und Sommerzeit.

Vorteile der Time Zone API

Mit der Time Zone API können Sie Anwendungen entwickeln, bei denen die Zeitzonen-ID und der Name für Datum und Uhrzeit an bestimmten Orten auf einer Karte angegeben werden. Sie können beispielsweise die folgenden Zeitzonendaten anzeigen lassen:

  • Lokalisierte Zeitzonennamen für Kartenstandorte aus der Google Maps Platform.
  • Zeitzonenverschiebungen gegenüber UTC und für die Sommerzeit.

Zeitzonendaten sind besonders nützlich, wenn auf Ihrer Website oder in Ihrer App zeitbasierte Daten angezeigt werden sollen, die für Nutzer relevant sind.

Möglichkeiten mit der Time Zone API

Mit der Time Zone API können Sie die Zeitzone für Orte auf der Erdoberfläche mit der Zeitverschiebung zur UTC und die Sommerzeit für jeden dieser Orte anfordern.

Funktionsweise der Time Zone API

Die Time Zone API akzeptiert eine HTTPS-Anfrage mit Breiten-/Längengradkoordinaten, dem gewünschten Datum und der gewünschten Uhrzeit als Zeitstempel und optional einem Sprachcode. Sie gibt Daten in dem von der Anfrage angegebenen Format zurück. Das folgende Beispiel zeigt eine Anfrage für Nevada, USA, mit einer angeforderten JSON-Ausgabe.

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

Ressourcen

In der folgenden Tabelle werden die über die Time Zone API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Zeitzone

Sie geben Ihre Anfrage zusammen mit Ort und Zeitstempel an. Siehe erforderliche Parameter.

  • Zeitzonen-ID.
  • Zeitzonenname, optional lokalisiert
  • Zeitunterschied zur UTC in Sekunden
  • Sommerzeitunterschied in Sekunden
  • Beispiele für spezifische Antworten finden Sie unter „Zeitzone“.
  • JSON
  • XML

Time Zone API verwenden

1 Jetzt einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung für die Einrichtung.
2 Zeitzonenanfrage verwenden Sobald Sie einen API-Schlüssel haben, können Sie die Time Zone API direkt über Ihren Browser testen. Weitere Informationen finden Sie im Leitfaden zu Zeitzonenanfragen und -antworten unter Beispiele für Zeitzonen.
3 Grundlagen zu Antworten Erfahren Sie, wie Sie Zeitzonendaten in Ihrer App oder auf Ihrer Website verwenden können. Weitere Informationen finden Sie unter Zeitzonenantworten .
5 Zeitzonendaten in Ihre App einbinden Mithilfe von Zeitzonendaten können Sie Apps und Websites für Nutzer in verschiedenen zeitbasierten Sprachen optimieren.

Verfügbare Clientbibliotheken

Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:

Die Java-, Python-, Go- und Node.js-Clients für Google Maps-Dienste sind von der Community unterstützte Clientbibliotheken, die unter der Apache 2.0-Lizenz als Open Source zur Verfügung gestellt werden. Laden Sie sie von GitHub herunter. Dort finden Sie auch eine Installationsanleitung und Beispielcode.

Nächste Schritte