Narzędzie Geo-Zone-Tool udostępnia API oparte na GraphQL, umożliwiające bezpośrednie pobieranie danych o strefach obciążenia śniegiem, wiatrem i sejsmicznego z własnych aplikacji, skryptów lub procesów obliczeniowych, bez konieczności otwierania interfejsu internetowego.
Pierwsze kroki
API można wykorzystywać na trzy sposoby. Dla języków Python i C# dostępne są gotowe biblioteki klienckie, które automatycznie obsługują uwierzytelnianie, tworzenie zapytań i przetwarzanie odpowiedzi. Wykonujesz typizowane wywołanie funkcji w swoim języku i otrzymujesz w zamian ustrukturyzowany obiekt danych. Alternatywnie możesz wysyłać zapytania GraphQL bezpośrednio do punktu końcowego HTTPS, niezależnie od używanego języka programowania lub platformy.
Dokumentacja i zasoby
Pełną dokumentację API z interaktywnym eksploratorem schematów, dostępnymi zapytaniami i przykładowymi żądaniami znajdziesz w Dokumentacji API.
Uwierzytelnianie
Niektóre zapytania, na przykład lista dostępnych norm i stref obciążenia dla danego kraju, są dostępne bez uwierzytelniania. Do pobrania obliczonych wartości obciążenia dla konkretnej lokalizacji wymagany jest token API powiązany z Twoim pakietem Geo-Zone Tool. Ten token odpowiada kluczowi API i został opisany w sekcji Zarządzanie kluczami.
Każde zapytanie o obciążenie zmniejsza limit o jeden licznik. Aby móc wykonywać zapytania o obciążenie bez ograniczeń, potrzebujesz pakietu Geo-Zone Tool.
Szybki start (Python)
Poniżej pokazano, jak pobrać dane o strefach obciążenia za pomocą biblioteki Python. Najpierw zainstaluj bibliotekę kliencką:
pip install dlubal.api.geo-zone-tool
Do pobrania konkretnych wartości obciążenia wymagany jest token API. Poniższy przykład określa obciążenie śniegiem według DIN EN 1991-1-3 dla lokalizacji w Monachium. Obecnie dostępne są następujące typy obciążenia: SNOW, WIND, SEISMIC i TORNADO:
from dlubal.api import geo_zone_tool
from dlubal.api.geo_zone_tool import LoadZoneType, Language
gzt = geo_zone_tool.GeoZoneTool("")
result = gzt.get_load_zone_characteristics(
#parametry wymagane
address="45.985,14.734", #adres lub współrzędne (szerokość geograficzna, długość geograficzna)
load_zone_type=LoadZoneType.SNOW, #WIND SNOW SEISMIC TORNADO
#parametry opcjonalne
# standard="EN 1991-1-3",
# annex="Germany",
# layer_id=1,
# language=Language.EN
)
#print(result)
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}")
Odpowiedź zawiera rozpoznaną lokalizację, przypisaną strefę obciążenia śniegiem i wartość charakterystyczną sk w kN/m². W przypadku braku parametrów opcjonalnych używana jest bieżąca mapa dla wybranego adresu. Spójna struktura odpowiedzi umożliwia użycie tego samego kodu również dla obciążeń wiatrem i sejsmicznych.
Munich
EN 1991-1-3 / DIN EN 1991-1-3
Zone: 1a*
s_k = 1.15