
Die Time Zone API ist ein Dienst, der eine HTTP-Anfrage mit Breiten- und Längengradkoordinaten sowie einem ausgewählten Datum und einer ausgewählten Uhrzeit akzeptiert. Sie gibt die Zeitzonendaten für den Standort zurück, einschließlich der Zeitunterschiede zu 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 Datums- und Uhrzeitangaben an bestimmten Orten auf einer Karte bereitstellen. Sie können beispielsweise die folgenden Zeitzonendaten anzeigen:
- Lokalisierte Zeitzonennamen für Kartenstandorte aus der Google Maps Platform.
- Zeitzonenversatz zu UTC und für die Sommerzeit.
Zeitzonendaten sind besonders nützlich, wenn Sie auf Ihrer Website oder in Ihrer App zeitbasierte Daten anzeigen möchten, die für die Nutzer Ihrer Anwendung 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 anfordern, einschließlich des zeitlichen Versatzes zur UTC und der Sommerzeit für jeden dieser Orte.
Funktionsweise der Time Zone API
Die Time Zone API akzeptiert eine HTTPS-Anfrage mit Breiten- und Längengradkoordinaten, dem ausgewählten Datum und der ausgewählten Uhrzeit als Zeitstempel und optional einem Sprachcode. Die Daten werden 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 ×tamp=1733428634 &key=YOUR_API_KEY
Ressourcen
In der folgenden Tabelle sind die über die Time Zone API verfügbaren Ressourcen und die zurückgegebenen Daten zusammengefasst:
| Datenressourcen | Zurückgegebene Daten | Rückgabeformat |
|---|---|---|
| Zeitzone
Sie stellen Ihre Anfrage zusammen mit Standort und Zeitstempel. Siehe erforderliche Parameter. |
|
|
Time Zone API verwenden
| 1 | Einrichten | Beginnen Sie mit Google Cloud-Projekt einrichten und folgen Sie der Einrichtungsanleitung. |
| 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 Time Zone Requests and Responses unter Time Zone Examples. |
| 3 | Grundlagen zu Antworten | Hier erfahren Sie, wie Sie Zeitzonendaten in Ihrer App oder auf Ihrer Website verwenden können. Weitere Informationen finden Sie unter Time Zone-Antworten. |
| 5 | Zeitzonendaten in Ihre eigene App einbinden | Sie können Zeitzonendaten verwenden, um Apps und Websites für verschiedene zeitbasierte Regionen zu optimieren. |
Verfügbare Clientbibliotheken
Rufen Sie diese API in der Sprache Ihrer Wahl über eine der folgenden Clientbibliotheken auf:
- Java-Client für Google Maps-Dienste
- Python-Client für Google Maps-Dienste
- Go-Client für Google Maps-Dienste
- Node.js-Client für Google Maps-Dienste
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 Installationsanleitungen und Beispielcode.
Nächste Schritte
- Informationen zum Senden von Time Zone-Anfragen: Weitere Informationen finden Sie unter Time Zone-Anfragen und -Antworten.
- Best Practices befolgen: Weitere Informationen finden Sie unter Best Practices für Webdienste.