Specifikace LPI_GDP11B

8. 9. 2017

Specifikace služby LPI_GDP11B (GET DPB)

Oproti verzi 01A došlo k rozšíření requestu. Nově je povinný element TYPDATAKOD, který byl zaveden z důvodů optimalizace odpovědi služby.

Bez zavedení tohoto vyhledávacího kritéria se u některých subjektů stávalo, že rozsah poskytovaných dat byl natolik rozsáhlý, že nebylo technicky možné jej webovou službou poskytovat. Nově si tedy konzument služby definuje zájmové oblasti k DPB, které v odpovědi požaduje. Typ dat je možné kumulovat a tím získat stejnou odpověď jako u verze 01A, ale tento postup není doporučen.

Jedná se o veřejnou webovou službu s autentizací uživatele – autentizace uživatele je realizována buď pomocí digitálního podpisu (XML signature) nebo hashovanou zprávou obsahující jméno a WS klíč uživatele.

Cílem služby je poskytnou prostřednictvím webové služby (v XML struktuře) základní informace o všech nebo konkrétním dílu půdního bloku (DPB) evidovaném v LPIS, který náleží konkrétnímu subjektu.

Vstupní parametry

Vstupní parametr pro konkrétní DPB mohou být:

čtverec+kód nebo
interní identifikátor LPIS – IDDPB nebo
číslo konkrétní katastrálního území nebo
bez stanovení konkrétního DPB - služba potom vrací všechny DPB náležící uživateli v LPISu.

V případě varianty dle bodu 3 LPIS vrátí všechny DPB zařazené do konkrétního KU. Jeden DPB může evidován být pouze v jednom KU. Nejedná se tedy o geometrický překryv. Geometrický překryv je poskytován v odpovědi služby – element PREKRYVKATUZE.

V případě varianty dle bodu 4 LPIS vrátí všechny DPB uživatele. U velkých subjektů může dojít k problémům při kombinaci s typem dat, kdy doba odezvy na zpracování odpovědi nemusí být v toleranci dané ze strany MZe a služba odpoví chybou. Konkrétní číslo KÚ je možné kombinovat s bodem 4, tj. získat DPB pouze pro konkrétní KÚ.

Povinné vstupy jsou:

GETDATA
platnost dat od do,
a oproti verzi 01A i typ dat.

Povolené hodnoty v elementu TYPDATA/TYPDATAKOD

Pro optimalizaci odezvy a velikosti odpovědi byla služba rozšířena o povinný element, který definuje jaká data se mají vrátit v odpovědi. Element je povinný a může být skládán z N typů dat. V závorce je uvedeno jaké elementy jsou v odpovědi plněny.

ZAKLAD (UZIVATEL, ZAKLADNI),
KATUZE (PREKRYVKATUZE) - překryv s katastrálním územím,
EVP (SEZNAMEVP) - seznam ekologicky významných prvků,
NS (APLPAS) - data k nitrátové směrnici,
EROZE (OPATRENIEROZE) - erozní opatření,
LFA (LFA) - začlenění do oblasti LFA,
MZP (MZP) - data k MŽP,
OPVZ (OPVZ) - překryv s ochrannými pásmy vodních zdrojů,
BPEJ (BPEJ) - klasifikace BPEJ,
ZAKLADMIN - minimalistická varianta vracených dat.
EROZE2G - napočtené hodnoty pro erozi platnou od roku 2018.

Element GETDATA

Speciálním voláním je případ, kdy na vstupu je uvedena hodnota 0 v elementu GETDATA. V tomto případě bude v odpovědi datum poslední změny v datech a nebudou vráceny žádné údaje k DPB. Tento režim je určen pro snadnější způsob administrace verzí dat na straně konzumentského systému.

Adresy serverů pro služby požadavky (requesty) na všechny služby se posílají na stejnou adresu:

testovací – https://eagritest.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx
produkční – https://eagri.cz/ssl/nosso-app/EPO/WS/v2Online/vOKOsrv.ashx

Návratové hodnoty pro různé typy dat

Odpověď služby pro konkrétní hodnotu může být různá podle hodnoty uložených dat. Pro tyto účely jsou u každého elementu k dispozici 3 možné návratové elementy:

HODNOTANUM	decimal	Hodnota údaje numerického
HODNOTAINT	int	Hodnota údaje integer
HODNOTASTR	token	Hodnota údaje textoveho

Například nadmořská výška (hodnota 186.59) bude uložena v elementu HODNOTANUM.

Informace o mapovém listu (hodnota Kralupy nad Vltavou 3-4) bude uložena v elementu HODNOTASTR.

Příslušnost k NUTS4 (hodnota 705403) bude uložena v elementu HODNOTAINT.

Další informace

Služba má v rámci definici WSDL významového hodnoty pro číselníkové položky jakými jsou např.:

pásma OPZV,
stav ekologie,
typdat,
erozní kódy a další.

Chybové kódy obecné

Služba v případě chyby v datech nebo v nekonzistenci requestu (např. nesprávná identifikace DPB nebo pokud je interval na vstupu delší než 6 měsíců vrací chybu s vysvětlením důvodů).

Interní chyby v definici některých klasifikačních údajů

Vzhledem k tomu, že mohou být některé údaje u DPB nenapočítány tak služba vrátí v elementu
CHYBA textový popis chyby.
// TVRDÉ CHYBY

T0 // nalezeno dle zaslaného zkr. kódu a čtverce k DATPLATNOST více účinných nebo historických DPB (teoretická chyba dat na straně LPIS)
T1 // nenalezen dle zkr. kódu a čtverce k DATPLATNOST žadný účinný či historický DPB
T01 // DATPLATNOST je mimo platnost kontrolovaného DPB (tj. byl nalezen dle zkráceného kódu a čtverce účinný nebo historický DPB, ale tento neplatí k DATPLATNOST)
T21 // díl dle zkr. kódu a čtverce DPB užívá jiný subjekt, než JI uvedené na vstupu (a to včetně JI převodce uvedeného v elementu DOPLNEKSUBJEKT)
T31 // dle zkr. kódu a čtverce nalezen pouze DPB ve stavu návrh
T32 // dle zkr. kódu a čtverce nalezen pouze zamítnutý návrh
T02 // v EZ záznamech je nekonzistence (teoretická chyba dat na straně LPIS)
T03 // problém v LPIS doplňkových údajích - duplicita údaje v jednom časovém řezu (teoretická chyba dat na straně LPIS)

// MĚKKÉ CHYBY

O11 // na DPB (předek, potomek) existuje návrh na změnu, který svojí účinností předchází DATPLATNOST
O12 // k danému DPB běží lhůta pro podání námitek
O13 // k danému DPB jsou podány námitky
O31 // EZ - nejistý režim ekologického hospodaření, který svojí účinností předchází DATPLATNOST