Upozornění: Text přílohy byl získán strojově a nemusí přesně odpovídat originálu. Zejména u strojově nečitelných smluv, kde jsme použili OCR. originál smlouvy stáhnete odsud
Technický předpis datového formátu
telemetrických údajů
Verze 1.2 Ze dne:25.10. 2023
Obsah
1 Účel Dokumentu........................................................................................................................................... 2
1.1 Obecný přehled....................................................................................................................................2
1.2 Změny oproti předchozí verzi.............................................................................................................2
2 Obsah d a t ...................................................................................................................................................... 3
3 Struktura D at...............................................................................................................................................12
3.1 Příklad XML záznamu.........................................................................................................................12
4 Testování a ověření korektnosti datové sady..........................................................................................14
4.1 Použití testovací aplikace datových sa d ........................................................................................14
4.2 Scénář testování.................................................................................................................................14
4.3 Výsledky testování 16
1 ÚČEL DOKUMENTU
Tento předpis stanovuje závazné požadavky na předávaná data telemetrických údajů z GPS jednotek.
Stanoví formát, strukturu, obsah a povinnost jednotlivých datových položek. Stanoví rovněž
podmínky, za kterých jsou příslušná data vyžadována. Dodržení ustanovení tohoto dokumentu je
předpokladem ke korektnímu zpracování zaslaných datových sad.
1.1 Obecný přehled
Datové sady jsou předávány na veřejná technická rozhraní R a S poskytovaná na URL adresách
zveřejněných na webu https://podporagps.rsd.cz. Způsob technické realizace komunikace s těmito
rozhraními je definován v dokumentu Technický předpis funkce sběru telemetrických dat a jejich
předávání v jeho aktuální verzi.
1.2 Změny oproti předchozí verzi
Změny verze 1.2 oproti verzi datové sady definované ve verzi 1.1
• V datové větě LIGHTTRAILER, byla zrušena pro dodavatele povinnost předávat atributy
lighton, modearrow, akuvoltage a rampup
Změny verze 1.2 oproti verzi datové sady definované v dokumentu KOMUNIKAČNÍ PROTOKOL 1.0
• oddělena dokumentace formátu datové sady od komunikačního protokolu
• přidán povinný konstantní atribut version do elementu CREATED
• přidány atributy RoadState, RoadSlip, WaterLevel a CriticalWarning do elementu
TEMPERATURE
• doplněno omezení počtu číslic u atributu gpsunitid elementu GPSRECORD
• doplněna omezení délky textu u atributu RZ, driver a company elementu VEHICLEINFO
• upřesněn datový typ a formát atributu gram elementu SPREADINGINFO
• doplněn znak * vedle názvu elementu, označující elementy, které jsou povinné v libovolné
datové sadě
• upraven příklad XML záznamu datové sady, aby odpovídal verzi 1.1 protokolu
• doplněn popis webové aplikace pro testování přenosu datové sady a jejího parsování a
podoby dat ukládané do systémů ŘSD
• V datové větě LIGHTTRAILER, byla zrušena pro dodavatele povinnost předávat atributy
lighton, modearrow, akuvoltage a rampup
2 OBSAH DAT
U pojmenování atributů a elementů v XML nezáleží na velikosti písmen. Hvězdička * vedle názvu elementu vyznačuje jeho povinnost v každé datové sadě
a není součástí názvu elementu.
Název Atribut Popis Formát Rozsah hodnot Jednotky Povinný
Xml* Záhlavní XML dokumentu ANO
Příklad:
GPSDATA*
Příklad:
CREATED* ANO
Příklad:
GPSRECORD* Čas vygenerování YYYY-MM- ANO
Příklad: DDTHH:MM:SS
+HH:MM
version Identifikátor verze datové sady Konstantní text 1 1" ANO
2014-05-27T14:18:31+01:00
gpstime Reálný čas, kdy byl záznam pořízen v YYYY-MM- ANO
GPS jednotce v SEČ (SELČ) DDTHH:MM:SS
+HH:MM
gsmsignal Kvalita signálu GSM (0-5, 0=bez signálu, Číslo 0-5 ANO
5=silný signál)
satellitecount Počet satelitů Číslo Kladné celé číslo ANO
gpsunitid Jednoznačný identifikátor GPS jednotky Číslo Kladné celé číslo ANO
(max. 20 číslic)
Název Atribut Popis Formát Rozsah hodnot Jednotky Povinný
VEHICLEINFO*
Rz Registrační značka vozidla Text 1-15 znaků ANO
Příklad: Číslo dle 1 = Osobní vozidlo ANO
Type Druh vozidla rozsahu
2 = Dodávkové vozidlo ANO,
Driverid ID řidiče Číslo 3 = Nákladní vozidlo NE dodavatelé údržby
Driver Jméno a příjmení řidiče Text 4 = Traktor / stroj NE,
Company Název dodavatele Text 5 = Přívěsný vozík ANO dodavatelé údržby
idvehicleorig Identifikátor vozidla Číslo 6 = Osoba NE,
technology Nesená nástavba Číslo dle Kladné celé číslo dle ANO dodavatelé údržby
rozsahu databáze zadavatele ANO
1-30 znaků ANO, pouze u VEHICLEINFO/type = 2,3,4
1-20 znaků
Kladné celé číslo
1 = sypač
2 = sekačka
3 = samosběr
4 = kropice
5 = valník
6 = nosič kontejnerů
7 = ostatní
a kódováním UTF-8
Kompletní popis dat pro všechna vozidla vyplývá z níže uvedené tabulky, kde jsou také uvedeny
popisy, hodnoty, kterých nabývají, jednotky a informace v jakých případech jsou dané parametry
povinné. V případě, že je nějaká odlišnost mezi vozidly Ředitelství silnic a dálnic s. p. (dále jen ŘSD) a
dodavatelů údržby, je toto uvedeno v posledním sloupci. Použití je pak dáno uvedenými příklady.
3.1 Příklad XML záznamu
Pro ilustraci přikládáme příklad kompletního XML záznamu. Tento příklad je pouze ilustrační a má
ukázat využití všech atributů a v praxi nemůže nastat.
< GPSDATA>
< CREATED version = "1.1" > 2 0 1 8 -0 5 -2 7 T 1 4 :1 8 :3 1 + 0 1 :0 0 < /C R EA TED >
< GPSRECO RD gpstim e= "2 0 1 8-0 5-27 T14 :1 8:0 1+ 01 :0 0" gsm signal= "5"
satellitecount= "9 " gpsunitid= "5 6 5 9 8 54 58 75 44 1 ">
< VEH ICLEIN FO rz= " 2AH 5487" type= " 2" driverid= "215487" driver="Jan
Novak" com pany= "Firm axyz" idvehicleorig= "5 658478" technology= "5 " />
< PO SITIO N IN FO ignition= "tru e" longitude = " 1 4.57 89 64 "
latitude= "5 1.10 08 94 " speedgps= " 22.3" speedtach= " 23.8" speedcan= " 22.3"
tachogps=" 2568.125" tachotach= "2568.125" tachocan= "2568.125"
m odedrive= " 2" />
< SPREA D IN G IN FO spreadingm ode= " 3" plow= "tru e" gram = " 6 0 "
widthleft= " 145.2" w idthright= " 125.5" sum salt= "0 .1 2 3 " sum inert= "0 .1 3 2 "
sum brine= " 1" />
< C U T S IN F O cuts1 = "tru e " c u ts2 = " fa ls e " c u ts3 = " fa ls e " / >
< SW EEPSIN FO centralbroom = "tru e" leftbroom = "tru e" rightbroom = "tru e"
turbine= "true" runningshaft= "true" />
< SPR IN K LER SIN FO leftflushing= "true" rightflushing= "true"
centralflushing="true" m isting="true" pum p="true" />
< LIG H TTR A ILER lighton= "true" m odearrow= " 1" akuvoltage= " 25.6"
ram pup= "true" crash= "false " />
< T EM P ER A T U R E te m p a ir= " 2 2 .3 " te m p ro ad = " 2 0 .2 " ro ad state="z a p la v e n á "
ro ad slip ="0 .7 3 " w a terlevel="1 5 0 .0 " criticalw a rn in g ="tru e " / >
< EXTEN D ED IN FO revs= " 2 2 " revsextension="" fuel= "0 .2 2 3 " levelPHM = " 4 8 "
pow ervoltage= " 2 5.6 " lighthouse= "tru e" />
V případě, že typ vozidla nebo typ jízdy nevyžaduje předání informací, vynecháváme při zasílání
celou datovou větu. Například, není-li vozidlo sekačkou, element CUTSINFO bude vynechán.
Elementy, které musí obsahovat povinně každá datová sada GPSRECORD jsou v tabulce OBSAH DAT
označeny hvězdičkou vedle názvu elementu.
4 TESTOVÁNÍ A OVĚŘENÍ KOREKTNOSTI DATOVÉ SADY
Za účelem možnosti ověření správnosti formátu a dat obsažených v datových sadách byla
vytvořena testovací a aplikace a zveřejněna na portálu https://podporagps.rsd.cz/DataTest
Pro možnost aplikaci používat je nutné, aby si poskytovatel datových sad GPS vyžádal svůj unikátní
klíč APIKEY u pověřeného pracovníka ŘSD.
4.1 Použití testovací aplikace datových sad
Do pole APIKEY vložte klíč, který Vám byl přidělen pracovníkem ŘSD. Obsah zprávy GPS vkládejte
bez kořenového elementu DOC v kódování UTF-8, poté stiskněte tlačítko Test, přijetí zprávy na
rozhraní je indikováno zeleným zaškrtávátkem, v případě, že se objeví červený křížek, zkontrolujte
obsah zprávy a váš APIKEY a akci opakujte. Poté vyčkejte zpracování, dokud je zobrazen prvek
probíhající činnosti na místě tlačítka Test. Následně se objeví přehledný obsah záznamu, který
vznikl v testovací DB v levé části stránky, spolu s opisem převzatých dat na rozhraní a seznamem
chyb a vad. V části pravé Pro opakovaný test použijte tlačítko Reset, které připraví formulář pro
další test s novými daty. Váš APIKEY zůstane zadán.
4.2 Scénář testování
■ Uživatel zadá APIKEY a Obsah zprávy
■ Stiskne tlačítko Test
■ Aplikace zavolá protokolem HTTPS REST API Funkci TestLoad a předá jí APIKEY a Obsah zprávy
obohacený o vygenerovaný rootový element DOC , kde ClientId bude vygenerovaný jedinečný
BIGINT , volání je synchronní a počká na návratovou hodnotu (OK - 2XX / Error )
A P lK e y O
n 4 k5jtn 8 9 n jn f0 2n 3f02 m 3 0f9n g32 lk7h 1f32 8 90 d 5 n s0 d řm 3 g7 h scvs D o po le A P IK E Y vlo žte klíč, který Vám
byl přidělen pracovníkem ŘSD. Obsah
O bsah zprávy zprávy G PS vkládejte bez kořenového
elem entu DOC v kódování UTF-8,
2018-05-27T14:18:31+01:0 zprávy na rozhraní je indikováno
Aplikace si zapamatuje ClientId
■ Aplikace zobrazí indikátor nic / zelené zaškrtávátko / červený křížek (indkátor úspěchu odeslání)
na zíkladě vrácené hodnoty volání
■ V případě, že volání skončilo OK, dojde k zobrazení indikátoru nic/ přesýpací hodiny (indikátor
čekání na zápis do DB), znepřístupní se tlačítka Test a Reset a spustí se interní Timer , který vyčká
10 Sekund
APlKey O
n4k5jtn89njnf02n3f02m30f9ng32lk7h1f32890d5ns0dfm3g7hscvs
Obsah zprávy
*GPSDATA»
2018-0S-27T 14:18:31*01:00
< G P S R E C O R D gpstime=‘2018-0S-27T14 18 01*01 00* gsm$ignal="5" $ateHrtecoon!=“9‘
gpsunitid="56598545875441 M>
« SP R lN K L E R SlN F O »efttlushing-“tnje" rigbtflushing="true’ cefltraifkishmg="lrue" mftting=Tru«" pump=”lrue' />
pocetn: 0
gpstime: 2018-05-27T14:18:01
latitude: 51.100894 2018-05-27T14:18:31
longitude: 14.578964 01:00
gsMsignal: 5
rz: 2AH5487