Specifikace LPI_DDP01A
Specifikace služby LPI_DDP01A (GET DETAIL DPB)
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 s využitím ws klíče pro volání webových služeb.
Cílem služby je poskytnou prostřednictvím webové služby (v XML struktuře) detailní informace ke konkrétnímu dílu půdního bloku (DPB) evidovaném v LPIS.
Vstupní parametr pro konkrétní DPB mohou být:
- čtverec+kód nebo
- interní identifikátor LPIS – IDDPB.
Dalšími vstupy jsou:
- platnost dat od do (nepovinné),
- typ dat.
Povolené hodnoty v elementu TYPDATA/TYPDATAKOD
- ZAKLAD (UZIVATEL, ZAKLADNI) – základní údaje o DPB.
- KATUZE(PREKRYVKATUZE) – překryv s katastrálním územím.
- EVP(SEZNAMEVP) – přehled ekologicky významných prvků.
- NS (UDAJENS, OPATRENINS, APLPAS) – opatření nitrátové směrnice, výměra meliorací.
- EROZE (UDAJEEROZE, OPATRENIEROZE, OPATRENIMEO) – údaje o erozi.
- LFA (LFA) – překryv s LFA oblastmi.
- EFAS
- MZP (MZP)
- OPVZ (OPVZ) – údaje týkající se ochranných pásem vodních zdrojů.
- BPEJ (BPEJ) – klasifikace BPEJ.
- AEKO (AEKOUDAJE, ENVIRO)
- AZZP – stručné údaje týkající se AZP bodů, které jsou evidována na DPB a souřadnice – pro stažení podrobných informací je nutné využít službu LPI_AZP01C
- GMO – informace o plodině a výměře pěstované plodiny
- ZEMPARCELY - informace k zemědělským parcelám nad DPB
- ZAKLADMIN - minimalistická varianta vracených dat.
- EROZE2G - napočtené hodnoty pro erozi platnou od roku 2018.
Služba umožňuje vrátit i všechny typy dat v jednom response. Nicméně obsah dat může u některých DPB být natolik rozsáhlý, že odpověď nebude poskytnuta. Doporučujeme tedy kombinovat konkrétní typy dat a nepoužívat plný rozsah.
Podrobný popis k ZEMPARCELY
Tento typ dat byl přidán v únoru 2017 na základě žádostí veřejnosti.
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