Le Geo-Zone-Tool met à disposition une API basée sur GraphQL, qui vous permet d'interroger les données des zones de neige, de vent et de séisme directement depuis vos propres applications, scripts ou processus de calcul, sans avoir à ouvrir l'interface Web.
Introduction
L'API peut être utilisée de trois manières. Pour Python et C#, des bibliothèques clientes prêtes à l'emploi sont disponibles, qui prennent automatiquement en charge l'authentification, la construction des requêtes et le traitement des réponses. Vous rédigez un appel de fonction typé dans votre langage et recevez un objet de données structuré en retour. Alternativement, vous pouvez envoyer des requêtes GraphQL directement au point de terminaison HTTPS, indépendamment du langage de programmation ou de la plateforme utilisée.
Documentation et ressources
La documentation complète de l'API avec un explorateur de schéma interactif, les requêtes disponibles et des exemples de requêtes se trouve dans la Documentation de l'API.
Authentification
Certaines requêtes, comme la liste des normes disponibles et des zones de charge d'un pays, sont utilisables sans authentification. Pour la requête des valeurs de charge calculées d'un emplacement concret, un jeton API est nécessaire, lié à votre pack Geo-Zone Tool. Ce jeton correspond à la clé API et est décrit dans la section Gestion des clés.
Pour chaque requête de charge, le contingent est réduit d'un compteur. Afin de pouvoir effectuer les requêtes de charge sans restriction, vous avez besoin d'un pack Geo-Zonen-Tool.
Démarrage rapide (Python)
Ci-dessous, nous vous montrons comment récupérer des données de zones de charge avec la bibliothèque Python. Installez d'abord la bibliothèque cliente:
pip install dlubal.api.geo-zone-tool
Pour la requête de valeurs de charge concrètes, un jeton API est nécessaire. L'exemple suivant détermine la charge de neige selon la DIN EN 1991-1-3 pour un emplacement à Munich. Les types de charge SNOW, WIND, SEISMIC et TORNADO sont actuellement disponibles:
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(
#paramètre nécessaire
address="45.985,14.734", #adresse ou coordonnées (latitude, longitude)
load_zone_type=LoadZoneType.SNOW, #WIND SNOW SEISMIC TORNADO
#paramètre optionnel
# 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}")
La réponse contient l'emplacement résolu, la zone de charge de neige attribuée et la valeur caractéristique s_k en kN/m². Sans paramètres optionnels, la carte actuelle pour l'adresse choisie est utilisée. La structure constante de la réponse permet d'utiliser le même code également pour les charges de vent et de séisme.
Munich
EN 1991-1-3 / DIN EN 1991-1-3
Zone: 1a*
s_k = 1.15