Przejdź do głównej treści

Jak używać geostref we flocie: model danych i alerty

Geostrefa zamienia granicę obszaru w zdarzenia wjazdu, wyjazdu lub przebywania pojazdów. Konfiguracja wymaga geometrii, współrzędnych, harmonogramu, pojazdów i odbiorców powiadomień. Poradnik opisuje proces oraz przykładowy model danych i JSON, które należy dostosować do funkcji rzeczywiście dostępnych w używanym systemie, jakości pozycji i potrzeb codziennej pracy zespołu.

Autor
Zenit Telematics
Opublikowano
Zaktualizowano

Jakie pola zawiera model danych geostrefy?

Model oddziela geometrię, zdarzenia, harmonogram, powiadomienia i pojazdy. Przykład objaśnia konfigurację i nie stanowi specyfikacji API ani listy funkcji Zenit.

Pola modelu

Przykładowy model danych geostrefy floty
PoleZnaczenie i kontrola
idStały identyfikator obszaru
nameNazwa operacyjna obszaru
typecircle lub polygon
latitudeSzerokość geograficzna środka w stopniach dziesiętnych
longitudeDługość geograficzna środka w stopniach dziesiętnych
radius_mPromień w metrach, tylko dla koła
coordinates[]Wierzchołki wielokąta jako pary [długość, szerokość]; zamknąć pierścień
eventsentry, exit i dwell; określić próg czasu przebywania
scheduleDni, przedziały godzinowe i strefa IANA
notifyUprawnione kanały i odbiorcy; ograniczyć zbędne powiadomienia
vehicle_scopePojazdy lub grupy objęte regułą

Przykład JSON: okrągły obszar magazynu

Wartości i odbiorca są fikcyjne. Dla polygon stosuje się wierzchołki zamiast środka i promienia oraz określa format współrzędnych. W GeoJSON pary mają kolejność [długość, szerokość], a pierwszy wierzchołek powtarza się na końcu. Ten przykład nie jest pełnym obiektem GeoJSON.

{
  "id": "depot-01",
  "name": "Przykładowy magazyn",
  "type": "circle",
  "latitude": 45.0,
  "longitude": 9.0,
  "radius_m": 250,
  "coordinates": [],
  "events": [
    "entry",
    "exit",
    "dwell"
  ],
  "dwell_seconds": 300,
  "schedule": {
    "timezone": "Europe/Warsaw",
    "days": [
      "mon",
      "tue",
      "wed",
      "thu",
      "fri"
    ],
    "start": "07:00",
    "end": "19:00"
  },
  "notify": {
    "channels": [
      "email"
    ],
    "recipients": [
      "operations@example.invalid"
    ]
  },
  "vehicle_scope": {
    "vehicle_ids": [
      "vehicle-01"
    ]
  }
}

Jak ograniczyć powielone zdarzenia i alerty?

Określić tolerancję granicy, jakość pozycji, minimalny czas przebywania, identyfikatory zdarzeń i obsługę punktów poza kolejnością. Następnie sprawdzić rzeczywistą trasę: pole w modelu pojęciowym nie gwarantuje tej samej logiki w urządzeniu lub aplikacji.

Co ocenić w projekcie?

Metoda, pytania i kontrole dla swojej floty.

Jak przejść od obszaru do zdarzenia?

Określ cel operacyjny obszaru: magazyn, plac budowy lub miejsce obsługi klienta. Następnie zdefiniuj granicę i warunki zdarzenia, uwzględniając jakość i częstotliwość pozycji. Zdarzenie powinno mieć odbiorcę i oczekiwaną decyzję. Sama lokalizacja nie potwierdza wykonania całej usługi.

Jak ograniczyć zbędne alerty?

Sprawdź granicę na rzeczywistych przejazdach, tolerancję błędu i minimalny czas przebywania. Oddziel brak danych od braku zdarzenia i ustal obsługę pozycji poza kolejnością. Wymagania dotyczące prywatności oraz przetwarzania danych pracowników wymagają weryfikacji w konkretnym zastosowaniu.

Najczęstsze pytania

Czy geostrefa dowodzi wykonania zadania?

Nie. Pozycja i zdarzenie wymagają interpretacji w kontekście usługi i jakości danych.

Czy model JSON opisuje API Zenit?

Nie. Jest przykładem pojęciowym; rzeczywiste pola i funkcje należy sprawdzić w dokumentacji systemu.

Omów proces swojej floty podczas prezentacji