Standorte und Zeitzonen

Ein Asset kann einen Standort (Breiten- und Längengrad) und eine Zeitzone haben. Damit werden Standorte auf Karten dargestellt, und die Rules-Karte erfährt, wann Sonnenaufgang ist und was „07:00“ an diesem Ort bedeutet. Diese Seite erklärt, wie beides gesetzt wird und welche Teile von Hermetry es auslesen.

Standort und Zeitzone festlegen

Öffnen Sie Sites & Assets und öffnen Sie die Seitenleiste des Assets.
Wählen Sie Bearbeiten.
Geben Sie Breitengrad (−90 bis 90) und Längengrad (−180 bis 180) in Dezimalgrad ein, zum Beispiel 41.0151 und 28.9795. Ein Wert außerhalb des Bereichs wird abgelehnt: „Latitude is -90..90 and longitude -180..180.“
Geben Sie die Zeitzone als IANA-Namen ein, zum Beispiel Europe/Istanbul, Europe/Berlin oder America/New_York. Ein unbekannter Name wird abgelehnt.
Wählen Sie Speichern.

Lassen Sie die Felder leer, wenn sie nicht zutreffen. Über die API lauten die Felder lat, lng und timezone; siehe Sites and assets API.

Koordinaten erhalten Sie in jeder Kartenanwendung: Öffnen Sie den Ort, kopieren Sie Breiten- und Längengrad und verwenden Sie einen Punkt als Dezimaltrennzeichen.

Geerbte Zeitzone

Ein Asset ohne eigene Zeitzone zeigt in der Übersicht der Seitenleiste die Zeitzone seines übergeordneten Assets an, zum Beispiel „Europe/Istanbul (von Istanbul plant)“: das nächste Asset darüber, das eine Zeitzone hat.

Wichtig

Diese Vererbung dient nur der Anzeige. Rules lesen die Zeitzone des Assets selbst, wie unten beschrieben. Setzen Sie die Zeitzone bei jedem Asset, das der Heimatort einer Regel ist, oder bei jedem Asset, auf dem Geräte platziert sind, wenn deren Regeln Zeitfenster verwenden.

Standorte werden überhaupt nicht vererbt.

Was den Standort verwendet

Funktion	Verwendet
Sites auf der Karte unter Sites & Assets	Der Standort jeder Site; Sites ohne Standort werden als No location aufgeführt
Vorlage Sites-Board	Die Kartenkarte platziert jede Site an ihrem Standort; der Kopfbereich der Sitenseite zeigt die Koordinaten, wenn die Site darüber nichts hat und keine Adresse besitzt
Rules-Karte: Auslöser Sonnenaufgang oder Sonnenuntergang, Bedingung Tag oder Nacht	Der Standort des Heimat-Assets; bei einem Geräte-Heimatort der Standort des Assets, auf dem das Gerät platziert ist. Ohne ihn: „Sunrise and sunset need this place’s location: set it on the place first.“

Geräte haben eigene Positionen (lat und lng in ihren Attributen oder Telemetriedaten), die Gerätekarten verwenden. Die Position eines Geräts platziert es nicht auf einem Asset: siehe Placing devices.

Was die Zeitzone verwendet

Funktion	Verwendete Zeitzone
Rules-Karte: Ein Zeitfenster, Monate oder Datumsangaben, Ein gesetzlicher Feiertag, der auf der Karte angezeigte nächste Lauf Next	Die Zeitzone des Heimat-Assets der Regel; bei einem Geräte-Heimatort die des Assets, auf dem das Gerät platziert ist; UTC, wenn dieses Asset keine hat
Rules-Karte: Auslöser Eine Uhrzeit, Tage des Monats	Die Zeitzone Ihrer Organisation (Settings > General > Timezone)
Tagesbuckets der History-API (`1d`)	Immer UTC

Eine Regel „um 07:00, nur zwischen 06:30 und 07:30“ wird also um 07:00 Organisationszeit ausgelöst, und das Zeitfenster wird in der Zeitzone des Ortes geprüft. Halten Sie beide gleich oder legen Sie sie bewusst fest. Details: Time, sunrise/sunset, dates and holidays.

Sommerzeit

Zeitzonen folgen der Sommerzeit. Eine Uhrzeit, die am Tag der Umstellung nach vorne nicht existiert, wird nicht ausgelöst. Verwenden Sie IANA-Namen statt fester Offsets wie +03:00, damit die Umstellung berücksichtigt wird.

Checkliste für eine neue Site

Geben Sie der Site Breitengrad, Längengrad und Zeitzone.
Geben Sie jedem Gebäude, Raum oder jeder Maschine, die der Heimatort einer Regel ist oder Geräte mit Zeitfenster-Regeln enthält, dieselbe Zeitzone.
Geben Sie diesen Assets auch einen Standort, wenn deren Regeln Sonnenaufgang oder Sonnenuntergang verwenden.
Prüfen Sie die Übersicht der Seitenleiste: Die Zeitzone sollte ohne „(von …)“ angezeigt werden, wo Regeln sie benötigen.

Fehlerbehebung

Problem	Ursache
Eine Site erscheint nicht auf der Karte	Sie hat keinen Breiten- und Längengrad
Eine Sonnenaufgangsregel kann nicht gespeichert werden	Das Heimat-Asset (bzw. bei einem Geräte-Heimatort dessen Asset) hat keinen Standort
Ein Zeitfenster liegt eine oder mehrere Stunden daneben	Das Heimat-Asset hat keine eigene Zeitzone, daher wird UTC verwendet; oder die Zeitzone der Organisation weicht von der des Ortes ab
Eine Tagessumme stimmt nicht mit dem lokalen Tag überein	Die Tagesbuckets der History sind UTC-Tage; summieren Sie stattdessen die stündlichen Buckets, siehe The history API