Die Time Zone API bietet Daten zum Zeitversatz für Standorte auf der Erdoberfläche. Zeitzoneninformationen für ein bestimmtes Breiten-/Längengradpaar und Datum anfordern. Die API gibt den Namen der Zeitzone, die Zeitverschiebung von UTC und die Sommerzeitverschiebung zurück.
Beispielanforderung und -antwort
Sie können über eine HTTPS-Schnittstelle auf die Time Zone API zugreifen. Anfragen werden als URL-String erstellt, wobei Breiten-/Längengradkoordinaten zur Angabe des location, ein timestamp zur Angabe des Datums und Ihr API-Schlüssel verwendet werden.
Durch die folgende Abfrage wird eine Zeitzonenanforderung für Nevada, USA, durchgeführt. Der Zeitstempel ist auf den 8. März 2012 festgelegt.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Sie können dies testen, indem Sie die URL in Ihren Webbrowser eingeben. Achten Sie darauf, YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel zu ersetzen.
Die Antwort enthält die Zeitzonendaten für den angegebenen Ort und das angegebene Datum (timestamp).
Weitere Informationen zum Erstellen von Anfrage-URLs und zu verfügbaren Parametern und zum Interpretieren der Antwort finden Sie im Entwicklerhandbuch.
Nachfolgend ist ein Antwortbeispiel im JSON-Format aufgeführt:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Codierung mit unseren Clientbibliotheken
Clientbibliotheken erleichtern die Entwicklung mit den Google Maps Web Service APIs, da sie einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Anforderungsdrosselung und automatische Wiederholungsversuche bieten. Die Time Zone API ist im Java-, Python-, Go- und Node.js-Client für Google Maps-Dienste verfügbar.
Authentifizierung, Kontingente, Preise und Richtlinien
Authentifizierung
Wenn Sie die Time Zone API verwenden möchten, müssen Sie sie zuerst aktivieren und die entsprechenden Anmeldedaten für die Authentifizierung abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.
Kontingente und Preise
Weitere Informationen zu den für die Time Zone API festgelegten Kontingenten und Preisen finden Sie auf der Seite Nutzung und Abrechnung.
Richtlinien
Die Nutzung der Time Zone API muss den API-Richtlinien entsprechen.
Weitere Informationen
In der Time Zone API können Sie auch einen Sprachparameter festlegen, um Ergebnisse in anderen Sprachen als der Standardsprache Englisch zurückzugeben. Weitere Beispiele und andere Details finden Sie im Entwicklerleitfaden zur Time Zone API.
Der Entwicklerleitfaden für die Time Zone API richtet sich an Website- und App-Entwickler, die Zeitdaten in Karten einbinden möchten, die von einer der Google Maps Platform APIs bereitgestellt werden. Sie enthält eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.