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 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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.