Dlubal.API.GeoZoneTool 1.0.18

Dlubal GeoZoneTool API Client

A .NET client for the Dlubal GeoZone API. It handles authentication and exposes convenience methods for load zone data, standards, screenshots, PDFs, and user info.

Install

dotnet add package Dlubal.API.GeoZoneTool

Authentication

The client accepts either JWT tokens (start with eyJ) or API tokens (start with ak-). The proper JWT or Bearer prefix is added automatically.

Quick Start

using GeoZoneTool;
using GeoZoneTool.Models;

using var client = new GeoZone("your-token");

var user = await client.GetUserDataAsync();
Console.WriteLine(user?.Email ?? "no user");

Examples

Get load zone characteristics

var characteristics = await client.GetLoadZoneCharacteristicsAsync(
    new GetZoneCharacteristicsRequest
    {
        Address = "Main St 1, Springfield",
        Type = LoadzoneTypeEnum.Snow,
        Standard = "...", // insert your standard name
        Annex = "...",    // insert your annex name
        LayerId = 1,
        Language = LanguageEnum.En
    });

Console.WriteLine(characteristics?.Code ?? "no data");

Get available standards for a country

var standards = await client.GetLoadZoneStandardsAsync(
    new GetLoadZoneStandardsRequest
    {
        CountryCode = "de",
        Language = LanguageEnum.En
    });

Console.WriteLine($"Standards groups: {standards?.Types.Count ?? 0}");

Get geolocation suggestions

var locations = await client.GetGeoLocationsAsync(
    new GetGeoLocationsRequest
    {
        Address = "Main St",
        Language = LanguageEnum.En
    });

foreach (var location in locations?.Locations ?? [])
{
    Console.WriteLine(location.DisplayName);
}

Get a load zone screenshot (base64)

var screenshot = await client.GetLoadZoneScreenshotAsync(
    new GetLoadzoneScreenshotRequest
    {
        Address = "Main St 1, Springfield",
        Type = LoadzoneTypeEnum.Wind,
        Standard = "...", // insert your standard name
        Annex = "...",    // insert your annex name
        LayerId = 1,
        LayerOrder = 0,
        Zoom = 8,
        Language = LanguageEnum.En,
        ScreenshotType = new ScreenshotTypeInput
        {
            Type = ScreenshotTypeEnum.Png,
            Quality = 90
        }
    });

Console.WriteLine($"Screenshot length: {screenshot?.Screenshot?.Length ?? 0}");

Stream PDF generation progress (base64 result)

await foreach (var progress in client.GetLoadZonePdfAsync(
    new GetPdfRequest
    {
        Address = "Main St 1, Springfield",
        Standard = "...", // insert your standard name
        Annex = "...",    // insert your annex name
        LayerId = 1,
        Language = LanguageEnum.En
    }))
{
    Console.WriteLine($"Progress: {progress.CurrentStep}/{progress.Steps}");

    if (progress.PdfResult is not null)
    {
        Console.WriteLine($"PDF name: {progress.PdfResult.Name}");
        break;
    }
}

Get ASCE 7-22 seismic design data

var result = await client.GetAsce722DataAsync(
    new GetAsce722DataRequest
    {
        Latitude = "34.05",
        Longitude = "-118.25",
        RiskCategory = RiskCategoryEnum.II,
        SiteClass = SiteClassEnum.C,
    });

var data = result?.Data;
Console.WriteLine($"Pgam: {data?.Pgam}");
Console.WriteLine($"Sds: {data?.Sds}, Sd1: {data?.Sd1}");
Console.WriteLine($"SDC: {data?.Sdc}");
Console.WriteLine($"Reference: {result?.ReferenceDocument}");

RiskCategoryEnum values: I, II, III, IV

SiteClassEnum values: Default, A, B, BC, C, CD, D, DE, E

The response Data object includes spectral parameters (Pgam, Sms, Sm1, Sds, Sd1, Ss, S1, Ts, T0, Tl, Cv, Sdc) as well as multi-period and two-period design/MCEr spectra, vertical spectra, underlying probabilistic data, and metadata (model version, Vs30, interpolation method).