Seznam dílů půdních bloků (GET DPB - s filtrací na subjekt)
(LPI_GDP11B)

Povinné vstupní parametry jsou platnost OD, DO a GETDATA. 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.

Vstupní data

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

1. čtverec+kód nebo
2. interní identifikátor LPIS – IDDPB nebo
3. číslo konkrétního katastrálního území,
4. 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 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 služby 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ý vstupní 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. Tento typ dat vrací i erozní pozemky (element EROZENIPOZEMKY v odpovědi), které má subjekt v LPIS zakresleny.
• EROZE3G - napočtené hodnoty pro erozi platnou od roku 2025 (od podzimních osevů 2024 včetně). Tento typ dat vrací i erozní pozemky (element EROZENIPOZEMKY v odpovědi), které má subjekt v LPIS zakresleny.
• UPOB - uzavřené pěstební oblasti.
• HON - překryv DPB s vrstvou honiteb, kdy služba vrací i odpovídající obec s rozšířenou působností konkrétní honitby.
• NEPRODPLOCHY - jedná se o data překryvu DPB s neprodukčními plochami (pásem kolem vod pro ekoplatbu).

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 změny v datech na straně konzumentského systému.

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ší.

Vysvětlení pojmů k erozní ohroženosti - EROZE3G

SEO - Silně erozně ohrožená půda
MEO-VR - Mírně erozně ohrožená půda s vyšším rizikem
MEO-NR- Mírně erozně ohrožená půda s nižším rizikem
NEO- Neohrožená

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 // K datu DATDO v requestu nebo k aktuálnímu dni pokud není DATDO vyplněno, existuje na daném DPB návrh na jeho změnu. Po zpracování připravené změny u DPB s chybou O11 může dojít ke změně platnosti DPB a návazných údajů (svažitost, nadm. výška, atd) u DPB a to do minulosti.

  Konkrétní příklad lze popsat následovně:

  WS LPIS vrátí k 10.10.2017 DPB <ns2:IDDPB>99000453</ns2:IDDPB> s chybou O11. Dne 11.10.2017 dojde ke zpracování změny na DPB a vznikne nástupce DPB 99000453 s IDDPB 99000454. Účinnost 99000454 bude od 1.1.2017. U DPB 99000453 již bude WS vracet tento DPB jako historický s platností do 31.12.2016 a návazné údaje budou také ukončeny k 31.12.2016.

  WS LPIS budou DPB 99000453 vracet jako historický i pro všechny dny od 1.1.2017 do 11.10.2017 (tedy i pro opakované volání WS  v tomto intervalu) - DPB se stane zpětně historický a případné navázané činnosti provedené v roce 2017 je nutné převěsit na jiný DPB.

• O12 // k danému DPB běží lhůta pro podání námitek
  Nebyla-li podána námitka do 20 dnů od doručení příslušného oznámení o provedení/neprovedení změny v LPIS poslednímu účastníku řízení, tento příznak zmizí z důvodu marného uběhnutí lhůty pro podání námitky.
• O13 // vůči oznámení o provedení/neprovedení změny v LPIS byla podána námitka. DPB dotčené touto námitkou jsou označeny chybou O13. Výsledek námitkového řízení může být:
  1. vyhověno
     • konkrétní DPB může být zrušen nebo zamítnut. WS LPIS přestane tedy tento DPB zpětně poskytovat. Pokud existoval předek pro zrušení DPB tento bude nově poskytován jako účinný s chybou O11.
     • konkrétní DPB může být zúčinněn, ale s jinými údaji - např. jiný subjekt, jiná výměra, účinnost dle § 3g, apod.
  2. může být stažena
     • dojde pouze ke zrušení chyby O13 u DPB a DPB zůstane v nezměněném stavu.
  3. nevyhověno
     • dojde pouze ke zrušení chyby O13 u DPB a DPB zůstane v nezměněném stavu.
• O14 // daný DPB se nachází v řízení, jehož datum zahájení je menší než datum DATDO a v takovém řízení se nachází dokument bez vyplněného Data doručení. Informace podá případně SZIF. Dopady mohou být obdobné jako u O11.
• O31 // EZ - na DPB byla změněna geometrie nebo byla u subjektu ukončena registrace. Na DPB je nastaven nejistý režim ekologického hospodaření, který svojí účinností předchází DATDO z requestu WS.