Geo-Zone Tool Public API

Eine GraphQL-API, die strukturelle Lastzonen-Daten, geografische Eigenschaften und PDF-Berichte für beliebige Koordinaten weltweit liefert.

Webanwendung

Das GeoZone Tool ist auch als interaktive Webanwendung verfügbar unter dlubal.com. Wählen Sie einen beliebigen Standort auf der Karte, um sofort alle strukturellen Lastzonenwerte anzuzeigen.

GeoZone-Webanwendung

Client-SDKs (Python und C#)

Offizielle Client-Bibliotheken sind für Python und .NET verfügbar. Beide Pakete kapseln die GeoZone-Tool-GraphQL-API und liefern typisierte Modelle für Anfragen und Antworten.

Python (PyPI)

Paket: dlubal.api.geo-zone-tool. Importpfad im Code: from dlubal.api import geo_zone_tool.

pip install dlubal.api.geo-zone-tool>=0.1.0

C# (.NET / NuGet)

Paket: Dlubal.API.GeoZoneTool. Der Client stellt asynchrone Methoden für API-Abfragen und PDF-Subscription-Fortschritt bereit.

dotnet add package Dlubal.API.GeoZoneTool

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

Authentifizierung

Die meisten Abfragen erfordern einen API-Schlüssel, der als Bearer-Token im Authorization-Header übergeben wird. Verwenden Sie Ihren DLUBAL_AK_TOKEN als Token-Wert:

Mit Öffentlich gekennzeichnete Abfragen erfordern keine Authentifizierung. Alle anderen verbrauchen ein API-Guthaben pro Anfrage.

Der API-Zugriff ist pro Konto begrenzt, um Serverkosten zu verwalten. Kostenlose Konten erhalten eine begrenzte Anzahl an Abfragen ohne Berechnung. Im Dlubal-Webshop sind kostenpflichtige Pakete mit 500 oder 5.000 Abfragen erhältlich.

API-Schlüssel erhalten oder Paket verwalten →Abfragepaket kaufen →

Lastzonen-Kennwerte

Akzeptiert einen Freitext address und optionale Filter — type, standard, annex und layerId — um die Ergebnisse auf einen bestimmten Zonentyp oder Länderanhang einzuschränken. Gibt aufgelöste Adressdetails, den übereinstimmenden Zonenwert und eine geordnete Liste von Tragwerkslastmerkmalen zurück, gruppiert nach Norm und Anhang.

Das Feld code kann OK, COUNTRY_CHANGED (der Server hat automatisch einen geeigneteren Standard gewählt), ANNEX_CHANGED oder ERROR sein.

Schneelastzonen

Windlastzonen

Erdbebengebiete

query {
  getLoadZoneCharacteristics(
    input: {
      address: "Berlin, Germany"
      type: SNOW
      standard: "EN 1991-1-3"
      annex: "DIN EN 1991-1-3"
      layerId: 1
    }
    language: DE
  ) {
    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
  }
}

Geostandorte

Geocoding-Suche – wandelt eine Freitext-address in Koordinatenergebnisse um. Akzeptiert optional sortCountryCode zur Priorisierung der Ergebnisse für ein bestimmtes Land. Keine Authentifizierung erforderlich. Gibt bis zu 10 gerankte Ergebnisse mit street, city, state, country, postalCode und Dezimalkoordinaten zurück.

Adresssuche

query {
  getGeoLocations(
    address: "Berlin, Germany"
    sortCountryCode: "DE"
    language: DE
  ) {
    latitude longitude altitude
    displayName street zip city state country countryCode
  }
}

Lastzonen-Screenshot

Erstellt einen Kartenausschnitt zentriert auf latitude und longitude als base64-kodiertes PNG oder JPEG. Nützlich für die Einbettung von Zonenkarten in Berichte oder Dashboards.

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

Lastzonen-Normen

Gibt die vollständige Hierarchie der Lastzontypen, Normen, nationalen Anhänge und Schichten zurück, die für einen bestimmten Ländercode verfügbar sind. Verwenden Sie dies, um Auswahlfelder zu befüllen oder gültige Kombinationen aus Norm, Anhang und Schicht zu ermitteln.

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

Verfügbare Lastzonen

Gibt eine kompakte Liste von Lastzonen gruppiert nach Typ zurück – ideal zum Ermitteln gültiger loadZoneId / layerId-Paare.

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

Benutzerdaten

Gibt die email, das Guthaben und die verbleibende clicks-Anzahl des authentifizierten Benutzers für den aktuellen Abrechnungszeitraum zurück.

query {
  getUserData {
    email
    clicks
  }
}

ASCE 7-22 Erdbebendaten

Leitet Anfragen an die USGS Seismic Design Web Services weiter (https://earthquake.usgs.gov/ws/designmaps/asce7-22.html). Gibt ASCE 7-22 seismische Bemessungskartenparameter für einen gegebenen Breiten-/Längengrad, eine Risikoklasse und eine Standortklasse zurück. Enthält spektrale Beschleunigungswerte (Ss, S1, SDS, SD1), Bemessungsspektren und die Erdbebenbemessungskategorie (SDC).

query {
  getAsce722(
    latitude: "34.05"
    longitude: "-118.25"
    riskCategory: II
    siteClass: DEFAULT
  ) {
    code
    message
    referenceDocument
    geoLocation {
      latitude longitude altitude
      street zip city state country countryCode
    }
    data {
      ss s1 sds sd1 sdc
      pgam sms sm1 ts t0 tl cv
      multiPeriodDesignSpectrum { periods ordinates }
      twoPeriodDesignSpectrum   { periods ordinates }
      metadata { modelVersion vs30 }
    }
  }
}

PDF-Berichtsfortschritt

Erstellt einen vollständigen Lastzonen-PDF-Bericht über eine WebSocket-Verbindung (GraphQL-Subscriptions via graphql-ws). Der Server streamt Fortschrittsmeldungen; die letzte Nachricht enthält das base64-kodierte PDF und einen vorgeschlagenen Dateinamen.

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

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

Enumerationen

LanguageEnum

LoadzoneTypeEnum

RiskCategoryEnum

SiteClassEnum

ScreenshotTypeEnum

Eingabetypen

CharacteristicsInput

GetLoadzoneScreenshotPublicInput

ScreenshotTypeInput

GetLoadzonePdfInput

Ausgabetypen

CharacteristicsResponseMiaType

CharacteristicsLoadzoneType2

CharacteristicsLayerType2

CharacteristicsVariableType

GeofinderDataType

GeoLocationType

UserDataType

LoadzoneGroupShortType

LoadzoneShortType

Asce722ResponseType

Asce722DataType

SpectrumType

PdfProgressType

PdfResultType