Zeitzonen-Abfrage

Die Zeitzone eines Punkts und der dort zu einem bestimmten Zeitpunkt geltende Versatz.

GEThttps://api.mygeocode.com/v1/timezone

Parameter

Parameter	Typ	Beschreibung
`lat`erforderlich*	Zahl	-90 bis 90.
`lon`erforderlich	Zahl	-180 bis 180.
`locations`optional	String	*Alternative zu `lat` und `lon`: bis zu 100 Punkte als `lat,lon\|lat,lon\|...`. Jeder Punkt zählt als eine Anfrage; die Antwort enthält ein Array `results` in der Reihenfolge der Eingabe.
`tz`optional	String	*Alternative zu Koordinaten: eine IANA-Zonen-ID wie `Europe/Zurich` (eine Windows-ID wird ebenfalls akzeptiert). Liefert dieselben Felder für diese Zone ohne Grenzabfrage.
`timestamp`optional	Integer	Unix-Zeit in Sekunden. Standard: jetzt. Jeder Zeitpunkt von 1900 bis 2100 wird akzeptiert; künftige Versätze verwenden die aktuell veröffentlichten Regeln.
`language`optional	String	Sprache für `name`, z. B. `de` oder `pt-BR`. Standard Englisch.
`key`optional	String	API-Schlüssel, falls nicht als Header gesendet.

Beispiel

curlJavaScriptPython

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=-33.8688&lon=151.2093&timestamp=1767225600"

const url = new URL("https://api.mygeocode.com/v1/timezone");
url.searchParams.set("lat", -33.8688);
url.searchParams.set("lon", 151.2093);
url.searchParams.set("timestamp", 1767225600); // 2026-01-01T00:00:00Z

const tz = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(tz.timezone, tz.utc_offset, tz.dst);

import requests

tz = requests.get("https://api.mygeocode.com/v1/timezone",
                  params={"lat": -33.8688, "lon": 151.2093, "timestamp": 1767225600}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5).json()
print(tz["timezone"], tz["utc_offset"], tz["dst"])

Antwort

{
  "status": "ok",
  "lat": -33.8688,
  "lon": 151.2093,
  "timezone": "Australia/Sydney",
  "abbreviation": "AEDT",
  "utc_offset": "+11:00",
  "utc_offset_seconds": 39600,
  "dst": true,
  "timestamp": 1767225600,
  "local_time": "2026-01-01T11:00:00+11:00",
  "country_code": "AU",
  "next_transition": { "timestamp": 1775316000, "utc_offset": "+10:00", "dst": false }
}

Antwortfelder

Feld	Typ	Beschreibung
`timezone`	String	IANA-Name. In internationalen Gewässern `Etc/GMT+n` oder `Etc/GMT-n` (beachten Sie, dass die Vorzeichenkonvention wie bei IANA umgekehrt ist).
`abbreviation`	String	Abkürzung zum Zeitpunkt `timestamp`. Nur zur Anzeige; nicht eindeutig.
`name`	String	Zum Zeitpunkt `timestamp` geltender Langname, z. B. Australian Eastern Daylight Time.
`utc_offset`	String	`±HH:MM` zum Zeitpunkt `timestamp`.
`utc_offset_seconds`	Integer	Dasselbe als Zahl.
`raw_offset_seconds`, `dst_offset_seconds`	Integer	Standardversatz und der Sommerzeitanteil darüber (0, wenn keine Sommerzeit gilt). Ihre Summe ist `utc_offset_seconds`.
`dst`	Boolean	Sommerzeit gilt zum Zeitpunkt `timestamp`.
`timestamp`	Integer	Der beschriebene Zeitpunkt.
`local_time`	String	Ortszeit nach RFC 3339 mit Versatz.
`country_code`	String oder null	ISO 3166-1 Alpha-2, null auf See.
`is_ocean`	Boolean	True für die in internationalen Gewässern verwendeten Zonen `Etc/GMT`.
`windows_timezone`	String oder null	Die passende Windows-Zeitzonen-ID aus CLDR, z. B. W. Europe Standard Time.
`next_transition`	Objekt oder null	Die nächste Änderung des Versatzes nach `timestamp`, falls die Zone eine hat.

Hinweise

Speichern Sie den IANA-Namen und rechnen Sie Zeiten mit der tz-Datenbank Ihrer Plattform um. Verwenden Sie die Versatzfelder zur Anzeige oder für Systeme ohne eine solche Datenbank.
Versätze und Sommerzeitregeln folgen der IANA-Zeitzonendatenbank und werden aktualisiert, sobald neue Versionen veröffentlicht werden.
Grenzen sind auf etwa 55 m vereinfacht, sodass ein Punkt wenige Meter von einer Landesgrenze entfernt der Nachbarzone zugeordnet werden kann. Hoheitsgewässer und der offene Ozean sind ebenfalls abgedeckt; Punkte vor der Küste erhalten die nautische Zone (Etc/GMT+3 und so weiter).

Dieselbe Abfrage in den Formaten anderer Anbieter

Wenn Sie bereits Code für einen dieser Anbieter geschrieben haben, behalten Sie ihn: Der Drop-in-Host akzeptiert denselben Pfad und dieselben Parameter und antwortet in der Antwortstruktur dieses Anbieters, mit diesem Endpunkt dahinter. Siehe So funktionieren die Drop-in-Hosts.

Anbieter	Host	Pfad
Google Maps Platform	`gapi.mygeocode.com`	`/maps/api/timezone/json?location=lat,lng&timestamp=...&language=..`
Bing Maps REST Services	`bing.mygeocode.com`	`/REST/v1/TimeZone/{lat},{lon}?datetime=...` `/REST/v1/TimeZone/?query=lat,lon` `/REST/v1/TimeZone/List?timezoneStandard=iana\|windows` `/REST/v1/TimeZone/Convert?datetime=...&fromtz=...&desttz=...`
LocationIQ	`locationiq.mygeocode.com`	`/v1/timezone?lat=...&lon=...`

Fehler

400 invalid_request, wenn lat oder lon fehlt oder außerhalb des gültigen Bereichs liegt, tz keine bekannte Zone ist, es mehr als 100 Punkte sind oder timestamp außerhalb von 1900 bis 2100 liegt. 503 unavailable, wenn die Grenzdaten nicht geladen sind; es wird nichts gezählt.