5638x
002639
2020-01-17

Question

Is it possible also to access the online service "Snow Load, Wind Speed, and Seismic Load Maps" digitally via API or Webservice?


Answer:

Yes, the online service "Snow Load, Wind Speed, and Seismic Load Maps" provides Webservice in the background that can be used to determine the loads specific to a location without opening the website.

Webservice can be used for all load maps from the visible online service and is controlled by a URL address. In this case, an external process (your application) sends a request URL address to our server (Dlubal) and receives the load information in the CSV format. To ensure that the process works, the URL address must contain all specifications for defining a load type, standard, geolocation, output language, and user. The final URL is then composed of these components.

The load type and the standard are defined by the "map" component. The first part describes the load type (for example, snow, wind, or earthquake) and the second part describes the standard (for example, din‑en‑1991‑1‑3).

→ map=snow-din-en-1991-1-3

The geolocation is defined by the "place" or "position" component. The "place" option acts as the search option in the visible online service. The geolocation is defined here by the search terms, address, and so on. The "position" option defines the geolocation by using the geographic coordinates in the format [latitude in °, longitude in °].

→ place=messe, duesseldorf

→ position=51.2624991,6.735927199999992

The display language of the results is defined by the "language" component. The language is defined by an abbreviation (de - German, en - English, and so on).

→ language=en

The identity of the user is defined using the "login" and "hash" components. The "login" component describes the user's email address and the "hash" component describes a hidden password. To ensure that the login works, it is necessary to save the email address in a valid Dlubal account. The corresponding "hash" component is specified in the Dlubal account under "My Data" - "Online Service Identity".

[email protected]

→ hash=xyz

A request URL can finally be generated from these components and sent to our server.

→ https://external-crm.dlubal.com/loadzones/data.aspx?map=snow-din-en-1991-1-3&place=messe, duesseldorf&language=en&[email protected]&hash=xyz

After having sent the data, the server returns the requested load information in the CSV format.

To be able to send the load requests to our server without restrictions, a Geo-Zone Tool package is required. The Geo-Zone Tool package includes a certain number of data requests. Each query reduces the number of available requests purchased within the package.

https://www.dlubal.com/en-US/support-and-learning/service/geo-zone-tool-snow-wind-and-seismic-zone-maps

Since the webservice is linked with the purchased data package, it is necessary to deal carefully with the identity components and request URL with regard to data protection. For example, you have to be careful not to provide the request URL with identity components to unauthorized third parties.

 


Author

Mr. Niemeier is responsible for the development of RFEM, RSTAB, RWIND Simulation, and in the area of membrane structures. He is also responsible for quality assurance and customer support.