Helpful Questions & Answers

  • FAQ

10/15/2020

004774

Andreas Niemeier

General

Is it possible to display the interactive Geo-zone tool map with the load zone entries digitally as an image using a web service?

Answer

Yes, the Geo-zone tool on the website "Snow Load Zones, Wind Zones and Seismic Zones" provides a web service in the background that can be used to generate raster graphics similar to the Geo-zone tool full-screen mode website for a location on the map and a load standard without opening the website.

The web service can be used for all load maps from the visible online service and is controlled by a URL address. An external process (your application) sends the request URL address to our server (Dlubal) and receives a raster graphic as a result. To ensure the process to works, the URL address must contain all specifications for defining the parameters of a load type, load standard, geolocation, zoom level, sea level, street, ZIP code, city, state, image activation, image format, image width, image height, display language, and a user. Please note that this web service function assumes that the address data and the sea level have already been determined by the previous web service request for load data of the same geolocation, and the components of web service request for the raster image described above are therefore completed with the previously determined data. 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 "position" component. The "position" entry describes the geolocation by using the geographic coordinates in the format [latitude in °, longitude in °].

→ position=49.4354351,12.5896119

The zoom level is defined by the "zoom" component. This setting controls the zoom setting of the map itself. The map scale becomes larger if increasing the zoom level.

→ zoom=10

The sea level of the geolocation is defined by the "altitude" component. This entry specifies the sea level data in the location component of the image and is specified in the SI unit [m].

→ altitude=520

The assignment of a street and house number of the geolocation is defined by the "street" component. This entry specifies the street name in the location component of the image.

→ street=Zellweg 2

The assignment of a ZIP code of the geolocation is defined by the "zip" component. The entry specifies the postal code in the location component of the image.

→ zip=93464

The city assignment of the geolocation is defined by the "city" component. The entry specifies the city in the location component of the image.

→ zip=Tiefenbach

The state assignment of the geolocation is defined by the "state" component. In the case of the load information for the US, this entry specifies the state in the location component of the image.

→ state=NA

The image activation is defined by the "picture" component. This specification determines whether the web service displays the resulting load information of the defined geolocation as a CSV data record or as an image of the map section with the location description and load output. The image output can be activated by using the value 1.

→ picture=1

The image format is defined by the "picformat" component. The entry determines the format in which the raster image is displayed by the web service. The web service provides the formats JPG, PNG, and PDF. The format is defined by the abbreviation (jpg for the JPG format, png for the PNG format, and pdf - for the PDF format).

→ picformat=png

The image width is defined by the "width" component. The entry specifies the width of the raster image in the unit [px].

→ width=1200

The image height is defined by the "height" component. The entry controls the height of the raster image in the unit [px].

→ height=900

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 by using the "login" and "hash" components. The "login" component describes the user's e-mail address and the "hash" component describes a hidden password. To ensure the login works, it is necessary to save the e-mail address in a valid Dlubal account. The associated "hash" component is obtained in your Dlubal account.

→ login=john.doe@test.com

→ 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&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=en&login=john.doe@test.com&hash=xyz

After having sent the data, the server returns a map cutout with the address component and the load information as a raster graphic for the defined geolocation.

Image 01 - Web Service Response (Raster Graphic)

To be able to send such grid graphics to our server without any restrictions, a Geo-Zone Tool package is required. This 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 web service 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 should always ensure that the request URL with the identity components is not provided to unauthorized third parties.

Keywords

Load map Web service API Raster graphics Image

Links

Write Comment...

Write Comment...

  • Views 183x
  • Updated 11/08/2020

Contact us

Did you find your question?
If not, contact us via our free e-mail, chat, or forum support, or send us your question via the online form.

(267) 702-2815

info-us@dlubal.com