Přístup k databázi odcizených motorových vozidel
zobraz menu

Odcizená vozidla

Výsledky ve formátu XMLVýsledky ve formátu XML


Výstup z databázi ve formátu XML je určený hlavně programátorům, kteří chtějí začlenit výsledky vyhledávání do svých vlastních programů (například automatická kontrola dokladu při zápisu čísla do formuláře, apod.). Oproti klasickému zobrazení dat je jednodušší a jednoznačnější. Při změně grafické podoby aplikace není potřeba přepracovávat program.

Tvar dotazu

Dotaz je potřeba odeslat na adresu http://www.mvcr.cz/vozidla/vozidla/vysledek.php pomocí metody GET (dotaz je součásti url adresy). Dotaz musí obsahovat následující položky:

PoložkaPopis
akce Obsahuje jednu z hodnot: „vspz“ nebo „vpod“ nebo „vvin“ nebo „vmot“ nebo „tvin“ nebo „tmot“ (vyhledávání podle čísla SPZ / podvozku / VIN / motoru / tipování podle špatně čitelného čísla VIN / motoru).
dotaz Obsahuje dotaz, na velikosti písmen nezáleží.
  • V případě dotazu na číslo SPZ stačí zadat tři počáteční znaky. Mezery a pomlčky program ignoruje.
  • V případě dotazu na číslo VIN nebo číslo motoru stačí zadat pět počátečních znaků. Písmena „O“, „Q“ se automaticky převádějí na číslici „0“. Taktéž se automaticky převádějí písmena „I“, „l“ na číslici „1“.
  • V případě dotazu na číslo podvozku je nutno zadat všech šest znaků. Číslo podvozku je shodné s posledními šesti znaky čísla VIN. Písmena „O“, „Q“ se automaticky převádějí na číslici „0“. Taktéž se automaticky převádějí písmena „I“, „l“ na číslici „1“.
  • V případě tipování podle špatně čitelného čísla VIN nebo čísla motoru je možno za nečitelné znaky zadat otazník (%3F). Stačí zadat pouze část řetězce, minimálně však 6 znaků, z toho 4 platné (tj. neotazníkové). Písmena „O“, „Q“ se automaticky převádějí na číslici „0“. Taktéž se automaticky převádějí písmena „I“, „l“ na číslici „1“.
xml Obsahuje hodnotu „xml“ (nebo „1“ nebo „on“ nebo „ON“).
ns0 až ns9 Používá se pouze u tipování podle špatně čitelných čísel motoru a VIN. Obsahuje seznam znaků, které by mohly být původně místo nuly, jedničky, až devítky. Pravidla pro záměny znaků o/q/0 a L/i/1 si program doplní sám. Příklady (znak & je oddělovač):
  • čitelné:
    ns0=&ns1=&ns2=&ns3=&ns4=&ns5=&ns6=&ns7=&ns8=3&ns9=
  • mírně nečitelné:
    ns0=3&ns1=&ns2=&ns3=0&ns4=&ns5=&ns6=5&ns7=1&ns8=36590&ns9=
  • velmi nečitelné:
    ns0=3&ns1=7&ns2=87&ns3=8269&ns4=6&ns5=638
    &ns6=54&ns7=412&ns8=3465902&ns9=357

Například:
http://www.mvcr.cz/vozidla/vozidla/vysledek.php?dotaz=ABC&akce=vspz&xml=xml určuje dotaz na všechny automobily, po kterých bylo vyhlášeno pátrání, a u kterých číslo SPZ začíná na ABC. Výsledek si můžete po kliknutí na odkaz prohlédnout, pokud používáte prohlížeč Mozilla nebo MS Internet Explorer verze 5 nebo vyšší.

Tvar odpovědi (nedojde-li k chybě)

<?xml version="1.0" encoding="utf-8"?>
<patrani xmlns="www.mvcr.cz/patrani/vozidla/xml.html">
    <dotaz dotaz="hodnota_dotazu" typ="vozidla" podtyp="bližší_určení_typu_dotazu" />
    <odpoved aktualizovano="čas_poslední_aktualizace" cast="ano">
        <vozidlo spz="spz_vozu" typ="typ_vozu" barva="barva_vozu" vin="číslo_vin" motor="číslo_motoru" />
        <vozidlo spz="spz_vozu" typ="typ_vozu" barva="barva_vozu" vin="číslo_vin" motor="číslo_motoru" />
          ......
    </odpoved>
</patrani>

elementatribut 
patrani dtd: ((dotaz,odpoved) | (chyba))
Je kořenový element. Pokud nenastane chyba, obsahuje dvojici elementů dotaz a odpoved.
xmlns dtd: (www.mvcr.cz/patrani/vozidla/xml.html) #REQUIRED
Atribut s pevně danou hodnotou („www.mvcr.cz/patrani/vozidla/xml.html“).
dotaz dtd: EMPTY
Nepárový povinný neopakovatelný element, který popisuje dotaz.
dotaz dtd: CDATA #REQUIRED
Povinný atribut, který obsahuje dotaz tak, jak jej zadal uživatel (může být rozšířený o další znaky - *, [, ]).
typ dtd: CDATA #REQUIRED
Povinný atribut, má vždy hodnotu „vozidla“
podtyp dtd: (spzvin|motor|podvozek|vin-tipovani|motor-tipovani) #REQUIRED
Povinný atribut, může mít jednu z hodnot „spz“ nebo „vin“ nebo „motor“ nebo „podvozek“ nebo „vin-tipovani“ nebo „motor-tipovani“
odpoved dtd: vozidla*
Párový povinný neopakovatelný element, který obsahuje seznam vozidel, po kterých je vyhlášeno pátrání a které odpovídají dotazu. Maximálně však může obsahovat 50 vozidel. Pokud po daném vozidle nebylo vyhlášeno pátrání, pak element odpoved je prázdný.
aktualizovano dtd: CDATA #REQUIRED
Povinný atribut, obsahuje datum poslední aktualizace databáze. Zatím nemá pevně daný formát ani pořadí dne, měsíce a roku, bude se to měnit.
cast dtd: (ano) #IMPLIED
Nepovinný atribut, může nabývat pouze hodnoty „ano“. Použije se, pokud v databázi je více než 50 vozidel odpovídajících dotazu.
vozidlo dtd: EMPTY
Nepovinný opakovatelný nepárový atribut, který popisuje jedno vozidlo, po kterém je vyhlášeno pátrání a který odpovídá dotazu.
spz, typ, barva, vin, motor dtd: CDATA #REQUIRED
Povinné atributy popisující dané vozidlo.

Upozornění: Pro případné české znaky je použito kódování UTF-8 (Unicode).

Tvar odpovědi s chybou

<?xml version="1.0" encoding="utf-8"?>
<patrani xmlns="www.mvcr.cz/patrani/vozidla/xml.html">
        <chyba spatny_dotaz="ano/ne"> text_chyby </chyba>
</patrani>

elementatribut 
patrani dtd: (dotaz,odpoved) | (chyba)
Je kořenový element. V případě chyba obsahuje jediný element chyba.
xmlns dtd: (www.mvcr.cz/patrani/vozidla/xml.html) #REQUIRED
Atribut s pevně danou hodnotou („www.mvcr.cz/patrani/vozidla/xml.html“).
chyba dtd: #PCDATA
Párový element popisující chybu. Obsahuje textový popis chyby.
spatny_dotaz dtd: (anone) #REQUIRED
Povinný atribut. Pokud je nastaven na hodnotu „ano“, pak to znamená, že dotaz byl ve špatném tvaru. Hodnota „ne“ znamená, že dotaz byl v pořádku, a že chyba nastala až na serveru ministerstva vnitra.

Upozornění:

Systém obsahuje údaje pouze o těch osobních motorových vozidlech (včetně motocyklů), která byla odcizena na území České republiky a jejichž odcizení bylo oznámeno Policii České republiky ve lhůtě tří let před dnem aktualizace databáze. Policie České republiky si vyhrazuje právo nezařadit do systému odcizené motorové vozidlo (motocykl), pokud je to nutné pro plnění jejich úkolů dle zákona. Výsledky vyhledávání mají pouze informativní charakter. Policie České republiky neodpovídá za škody vzniklé v souvislosti s využitím sdělených údajů. Všechny dotazy jsou zaznamenávány. Policie České republiky předem děkuje uživatelům za případné podněty a připomínky.

Příloha: Kódování UTF-8 a čeština



Bleskové zpravodajství RSSbleskové zpravodajství RSS   Vyhledávánívyhledávání   Homehome   Zpětzpět   Nahorutop   Elektronická podatelnapodatelna
 

Ministerstvo vnitra a Policejní prezidium ČR - spojovatelka: +420 974 811 111, Policie ČR - spojovatelka: +420 974 821 111
Poradna k novému služebnímu zákonu, Oznámení trestné činnosti policistů
Cizinci (Foreigners) informační linka: +420 974 841 356-7
Web: poruchy - 974 801 131,  Web info - 974 841 772,  e-mail: webmaster@mvcr.cz;

Technická podpora: Sekce spojení a komunikací MV, Telefónica O2 Czech Republic a.s., Lira IS
Copyright (c) 2005 - Ministerstvo vnitra, Grafika: Tom Vild (do 14. 6. 2006), Liv Ducci
Všechna práva vyhrazena