get_load_zone_characteristics#

Type: Query | Auth Required: Yes

Accepts a free-text address and filters — load_zone_type, standard, annex, and layer_id — 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 response code field can be OK, COUNTRY_CHANGED, ANNEX_CHANGED, or ERROR.

from dlubal.api.geo_zone_tool import GeoZoneTool, Language, LoadZoneType

gzt = GeoZoneTool(token="YOUR_TOKEN")

result = gzt.get_load_zone_characteristics(
    address="Munich, Germany",
    load_zone_type=LoadZoneType.SNOW,
    standard="EN 1991-1-3",
    annex="Germany",
    layer_id=1,
    language=Language.EN,
)

print(result.code)
print(result.geo_location.city)
for chars in result.characteristics:
    print(f"{chars.standard} / {chars.annex}")
    zone = chars.zone_characteristics
    print(f"  Zone: {zone.zone.value}")
    for c in zone.characteristics:
        print(f"  {c.name} = {c.calculated_value}")

using Dlubal.API.GeoZoneTool;

var gzt = new GeoZoneToolClient("YOUR_TOKEN");

var result = await gzt.GetLoadZoneCharacteristicsAsync(
    address: "Munich, Germany",
    loadZoneType: LoadZoneType.Snow,
    standard: "EN 1991-1-3",
    annex: "Germany",
    layerId: 1,
    language: Language.En
);

Console.WriteLine(result.Code);
Console.WriteLine(result.GeoLocation.City);
foreach (var chars in result.Characteristics)
{
    Console.WriteLine($"{chars.Standard} / {chars.Annex}");
    var zone = chars.ZoneCharacteristics;
    Console.WriteLine($"  Zone: {zone.Zone.Value}");
    foreach (var c in zone.Characteristics)
    {
        Console.WriteLine($"  {c.Name} = {c.CalculatedValue}");
    }
}

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
  }
}

Input#

Parameter	Type	Required	Description
`address`	str	Yes	Free-text address or place name
`load_zone_type`	LoadZoneType	Yes	Zone type (SNOW, WIND, EARTHQUAKE, TORNADO)
`standard`	str	Yes	Standard name (e.g. “EN 1991-1-3”)
`annex`	str	Yes	National annex name (e.g. “Germany”)
`layer_id`	int	Yes	Layer ID within the standard
`language`	Language	No	Response language (default EN)

Response#

Returns CharacteristicsResponseMiaType with resolved location, zone value, and load characteristics.