Jetzt starten

Die Zeitzonen-API bietet Zeitabweichungsdaten für Standorte auf der Erdoberfläche. Zeitzoneninformationen für ein bestimmtes Breiten-/Längengrad-Paar und Datum anfordern Die API gibt den Namen dieser Zeitzone, den Zeitversatz von UTC und den Sommerzeitversatz zurück.

Beispielanforderung und -antwort

Rufe die Time Zone API über eine HTTPS-Schnittstelle auf. Anfragen müssen als URL-String mit Breiten-/Längengradkoordinaten für die location, einem timestamp für das Datum und deinem API-Schlüssel erstellt 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
  &timestamp=1733428634
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

Sie können das testen, indem Sie die URL in Ihren Webbrowser eingeben. Ersetzen Sie dabei YOUR_API_KEY durch Ihren tatsächlichen API-Schlüssel. Die Antwort enthält die Zeitzonendaten für den angegebenen Standort und das angegebene Datum (timestamp).

Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern sowie zur Aufschlüsselung der Antwort findest du 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 Webservice-APIs, da sie einfache, native Implementierungen gängiger Aufgaben wie Authentifizierung, Drosselung von Anfragen und automatischer Wiederholungsversuch bieten. Die Zeitzonen-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 abrufen. Weitere Informationen finden Sie unter Erste Schritte mit der Google Maps Platform.

Kontingente und Preise

Auf der Seite Nutzung und Abrechnung finden Sie Details zu den Kontingenten und Preisen, die für die Zeitzonen-API festgelegt sind.

Richtlinien

Die Nutzung der Time Zone API muss den API-Richtlinien entsprechen.

Weitere Informationen

In der Zeitzonen-API können Sie auch einen Sprachparameter festlegen, um Ergebnisse in anderen Sprachen als der Standardsprache Englisch zurückzugeben. Weitere Beispiele und Informationen finden Sie im Entwicklerleitfaden für die Zeitzonen-API.

Der Entwicklerleitfaden für die Zeitzonen API richtet sich an Entwickler von Websites und mobilen Apps, die Zeitdaten auf Karten einbinden möchten, die von einer der APIs der Google Maps Platform bereitgestellt werden. Sie enthält eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.