Erste Schritte

Die Time Zone API stellt Zeitverschiebungsdaten für Orte auf der Erdoberfläche bereit. Zeitzoneninformationen für ein bestimmtes Datum und ein bestimmtes Paar aus Breiten- und Längengrad abrufen Die API gibt den Namen der Zeitzone, die Abweichung von der UTC-Zeit und die Abweichung auf die Sommerzeit zurück.

Beispielanforderung und -antwort

Greifen Sie über eine HTTPS-Schnittstelle auf die Time Zone API zu. Anfragen werden dabei als URL-String erstellt und location mit Breitengrad/Längengrad-Koordinaten, Datum mit timestamp und API-Schlüssel angegeben.

Durch die folgende Abfrage wird eine Zeitzonenanforderung für Nevada, USA, durchgeführt. Der Zeitstempel ist auf 8. März 2012 eingestellt.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

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

Sie können dies 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 Ort und das angegebene Datum ((timestamp)).

Weitere Informationen zum Erstellen von Anfrage-URLs und verfügbaren Parametern sowie zum Verstehen 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 und ermöglichen einfache, native Implementierungen häufiger Aufgaben wie Authentifizierung, Anfragedrosselung und automatische Wiederholungsversuche. 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 zuerst die API aktivieren und die erforderlichen Anmeldedaten zur Authentifizierung 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 für die Time Zone API.

Richtlinien

Die Nutzung der Time Zone API muss in Übereinstimmung mit den API-Richtlinien erfolgen.

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 weitere Details findest du im Entwicklerleitfaden für die Time Zone API.

Der Entwicklerleitfaden für die Time Zone API richtet sich an Entwickler von Websites und Mobilgeräten, die Zeitdaten auf Karten verwenden möchten, die über eine der Google Maps Platform APIs bereitgestellt werden. Es bietet eine Einführung in die Verwendung der API und Referenzmaterial zu den verfügbaren Parametern.