Dotaz:
Lze přistupovat k online službě pro stanovení oblastí zatížení sněhem, větrem a zemětřesením také digitálně prostřednictvím rozhraní API nebo webové služby?
Odpověď:
Ano, online služba pro stanovení oblastí zatížení sněhem, větrem a zemětřesením nabízí webovou službu na pozadí pro určování zatížení specifických pro danou lokalitu bez otevření webové stránky.
Webová služba může být použita pro všechny mapy zatížení z viditelné online služby a je řízena pomocí URL adresy. Externí proces (Vaše aplikace) přitom odešle na náš server (Dlubal) URL adresu požadavku a jako výsledek obdrží informaci o zatížení ve formátu CSV. Aby proces fungoval, musí URL adresa obsahovat veškeré údaje pro zadání typu zatížení, normy, geopozice, výstupního jazyka a uživatele. Konečná URL se poté skládá z těchto parametrů.
Typ zatížení a norma se definují pomocí parametru "map". 1. část přitom popisuje typ zatížení (např. sníh, vítr, zemětřesení) a 2. část normu (např. din-en-1991-1-3).
→ map=snow-din-en-1991-1-3
Geopozice je definována parametrem "place" nebo "position". Parametr "place" pracuje stejně jako vyhledávač ve viditelné online službě. Pomocí vyhledávacích výrazů, adresy atd. se stanoví geopozice. Parametr "position" definuje geografickou polohu zeměpisnými souřadnicemi ve formátu [zeměpisná šířka ve °, zeměpisná délka ve °].
→ place=messe, düsseldorf
→ position=51,2624991,6,735927199999992
Výstupní jazyk výsledků je definován parametrem "language". Jazyk je přitom označen zkratkou (de - němčina, en - angličtina atd.).
→ language=de
Identita uživatele je definována parametry "login" a "hash". Přitom komponenta "login" popisuje e-mailovou adresu uživatele a komponenta "hash" skryté heslo. Pro funkční přihlášení je třeba e-mailovou adresu uložit na platný účet Dlubal. Příslušný parametr "hash" Vám můžeme na požádání zaslat.
→ hash=xyz
Z těchto parametrů lze nakonec vygenerovat URL požadavku a odeslat na náš server.
→ https://external-crm.dlubal.com/loadzones/data.aspx?map=snow-din-en-1991-1-3&place=messe, düsseldorf&language=de&[email protected]&hash=xyz
Při odesílání server vrátí požadované informace o zatížení ve formátu CSV.
Pro neomezené odesílání dotazů na náš server je zapotřebí balíček Geo-Zone Tool. Tento balíček nástrojů pro stanovení oblastí zatížení obsahuje určitý počet dotazů na data. Při každém dotazu se dané množství dotazů v datovém balíčku sníží o jeden.
→ https://www.dlubal.com/cs/podpora-a-skoleni/servis/nastroj-pro-stanoveni-oblasti-zatizeni
Protože je webová služba propojená se zakoupeným datovým balíčkem, je nutné opatrně zacházet s parametry identity a URL adresou požadavku z hlediska ochrany osobních údajů. Je třeba se například ujistit, že váš program nevytváří URL adresu požadavku s identifikačními parametry jako neoprávněná třetí strana.
