Calcs.com API

GIS - Environmental Loads

Endpoint:https://api.calcs.com

Unified endpoint for all environmental design loads (wind, snow, seismic) based on location. Automatically detects country and applicable datasets.

Get Environmental Loads

GET

https://api.calcs.com

/gis/environmental_loads

Returns all applicable environmental design loads (wind, snow, seismic) for a given location in a single request.

Key Benefits:

Supported Countries:

Optional Parameters:

Response: Unified object with wind, snow, seismic loads plus metadata about which datasets were used.

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84). Example: 40.7128 for New York City
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84). Example: -74.0060 for New York City
countrystring · enum
Optional ISO 3166-1 alpha-2 country code to override auto-detection
Enum values:
US
SE
NO
DK
GB
ES
KE
include_windboolean
Include wind load data in response (default: true)
Default: true
include_snowboolean
Include snow load data in response (default: true)
Default: true
include_seismicboolean
Include seismic load data in response (default: true)
Default: true
include_elevationboolean
Include elevation data in response (default: false)
Default: false
include_roughnessboolean
Include terrain roughness data in response (default: false)
Default: false
risk_categoriesstring
Comma-separated list of risk categories for US wind (e.g., 'rc2,rc3'). If omitted, returns all categories.
seismic_risk_categorystring · enum
Risk category for USGS seismic data (US only). Default: II
Enum values:
I
II
III
IV
Default: II
seismic_standardstring · enum
Design standard for USGS seismic data (US only). Default: ASCE 7-22
Enum values:
ASCE 7-16
ASCE 7-22
Default: ASCE 7-22
seismic_site_classstring · enum
Site class for USGS seismic data (US only). Default: D. Note: ASCE 7-16 uses A, B, B-estimated, C, D-default, D, E. ASCE 7-22 uses A, B, BC, C, CD, D, DE, E.
Enum values:
A
B
BC
C
CD
D
DE
E
Default: D

Authorizationstring · required
The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Environmental loads for the specified location

locationobject · required
windobject[] · required
Wind load values (array for multiple risk categories, null if unavailable)
snowobject · required
Snow load value (null if unavailable for location)
seismicobject · required
Seismic design values (null if unavailable for location)
_warningsstring[] · required
Warnings about missing or unavailable data
_metadataobject · required