5643x
002639
17.1.2020

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. Komponenta "hash" je spravována v Dlubal účtu v sekci "Moje údaje" - "Identita online služby".

[email protected]

→ 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. Balíček Geo-Zone Tool obsahuje určité stanovené množství možných dotazů ma zatížení. 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.

 


Autor

Ing. Niemeier je zodpovědný za vývoj hlavních programů RFEM, RSTAB, RWIND a oblast membránových konstrukcí. Zároveň má na starosti řízení jakosti a podporu zákazníkům.