Time Zone API – Übersicht

Die Time Zone API ist ein Dienst, der eine HTTP-Anfrage mit Breiten- und Längengradkoordinaten sowie ein gewünschtes Datum und eine gewünschte Uhrzeit akzeptiert. Es werden die Zeitzonendaten für den Standort zurückgegeben, einschließlich Offsets für die UTC- und Sommerzeit.

Vorteile der Time Zone API

Mit der Time Zone API können Sie Anwendungen entwickeln, die die Zeitzonen-ID und den Namen für Datum und Uhrzeit an bestimmten Standorten auf einer Karte angeben. Sie können beispielsweise die folgenden Zeitzonendaten anzeigen lassen:

  • Lokalisierte Zeitzonennamen für Kartenstandorte aus der Google Maps Platform.
  • Zeitzonen-Offsets von UTC und für Sommerzeit.

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

Möglichkeiten mit der Time Zone API

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

Funktionsweise der Time Zone API

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

 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 sind die über die Time Zone API verfügbaren Ressourcen sowie die zurückgegebenen Daten zusammengefasst.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Zeitzone

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

  • Zeitzonen-ID.
  • Name der Zeitzone, optional lokalisiert
  • Zeitversatz von UTC in Sekunden
  • Offset für die Sommerzeit in Sekunden
  • Beispiele für bestimmte 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 zur Einrichtung.
2 Eine Zeitzonenanfrage ausprobieren Sobald du einen API-Schlüssel hast, kannst du die Time Zone API direkt im Browser testen. Weitere Informationen finden Sie unter Beispiele für Zeitzonen im Leitfaden zu Zeitzonenanfragen und -antworten.
3 Grundlegende Informationen zu Antworten Hier erfahren Sie, wie Sie Zeitzonendaten in Ihrer App oder auf Ihrer Website verwenden. Weitere Informationen finden Sie unter Zeitzonenantworten .
5 Binden Sie Zeitzonendaten in Ihre eigene App ein! Mithilfe von Zeitzonendaten kannst du Apps und Websites für Nutzer in verschiedenen zeitbasierten Sprachen optimieren.

Verfügbare Clientbibliotheken

Rufen Sie diese API in einer beliebigen Sprache über eine der folgenden Clientbibliotheken auf:

Der Java-Client, Python-Client, Go-Client und Node.js-Client 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 stehen. Laden Sie sie von GitHub herunter. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte