Time Zone API – Übersicht

Die Time Zone API ist ein Dienst, der die HTTP-Anfrage Längen- und Breitengrade sowie ein Datum und eine Uhrzeit ausgewählt. Sie gibt die Uhrzeit zurück, Zonendaten für den Standort, einschließlich Offsets 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. Sie können beispielsweise Folgendes anzeigen: Zeitzonendaten:

  • Lokalisierte Zeitzonennamen für Kartenstandorte aus der Google Maps Platform.
  • Zeitzonenunterschiede zur koordinierten Weltzeit (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.

Was Sie mit der Time Zone API tun können

Mit der Time Zone API können Sie die Zeitzone für Orte auf der Erdoberfläche anfordern, einschließlich des Zeitversatzes von UTC und der Sommerzeit für jeden dieser Orte.

Funktionsweise der Time Zone API

Die Time Zone API akzeptiert HTTPS-Anfragen für Breiten- und Längengrade. -Koordinaten, das gewünschte Datum und die gewünschte Uhrzeit als Zeitstempel und optional Sprachcode. Es werden Daten im in der Anfrage angegebenen Format zurückgegeben. 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 Ressourcen aufgeführt, die über die Time Zone API zusammen mit den zurückgegebenen Daten an.

Datenressourcen Zurückgegebene Daten Rückgabeformat
Zeitzone

Sie geben Ihre Anfrage zusammen mit dem Standort und dem Zeitstempel an. Weitere Informationen finden Sie unter erforderlich Parameter.

  • Zeitzonen-ID.
  • Zeitzonenname, optional lokalisiert
  • Zeitversatz zu UTC in Sekunden
  • Abweichung für die Sommerzeit in Sekunden
  • Spezielle Antwortbeispiele finden Sie unter „Time Zone“ (Zeitzone).
  • JSON
  • XML

Time Zone API verwenden

1 Einrichten Beginnen Sie mit Das Google Cloud-Projekt und schließen Sie die Einrichtung ab. befolgen Sie die Anleitung.
2 Zeitzonen-Anfrage ausprobieren Sobald Sie einen API-Schlüssel haben, können Sie die Time Zone API direkt von hier aus testen: in Ihrem Browser. Beispiele für Zeitzonen Weitere Informationen finden Sie im Leitfaden Zeitzonenanfragen und -antworten.
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:

Java-, Python-, Go- und Node.js-Client für Google Maps Dienste sind von der Community unterstützte Clientbibliotheken, die im Rahmen der Apache 2.0-Lizenz. Sie können sie auf GitHub herunterladen. Dort finden Sie auch Installationsanleitungen und Beispielcode.

Nächste Schritte