Ano, online služba "Oblasti zatížení sněhem, větrem a zemětřesením" nabízí na pozadí webovou službu pro stanovení zatížení specifických pro danou lokalitu bez nutnosti otevřít webovou stránku.
Webovou službu lze použít 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 URL požadavku na náš server (Dlubal) a jako výsledek obdrží informace o zatížení ve formátu CSV. Aby proces fungoval, musí URL adresa obsahovat veškeré údaje pro definici typu zatížení, normy, geopozice, výstupního jazyka a uživatele. Výsledná URL se pak skládá z těchto částí.
Typ zatížení a norma se definuje pomocí části "map". První část přitom popisuje typ zatížení (např. snow, wind nebo earthquake) a druhá část normu (např. din-en-1991-1-3).
→ map=snow-din-en-1991-1-3
Geopozice se definuje pomocí části "place" nebo "position". Možnost "place" přitom reaguje stejně jako možnost hledání ve viditelné online službě. Zde se geopozice určuje pomocí hledaných výrazů, adresy apod. Možnost "position" definuje geopozici pomocí geografických souřadnic 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ů se definuje pomocí části "language". Jazyk se přitom určuje pomocí zkratky (de - němčina, en - angličtina atd.)
→ language=de
Identita uživatele se definuje pomocí částí "login" a "hash". Část "login" přitom popisuje e-mailovou adresu uživatele a část "hash" skryté heslo. Pro funkční přihlášení musí být e-mailová adresa uložena v platném účtu Dlubal. Příslušná část "hash" je uvedena v účtu Dlubal v rubrice "Moje údaje" - "Identita online služby".
→ [email protected] → hash=xyz
Z těchto částí lze pak sestavit výslednou URL požadavku a odeslat ji 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
Po odeslání vrátí náš server požadovanou informaci o zatížení ve formátu CSV.
Aby bylo možné neomezeně odesílat dotazy na zatížení na náš server, je zapotřebí balíček nástrojů Geo-Zones. Takový balíček nástrojů Geo-Zones obsahuje určitý kontingent dotazů na zatížení. S každým dotazem na zatížení se kontingent sníží o jeden.
Protože webová služba zatěžuje zakoupený kontingent, je nutné s částmi identity a URL požadavku zacházet opatrně z hlediska ochrany dat. Je např. třeba dbát na to, aby váš program nezobrazoval URL požadavku s částmi identity neoprávněné třetí straně.
Navazující FAQ k nástroji Geo-Zones a API: