Das Geo-Zone-Tool proporciona una API basada en GraphQL que le permite consultar datos de zonas de nieve, viento y sísmicas directamente desde sus propias aplicaciones, scripts o flujos de cálculo, sin necesidad de abrir la interfaz web.
Introducción
La API se puede utilizar de tres maneras. Para Python y C# están disponibles bibliotecas de cliente listas para usar, que se encargan automáticamente de la autenticación, la construcción de consultas y el procesamiento de respuestas. Usted escribe una llamada a función tipada en su lenguaje y recibe a cambio un objeto de datos estructurado. Alternativamente, puede enviar consultas GraphQL directamente al endpoint HTTPS, independientemente del lenguaje de programación o plataforma utilizada.
Documentación y recursos
La documentación completa de la API, con explorador de esquemas interactivo, consultas disponibles y ejemplos de solicitudes, se encuentra en la Documentación de la API.
Autenticación
Algunas consultas, como la lista de normas disponibles y zonas de carga de un país, se pueden utilizar sin autenticación. Para consultar los valores de carga calculados de una ubicación concreta se necesita un token de API vinculado a su paquete de Geo-Zone Tool. Este token corresponde a la clave de API y se describe en la sección Gestión de claves.
Por cada consulta de carga, el contingente se reduce en un contador. Para poder realizar consultas de carga sin restricciones, necesita un paquete de Geo-Zonen-Tool.
Inicio rápido (Python)
A continuación se muestra cómo obtener datos de zonas de carga con la biblioteca de Python. Instale primero la biblioteca de cliente:
pip install dlubal.api.geo-zone-tool
Para consultar valores de carga concretos se necesita un token de API. El siguiente ejemplo determina la carga de nieve según DIN EN 1991-1-3 para una ubicación en Múnich. Para ello están disponibles actualmente los tipos de carga SNOW, WIND, SEISMIC y 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(
#parámetros necesarios
address="45.985,14.734", #dirección o coordenadas (latitud, longitud)
load_zone_type=LoadZoneType.SNOW, #WIND SNOW SEISMIC TORNADO
#parámetros opcionales
# 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 respuesta contiene la ubicación resuelta, la zona de carga de nieve asignada y el valor característico s_k en kN/m². Sin parámetros opcionales, se utiliza el mapa actual para la dirección elegida. La estructura consistente de la respuesta permite utilizar el mismo código también para cargas de viento y sísmicas.
Munich
EN 1991-1-3 / DIN EN 1991-1-3
Zone: 1a*
s_k = 1.15