Time Zone API – Übersicht

Die Zeitzonen-API ist ein Dienst, der eine HTTP-Anfrage mit Breiten-/Längengradkoordinaten und einem ausgewählten Datum und einer ausgewählten Uhrzeit akzeptiert. Es werden die Zeitzonendaten für den Standort zurückgegeben, einschließlich der Zeitverschiebungen für UTC und Sommerzeit.

Vorteile der Time Zone API

Mit der Zeitzonen-API können Sie Anwendungen entwickeln, die die Zeitzonen-ID und den Namen für Datum und Uhrzeit an bestimmten Orten auf einer Karte bereitstellen. Beispielsweise können die folgenden Zeitzonendaten angezeigt werden:

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

Daten zur Zeitzone sind besonders nützlich, wenn Sie auf Ihrer Website oder in Ihrer App zeitbasierte Daten anzeigen lassen möchten, 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 Orte auf der Erdoberfläche mit einem Zeitversatz zur UTC und zur Sommerzeit für jeden dieser Standorte anfordern.

Funktionsweise der Time Zone API

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

 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 und die zurückgegebenen Daten aufgeführt.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Zeitzone

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

  • Zeitzonen-ID.
  • Zeitzonenname, optional lokalisiert
  • Zeitversatz zu UTC in Sekunden
  • Sommerzeit-Offset in Sekunden
  • Unter „Zeitzone“ finden Sie konkrete Antwortbeispiele.
  • JSON
  • XML

Verwendung der Time Zone API

1 Einrichten Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Anleitung.
2 Zeitzonenanfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Time Zone API direkt in Ihrem Browser testen. Weitere Informationen finden Sie im Leitfaden Zeitzonenanfragen und ‑antworten unter Beispiele für Zeitzonen.
3 Grundlegendes zu Antworten Informationen zur Verwendung von Zeitzonendaten in Ihrer App oder auf Ihrer Website Weitere Informationen finden Sie unter Antworten zu Zeitzonen .
5 Zeitzonendaten in Ihre eigene App einbinden Sie können Zeitzonendaten verwenden, um Apps und Websites für Nutzer in verschiedenen Zeitzonen zu 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. Sie können sie auf GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte