Zeitzonenanfragen und -antworten

Zeitzone

Anfragen an die Time Zone API werden als URL-String erstellt. Die API gibt Zeitzonen daten für einen Punkt auf der Erde zurück, der durch ein Breiten-/Längengrad-Paar angegeben wird. Beachten Sie, dass Zeitzonen daten für Orte über Wasser, z. B. Ozeane oder Meere, möglicherweise nicht verfügbar sind.

Eine Zeitzonenanfrage hat folgendes Format:

https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters

Dabei kann outputFormat einen der folgenden Werte haben:

json (empfohlen): Gibt die Ausgabe in JavaScript Object Notation (JSON) an.
xml, gibt die Ausgabe in XML an, die in einem <TimeZoneResponse> Knoten eingeschlossen ist.

Hinweis: URLs müssen korrekt codiert sein, um gültig zu sein. Außerdem sind sie für alle Webdienste auf 16.384 Zeichen begrenzt. Beachten Sie dieses Limit beim Erstellen von URLs. Unterschiedliche Browser, Proxys und Server können auch unterschiedliche URL-Zeichenlimits haben.

Erforderliche Parameter

Standort

Ein durch Kommas getrenntes Breiten-/Längengrad-Tupel,location=39.6034810,-119.6822510, das den Ort darstellt, nach dem gesucht werden soll.
Zeitstempel

Die gewünschte Zeit in Sekunden seit Mitternacht am 1. Januar 1970 (UTC). Die Time Zone API verwendet den timestamp, um anhand der Zeitzone des location zu bestimmen, ob die Sommerzeit angewendet werden soll.

Beachten Sie, dass die API keine historischen Zeitzonen berücksichtigt. Wenn Sie also einen Zeitstempel in der Vergangenheit angeben, berücksichtigt die API nicht die Möglichkeit, dass sich der Ort zuvor in einer anderen Zeitzone befand.

Optionale Parameter

Sprache

Die Sprache, in der die Ergebnisse zurückgegeben werden sollen.
- Hier finden Sie eine Liste der unterstützten Sprachen. Die unterstützten Sprachen werden regelmäßig von Google aktualisiert. Daher ist diese Liste möglicherweise nicht vollständig.
- Wenn language nicht angegeben wird, versucht die API, die bevorzugte Sprache zu verwenden, die im Accept-Language Header angegeben ist.
- Die API versucht, eine Straßenadresse anzugeben, die sowohl für den Nutzer als auch für Einheimische lesbar ist. Dazu werden Straßen adressen in der lokalen Sprache zurückgegeben und bei Bedarf in ein für den Nutzer lesbares Schriftsystem transliteriert, wobei die bevorzugte Sprache berücksichtigt wird. Alle anderen Adressen werden in der bevorzugten Sprache zurückgegeben. Adresskomponenten werden alle in derselben Sprache zurückgegeben, die anhand der ersten Komponente ausgewählt wird.
- Wenn ein Name in der bevorzugten Sprache nicht verfügbar ist, verwendet die API die nächstbeste Übereinstimmung.
- Die bevorzugte Sprache hat einen geringen Einfluss auf die Ergebnisse, die von der API zurückgegeben werden, und auf die Reihenfolge, in der sie zurückgegeben werden. Der Geocoder interpretiert Abkürzungen je nach Sprache unterschiedlich, z. B. die Abkürzungen für Straßentypen oder Synonyme, die in einer Sprache gültig sein können, in einer anderen jedoch nicht. Beispielsweise sind utca und tér im Ungarischen Synonyme für Straße.

Beispiele für Zeitzonen

In diesem Abschnitt sehen Sie einige Beispielabfragen, mit denen die Funktionen der API demonstriert werden.

Durch die folgende Abfrage wird eine Zeitzonenanforderung für Nevada, USA, durchgeführt. Der Zeitstempel ist auf den 5. Dezember 2024 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'

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>

Durch die folgende Abfrage wird eine Zeitzonenanforderung für Nevada, USA, durchgeführt. Der Ort ist derselbe wie in der obigen Anfrage, aber der Zeitstempel ist auf den 15. März 2024 festgelegt. Die Antwort enthält diesmal die Zeitverschiebung aufgrund der Sommerzeit.

URL

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

curl

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

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Daylight Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Daylight Time</time_zone_name>
</TimeZoneResponse>

Dieses Beispiel ähnelt den beiden obigen, es wird jedoch zusätzlich der Parameter „language“ festgelegt. Daher wird die Antwort in Spanisch lokalisiert.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?language=es
  &location=39.6034810%2C-119.6822510
  ×tamp=1710547034
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1710547034&language=es&key=YOUR_API_KEY'

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "hora de verano del Pacífico",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>hora de verano del Pacífico</time_zone_name>
</TimeZoneResponse>

Antworten der Time Zone API

Für jede gültige Anfrage gibt die Time Zone API eine Antwort in dem Format zurück, das in der Anfrage-URL angegeben ist.

TimeZoneResponse

Feld	Erforderlich	Typ	Beschreibung
`status`	erforderlich	TimeZoneStatus	Weitere Informationen finden Sie unter TimeZoneStatus.
`dstOffset`	optional	Zahl	Die Zeitverschiebung aufgrund der Sommerzeit in Sekunden. Dieser Wert ist null wenn sich die Zeitzone zum angegebenen `timestamp` nicht in der Sommerzeit befindet.
`errorMessage`	optional	String	Detaillierte Informationen zu den Gründen für den angegebenen Statuscode. Wird nur zurückgegeben, wenn der Status nicht `Ok` ist.
`rawOffset`	optional	Zahl	Die Zeitverschiebung von UTC (in Sekunden) für den angegebenen Ort. Die Sommerzeit wird dabei nicht berücksichtigt.
`timeZoneId`	optional	String	Ein String mit der ID der Zeitzone, z. B. "America/Los_Angeles" oder "Australia/Sydney". Diese IDs werden von Unicode Common Locale Data Repository (CLDR) definiert und sind derzeit in der Datei timezone.xml verfügbar. Wenn eine Zeitzone mehrere IDs hat, wird die kanonische ID zurückgegeben. In XML-Antworten ist dies der erste Alias jeder Zeitzone. Beispiel: „Asia/Calcutta“ wird zurückgegeben, nicht „Asia/Kolkata“.
`timeZoneName`	optional	String	Der lange Name der Zeitzone. Dieses Feld wird lokalisiert, wenn der Parameter „language“ festgelegt ist, z. B. `Pacific Daylight Time` oder `Australian Eastern Daylight Time`.

TimeZoneStatus

Das Feld status im Antwortobjekt der Time Zone API enthält den Status der Anfrage. Das status Feld kann die folgenden Werte enthalten:

OK gibt an, dass die Anfrage erfolgreich war.
INVALID_REQUEST gibt an, dass die Anfrage falsch formatiert war.
OVER_DAILY_LIMIT gibt einen der folgenden Fälle an:
- Der API-Schlüssel fehlt oder ist ungültig.
- Die Abrechnung ist für Ihr Konto nicht aktiviert.
- Das von Ihnen festgelegte Nutzungslimit wurde überschritten.
- Die angegebene Zahlungsmethode ist nicht mehr gültig. Das kann z. B. bei einer abgelaufenen Kreditkarte der Fall sein.
OVER_QUERY_LIMIT gibt an, dass der Anforderer das Kontingent überschritten hat.
REQUEST_DENIED gibt an, dass die API die Anfrage nicht abgeschlossen hat. Überprüfen Sie, ob die Anforderung über HTTPS und nicht über HTTP gesendet wurde.
UNKNOWN_ERROR gibt einen unbekannten Fehler an.
ZERO_RESULTS gibt an, dass für die angegebene Position oder Zeit keine Zeitzonendaten gefunden wurden. Prüfen Sie, ob sich der Ort in der Anfrage auf dem Land und nicht über Wasser befindet.

Ortszeit berechnen

Die Ortszeit eines bestimmten Ortes ist die Summe aus dem timestamp Parameter und den dstOffset und rawOffset Feldern aus dem Ergebnis.

Zeitzonenanfragen und -antworten

Zeitzone

Erforderliche Parameter

Standort

Zeitstempel

Optionale Parameter

Sprache

Beispiele für Zeitzonen

URL

curl

JSON

XML

URL

curl

JSON

XML

URL

curl

JSON

XML

Antworten der Time Zone API

TimeZoneResponse

`status`

`dstOffset`

`errorMessage`

`rawOffset`

`timeZoneId`

`timeZoneName`

TimeZoneStatus

Ortszeit berechnen

Zeitzonenanfragen und -antworten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Zeitzone

Erforderliche Parameter

Standort

Zeitstempel

Optionale Parameter

Sprache

Beispiele für Zeitzonen

URL

curl

JSON

XML

URL

curl

JSON

XML

URL

curl

JSON

XML

Antworten der Time Zone API

TimeZoneResponse

status

dstOffset

errorMessage

rawOffset

timeZoneId

timeZoneName

TimeZoneStatus

Ortszeit berechnen

Zeitzonenanfragen und -antworten

`status`

`dstOffset`

`errorMessage`

`rawOffset`

`timeZoneId`

`timeZoneName`