Tak, narzędzie Geo-Zones na stronie "Strefy obciążenia śniegiem, wiatrem i trzęsieniem ziemi" oferuje w tle usługę internetową, która umożliwia wygenerowanie grafiki rastrowej podobnej do trybu pełnoekranowego narzędzia Geo-Zones dla danego punktu na mapie i normy obciążenia bez otwierania strony internetowej.
Usługa internetowa może być używana dla wszystkich map obciążeniowych z widocznej usługi online i jest sterowana za pomocą adresu URL. Proces zewnętrzny (Twoja aplikacja) wysyła adres URL żądania na nasz serwer (Dlubal) i otrzymuje z powrotem grafikę rastrową jako wynik. Aby proces działał, adres URL musi zawierać wszystkie dane dotyczące definicji parametrów rodzaj obciążenia, norma obciążeniowa, pozycja geograficzna, poziom powiększenia, wysokość nad poziomem morza, ulica, kod pocztowy, miasto, stan, aktywacja obrazu, format obrazu, szerokość obrazu, wysokość obrazu, język wyjścia i użytkownik. Należy zauważyć, że funkcja sieciowa zakłada, iż dane adresowe oraz wysokość nad poziomem morza zostały już ustalone za pomocą poprzedniego zapytania usług sieciowych dotyczącego danych obciążeniowych dla tej samej pozycji geograficznej i dlatego elementy opisanego tutaj zapytania o obraz rastrowy są wypełniane wcześniej ustalonymi danymi. Ostateczny adres URL składa się z tych elementów.
Rodzaj obciążenia i norma jest definiowana za pomocą elementu "map". Pierwsza część opisuje rodzaj obciążenia (np. snow, wind czyli earthquake), a druga część normę (np. din-en-1991-1-3).
→ map=snow-din-en-1991-1-3
Pozycja geograficzna jest definiowana za pomocą elementu "position". Deklaracja "position" opisuje pozycję geograficzną przez współrzędne geograficzne w formacie [szerokość geograficzna w °, długość geograficzna w °].
→ position=49.4354351,12.5896119
Poziom powiększenia jest definiowany za pomocą elementu "zoom". Ustawienie to kontroluje ustawienie powiększenia samej mapy. Skala mapy zwiększa się wraz ze zwiększaniem poziomu powiększenia.
→ zoom=10
Wysokość nad poziomem morza jest definiowana za pomocą elementu "altitude". Deklaracja ta określa dane o wysokości nad poziomem morza w bloku lokalizacji obrazu i jest podawana w jednostce SI [m].
→ altitude=520
Przypisanie ulicy i numeru domu do pozycji geograficznej jest definiowane za pomocą elementu "street". Deklaracja ta określa nazwę ulicy w bloku lokalizacji obrazu.
→ street=Zellweg 2
Przypisanie kodu pocztowego do pozycji geograficznej jest definiowane za pomocą elementu "zip". Deklaracja ta określa kod pocztowy w bloku lokalizacji obrazu.
→ zip=93464
Przypisanie miasta do pozycji geograficznej jest definiowane za pomocą elementu "city". Deklaracja ta określa miasto w bloku lokalizacji obrazu.
→ city=Tiefenbach
Przypisanie stanu do pozycji geograficznej jest definiowane za pomocą elementu "state". Deklaracja ta określa stan w bloku lokalizacji obrazu w przypadku informacji o obciążeniu dla USA.
→ state=NA
Aktywacja obrazu jest definiowana za pomocą elementu "picture". Deklaracja ta kontroluje, czy usługa internetowa wyświetla informacje o obciążeniu z określonej pozycji geograficznej jako zestaw danych CSV lub obraz wycinka mapy z opisem lokalizacji i wyjściem obciążenia. Aby aktywować wyjście obrazów, użyj wartości 1.
→ picture=1
Format obrazu jest definiowany za pomocą elementu "picformat". Deklaracja ta kontroluje, w jakim formacie usługa internetowa wyświetla obraz rastrowy. Usługa oferuje tutaj formaty JPG, PNG i PDF. Format jest określany za pomocą skrótu (jpg - format JPG, png - format PNG i pdf - format PDF).
→ picformat=png
Szerokość obrazu jest definiowana za pomocą elementu "width". Deklaracja ta określa szerokość obrazu rastrowego w jednostce [px].
→ width=1200
Wysokość obrazu jest definiowana za pomocą elementu "height". Deklaracja ta określa wysokość obrazu rastrowego w jednostce [px].
→ height=900
Język wyjścia wyników jest definiowany za pomocą elementu "language". Język jest określany za pomocą skrótu (de - niemiecki, en - angielski, itd.)
→ language=de
Tożsamość użytkownika jest definiowana za pomocą elementów "login" i "hash". Element "login" opisuje adres e-mail użytkownika, a element "hash" to ukryte hasło. Aby zalogowanie było funkcjonalne, adres e-mail musi być zapisany na ważnym koncie Dlubal. Odpowiedni element "hash" można znaleźć na swoim koncie Dlubal.
→ hash=xyz
Z tych elementów można ostatecznie wygenerować adres URL żądania i wysłać go na nasz serwer.
→ https://external-crm.dlubal.com/loadzones/data.aspx?map=snow-din-en-1991-1-3&position=49.4354351,12.5896119&zoom=10&altitude=520&street=Zellweg 2&zip=93464&zip=Tiefenbach&picture=1&picformat=png&width=1200&height=900&language=de&[email protected]&hash=xyz
Po wysłaniu nasz serwer zwróci wycinek mapy z adresem oraz informacją o obciążeniu jako grafikę rastrową dla zdefiniowanej pozycji geograficznej. Można również dodać następujący element "hash" do pobrania obrazu:
→ download=1
Element hash "mapareaonly" zapewnia, że używana jest wyłącznie mapa. Aby dostosować wycięcie obrazu, można użyć elementów "cropwidth" i "cropheight".
→ mapareaonly=1 → cropwidth=1000 → cropheight=720
Aby móc nieograniczenie wysyłać takie grafiki rastrowe na nasz serwer, potrzebny jest pakiet narzędzi Geo-Zones. Taki pakiet narzędzi Geo-Zones zawiera określony kontyngent zapytań o dane. Każde zapytanie zmniejsza kontyngent o jeden licznik.
Ponieważ usługa internetowa zużywa zakupiony kontyngent, konieczne jest ostrożne obchodzenie się z elementami tożsamości i adresem URL żądania w kontekście ochrony danych. Należy np. upewnić się, że program nie udostępnia adresu URL żądania z elementami tożsamości nieupoważnionym stronom trzecim.