Geo-Zone Tool Public API

A GraphQL API that returns structural load zone data, geographical characteristics, and PDF reports for any coordinates worldwide.

Web Application

The GeoZone Tool is also available as an interactive web application at dlubal.com. Pick any location on the map to instantly view all structural load zone values.

GeoZone web application

Client SDKs (Python and C#)

Official client libraries are available for Python and .NET. Both packages wrap the GeoZone Tool GraphQL API and provide typed models for requests and responses.

Python (PyPI)

Package: dlubal.api.geo-zone-tool. Import path in code: from dlubal.api import geo_zone_tool.

python -m pip install dlubal.api.geo-zone-tool

C# (.NET / NuGet)

Package: Dlubal.API.GeoZoneTool. The client exposes async methods for API queries and PDF subscription progress.

dotnet add package Dlubal.API.GeoZoneTool

# or in a .csproj file
<PackageReference Include="Dlubal.API.GeoZoneTool" Version="1.0.14" />

Authentication

Most queries require a Bearer token passed in the Authorization header:

Queries marked Public do not require authentication. All others consume one API credit per request.

Load Zone Characteristics

Accepts a free-text address and optional filters — type, standard, annex, and layerId — to narrow results to a specific zone type or country annex. Returns resolved address details, the matched zone value, and an ordered list of structural load characteristics grouped by standard and annex.

The code field can be OK, COUNTRY_CHANGED (server auto-selected a more appropriate standard), ANNEX_CHANGED, or ERROR.

Snow zones

Wind zones

Seismic zones

query {
  getLoadZoneCharacteristics(
    input: {
      address: "Munich, Germany"
      type: SNOW
      standard: "EN 1991-1-3"
      annex: "Germany"
      layerId: 1
    }
    language: EN
  ) {
    code
    message
    geoLocation {
      latitude longitude altitude
      street zip city state country countryCode
    }
    characteristics {
      standard
      annex
      zoneCharacteristics {
        id
        zone { value }
        characteristics {
          name calculatedValue
          nameHtml unitsHtml description
          decimalPlaces sequence
        }
      }
    }
    noLiability
  }
}

Geo Locations

Geocoding lookup — converts a free-text address into coordinate results. Accepts optional sortCountryCode to prioritize results for a given country. No authentication required. Returns up to 10 ranked results with street, city, state, country, postalCode, and decimal coordinates.

Address search

query {
  getGeoLocations(
    address: "Altdorf, Uri, Switzerland"
    sortCountryCode: "CH"
    language: EN
  ) {
    latitude longitude altitude
    displayName street zip city state country countryCode
  }
}

Load Zone Screenshot

Generates a map screenshot centred on latitude and longitude as a base64-encoded PNG or JPEG. Useful for embedding zone maps in reports or dashboards.

query {
  getLoadZoneScreenshot(
    input: {
      address: "Munich, Germany"
      type: SNOW
      standard: "EN 1991-1-3"
      annex: "Germany"
      layerId: 1
      zoom: 8
      screenshotType: { type: PNG quality: 90 }
    }
    language: EN
  )
}

Load Zone Standards

Returns the full hierarchy of load zone types, standards, national annexes, and layers available for a given country code. Use this to populate selectors or discover valid standard, annex, and layer combinations.

query {
  getLoadZoneStandards(
    countryCode: "DE"
    language: EN
  ) {
    name
    standards {
      name
      annexes {
        name
        actual
        layers { id name }
      }
    }
  }
}

Available Load Zones

Returns a compact list of load zones grouped by type — ideal for discovering valid loadZoneId / layerId pairs.

query {
  findLoadzones(
    countryCode: "DE"
    language: EN
  ) {
    country
    countryCode
    typeGroups {
      name
      loadzones {
        standard annex loadzoneId
        layers { id name }
      }
    }
  }
}

User Data

Returns the authenticated user's email, credit balance, and remaining clicks count for the current billing period.

query {
  getUserData {
    email
    clicks
  }
}

ASCE 7-22 Seismic Data

Proxies the USGS Seismic Design Web Services (https://earthquake.usgs.gov/ws/designmaps/asce7-22.html). Returns ASCE 7-22 seismic design map parameters for a given latitude/longitude, risk category, and site class. Includes spectral acceleration values (Ss, S1, SDS, SD1), design spectra, and seismic design category (SDC).

query {
  getAsce722(
    latitude: 34.05
    longitude: -118.25
    riskCategory: II
    siteClass: DEFAULT
  ) {
    code
    message
    referenceDocument
    data {
      ss s1 sds sd1 sdc
      pgam sms sm1 ts t0 tl cv
      twoPeriodDesignSpectrum { periods ordinates }
      twoPeriodMcErSpectrum   { periods ordinates }
    }
  }
}

PDF Report Progress

Generates a full load zone PDF report over a WebSocket connection (GraphQL subscriptions via graphql-ws). The server streams progress updates; the final message contains the base64-encoded PDF and a suggested filename.

WebSocket endpoint: wss://api-gateway.dlubal.com/geo-zone/pub/graphql

subscription {
  getPdf(
    pdfInput: {
      address: "Munich, Germany"
      standard: "EN 1991-1-3"
      annex: "Germany"
      layerId: 1
    }
    language: EN
  ) {
    currentStep
    steps
    message
    pdfResult { pdf name }
  }
}

Enums

LanguageEnum

LoadzoneTypeEnum

RiskCategoryEnum

SiteClassEnum

ScreenshotTypeEnum

Input Types

CharacteristicsInput

GetLoadzoneScreenshotPublicInput

ScreenshotTypeInput

GetLoadzonePdfInput

Output Types

CharacteristicsResponseMiaType

CharacteristicsLoadzoneType2

CharacteristicsLayerType2

CharacteristicsVariableType

GeofinderDataType

GeoLocationType

UserDataType

LoadzoneGroupShortType

LoadzoneShortType

Asce722ResponseType

Asce722DataType

SpectrumType

PdfProgressType

PdfResultType