Textová podoba smlouvy Smlouva č. 6336307: Smlouva o poskytování veřejných služeb v přepravě cestujících veřejnou

                        Technická specifikace vzájemné komunikace mezi
   vozidlem a dispečerským pracovištěm ODIS

1. Uspořádání systému

V systému jsou dvě roviny komunikace: palubní jednotky/modemy ve vozidlech komunikují se
servery provozovatelů palubních jednotek (APEX, Telmax, EM Test, Mikroelektronika - dále jen
provozovatelé) a servery provozovatelů komunikují s jediným serverem centrálního dispečinku
MPV (CHAPS - dále jen dispečink).

Tento dokument popisuje pouze závazné rozhraní komunikace mezi servery provozovatelů a
serverem dispečinku. Binární komunikace mezi jednotlivými vozidly a servery provozovatelů je
ponechána na vzájemné dohodě jednotlivých subjektů.

Komunikace mezi servery provozovatelů a serverem dispečinku je realizována TCP protokolem
přenášejícím ucelené bloky zpráv v otevřeném XML formátu. Komunikace se odehrávají po veřejném
internetu, jako zabezpečení jsou nastaveny statické IP adresy serverů.

2. Formát zpráv

Zprávy budou zasílány ve formátu XML, kódování diakritiky UTF-8. Každý zaslaný balík musí být
vložen do tagu M. Balík může obsahovat více zpráv stejného typu (typem se myslí lokalizační zprávy
nebo zprávy od řidičů, atd.). Balíky budou zasílány po uplynutí nejvýše 30 sekund (pokud bude co
zaslat).

Ze serverů provozovatelů na server dispečinku budou zasílány balíky zpráv obsahující zprávy typu:

V          zprávy o poloze vozů

alert      zprávy od řidičů z vozů

response   stavové informace o doručení zpráv řidičům do vozů

Ze serveru dispečinku na servery provozovatelů budou zasílány zprávy typu:

broadcast  zprávy řidičům do vozů

stops      update tabulky zastávek ve vozech
2.1 V - lokalizační zprávy z vozů

    • tag V
              o imei – imei číslo modemu
              o rz – registrační značka vozidla bez mezer (7 znaků)
              o prodzar – číslo prodejního zařízení (pokud není v datové větě z daného kanálu
                   obsaženo, má se za to, že prodzar=imei)
              o pkt – číslo paketu
              o lat a lng – souřadnice ve formátu WGS 84 formátovány na 5 desetinných míst
                   s desetinnou tečkou (př. lat="50.06577" lng="14.26674")
              o tm – datum a čas palubního počítače v UTC ve formátu yyyy-mm-ddThh:mm:ss
              o events – příznaky ve zprávách. Element nese řetězec složený ze znaků:
                         R – rozjezd (překročení minimální rychlosti cca 10 km/h).
                         T – uplynutí časového intervalu od posledního hlášení (2 min)
                         L – ujetí nastavené vzdálenosti od posledního hlášení
                         P – událost palubního počítače (otevření dveří, zavření dveří ..)
                         X – překročení nastavené rychlosti
                         A – odchýlení od kurzu o x°
                         G – změna platnosti GPS (ztráta signálu, získání signálu).
                         D – vjezd do území sloupku
                         Z – výjezd z území sloupku
              o type, line a conn – řidičem zadaný typ linky, číslo linky a číslo spoje (dle CIS)
              o rych - aktuální rychlost v km/h (celé nezáporné číslo 0-200),
              o smer - směr (azimut) ve stupních (celé nezáporné číslo 0-360),
              o evc - evidenční číslo vozu zadané řidičem,
              o turnus - řidičem zadané číslo služby,
              o ridic - řidičem zadané jeho číslo,
              o akt – evidenční číslo aktuální zastávky dle číselníku ASWJŘ (dle strojku),
              o konc – evidenční číslo cílové zastávky dle číselníku ASWJŘ (dle strojku),
              o delta - předpočítané zpoždění palubního počítače v minutách (celé číslo),
              o ppevent - události palubního počítače (otevření dveří, ..) (celé číslo),
              o ppstatus - status palubního počítače (celé číslo),
              o pperror - chyba palubního počítače (celé číslo),
              o n - počet cestujících, kteří nastoupili,
              o v - počet cestujících, kteří vystoupili,
              o o - počet cestujících, ve vozidle.

V každé zprávě musí být obsaženy atributy imei, rz, prodzar, pkt, lat, lng a tm. Ostatní atributy,
pokud neobsahují žádný údaj, je vhodné vynechat.

Př.



2.2 Alert – zprávy od řidičů z vozů

    • tag alert,
              o imei – imei číslo modemu
              o pkt – číslo paketu
              o lat a lng – souřadnice ve formátu WGS 84 formátovány na 5 desetinných míst
                   s desetinnou tečkou
              o tm - datum a čas palubního počítače v UTC ve formátu yyyy-mm-ddThh:mm:ss
              o data – text zprávy

Př:


2.3 Response - stavová informace o doručení zpráv řidičům do vozů

    • tag response,
              o msgid – identifikační kód zprávy
              o tm - datum a čas v UTC ve formátu yyyy-mm-ddThh:mm:ss
              o tag rp se subelementy imei – imei vozu, z nějž byla odpověď poslána
              o err – nepovinný atribut, obsahuje chybové stavy doručení zprávy. Pokud zpráva byla
                   v pořádku odeslána do vozu a potvrzena řidičem, hodnota err se ve zprávě nezasílá. V
                   parametru err může být jakýkoli text např. „Neodesláno“, „Odesláno, ale
                   nepotvrzeno“, atd.

Př:
71217122

2.4 Broadcast - zprávy řidičům do vozů

Tento typ zprávy znamená, že server dispečinku požaduje rozeslat do určených vozů textové zprávy.
Každý takovýto požadavek je unikátně číslován msgid tak, aby server provozovatele mohl následně
k tomuto msgid připojovat stavovou informaci o doručení (response).

    • tag broadcast,
              o msgid – identifikační kód zprávy
              o tm - datum a čas v UTC ve formátu yyyy-mm-ddThh:mm:ss
              o tag rp se subelementy imei – imei vozů, do nichž má být zpráva poslána
              o tag data – s textem zprávy

Př:
 7121
7122303/38 Šestajovice,,Za Stodolami: čeká304/17 do11:11.Jedete včas.


2.5 Stops - požadavek na update tabulky souřadnic zastávek

         Čas od času se mění množina zastávek - upravují se souřadnice, zastávky se ruší, vznikají
nové. Jednotky ve vozech mají tabulku se souřadnicemi zastávek uloženu, aby mohly detekovat
vjezd/výjezd do/z jejího území.

         Server dispečinku jednou za den rozešle vozům update tabulky souřadnic sloupků. Zpráva
stops je požadavkem na server provozovatele, aby rozdistribuoval aktuální tabulku souřadnic do
vozů.

         Server provozovatele spravuje vozy několika dopravců a každý dopravce pojíždí jinou
množinu zastávek. Do všech vozů jednoho dopravce se načte shodná tabulka - množina zastávek
nacházejících se na všech linkách jím pojížděných. Proto rozděluje server dispečinku jednotlivé
tabulky zastávek do skupin VehicleGroup.

    • tag stops,
              o tm - datum a čas v UTC
              o tag VehicleGroup se subelementy
                         element dopr se subelementy id – číslo dopravce dle CIS a alias – název
                             dopravce
                         subelementy imei – imei vozů
                         tag Table se subelementy Stop lat a lng

Př.



64370064441964430264415364444
3