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, tornado, snow, seismic) for a given location in a single request.

Key Benefits:

Automatically detects the country from coordinates
Determines which datasets to use (contour vs region) based on location
Returns all available load types for the detected country
Simplifies integration - no need to know which dataset applies where

Supported Countries:

United States (US): Wind (ASCE 7-22 RC1-4 contours), Tornado (ASCE 7-22 RC3-4), Seismic (USGS)
Sweden (SE): Wind regions, Snow regions
Norway (NO): Wind regions, Snow regions
Denmark (DK): Wind contours
United Kingdom (GB): Wind contours
Spain (ES): Wind contours
Kenya (KE): Wind contours

Optional Parameters:

country: Override auto-detection with ISO 3166-1 alpha-2 code
include_wind/tornado/snow/seismic: Disable specific load types (default: true)
include_elevation/roughness: Include terrain data (default: false)
risk_categories: For US wind, filter to specific categories (e.g., rc2,rc3)

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

Get Environmental Loads › query Parameters

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 country code or name to override auto-detection. Accepts ISO 3166-1 alpha-2 codes (US, SE, NO, DK, GB, ES, KE) or common country names (United States, Sweden, etc.)
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_tornadoboolean
Include tornado wind speed data in response (US only, 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. Valid values: rc1, rc2, rc3, rc4 (e.g., 'rc2,rc3'). If omitted, returns all categories.
standardstring · enum
Design standard for US wind and snow data. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). Affects wind speeds and ground snow loads. For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22
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

Get Environmental Loads › Headers

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.

Get Environmental Loads › Responses

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

terrainobject
Terrain data (only included if requested)

Get Wind Speed Data

GET

https://api.calcs.com

/gis/wind

Returns wind speed design values for a location.

Supported Countries & Standards:

US: ASCE 7-16, ASCE 7-22 (default) - Risk Categories I, II, III, IV
Sweden: EN 1991-1-4 (base wind speed)
Norway: EN 1991-1-4 (base wind speed)
Denmark: EN 1991-1-4 (base wind speed)
UK: EN 1991-1-4 (base wind speed)
Spain: CTE DB SE-AE (base wind speed)
Kenya: KS ISO 4354 (base wind speed)

Response: Array of wind values, one per risk category where applicable.

Get Wind Speed Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code to override auto-detection
Enum values:
US
SE
NO
DK
GB
ES
KE
standardstring · enum
Design standard for US locations. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22

Get Wind Speed Data › Headers

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.

Get Wind Speed Data › Responses

Wind speed data for the location

locationobject
valuesobject[]
_metadataobject

Get Tornado Wind Speed Data

GET

https://api.calcs.com

/gis/tornado

Returns tornado wind speed design values for a location.

Availability:

US only: ASCE 7-22, Risk Categories III and IV

Note: Tornado data is only available for US locations under ASCE 7-22. For other locations, this endpoint returns 404.

Get Tornado Wind Speed Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code (only US supported for tornado)
Enum values:
US
standardstring · enum
Design standard (only ASCE 7-22 supported for tornado)
Enum values:
ASCE 7-22

Get Tornado Wind Speed Data › Headers

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.

Get Tornado Wind Speed Data › Responses

Tornado wind speed data for the location

locationobject
valuesobject[]
_metadataobject

Get Snow Load Data

GET

https://api.calcs.com

/gis/snow

Returns ground snow load design values for a location.

Supported Countries & Standards:

US: ASCE 7-16, ASCE 7-22 (default) - Risk Categories I, II, III, IV
Sweden: EN 1991-1-3
Norway: EN 1991-1-3

Note: Not all locations have snow data. For unsupported locations, returns 404.

Get Snow Load Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code to override auto-detection
Enum values:
US
SE
NO
standardstring · enum
Design standard for US locations. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). Note: ASCE 7-16 returns a single ground snow load value, while ASCE 7-22 returns values per risk category. For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22

Get Snow Load Data › Headers

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.

Get Snow Load Data › Responses

Snow load data for the location

locationobject
valuesobject[]
_metadataobject

Get Seismic Design Parameters

GET

https://api.calcs.com

/gis/seismic

Returns comprehensive seismic design parameters from USGS for a location.

Data Provided:

Mapped ground motion values (Ss, S1)
Site-modified values (Sms, Sm1)
Design values (Sds, Sd1)
Transition period (TL)
Seismic Design Category (SDC)

Availability:

US only: Via USGS Seismic Design Web Services
Standards: ASCE 7-16, ASCE 7-22 (default)

Parameters:

riskCategory: I, II (default), III, IV
siteClass: Soil classification (default: D)

Note: Only available for US locations. Returns 400 for other countries.

Get Seismic Design Parameters › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
riskCategorystring · enum
Risk category for seismic design
Enum values:
I
II
III
IV
Default: II
standardstring · enum
Design standard
Enum values:
ASCE 7-16
ASCE 7-22
Default: ASCE 7-22
siteClassstring · enum
Site class for soil conditions
Enum values:
A
B
BC
C
CD
D
DE
E
Default: D

Get Seismic Design Parameters › Headers

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.

Get Seismic Design Parameters › Responses

Seismic design parameters for the location

locationobject
valuesobject[]
_metadataobject

Calculators - Timber Calculators - Snow Load

Get Environmental Loads

GET

https://api.calcs.com

/gis/environmental_loads

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

Key Benefits:

Automatically detects the country from coordinates
Determines which datasets to use (contour vs region) based on location
Returns all available load types for the detected country
Simplifies integration - no need to know which dataset applies where

Supported Countries:

United States (US): Wind (ASCE 7-22 RC1-4 contours), Tornado (ASCE 7-22 RC3-4), Seismic (USGS)
Sweden (SE): Wind regions, Snow regions
Norway (NO): Wind regions, Snow regions
Denmark (DK): Wind contours
United Kingdom (GB): Wind contours
Spain (ES): Wind contours
Kenya (KE): Wind contours

Optional Parameters:

country: Override auto-detection with ISO 3166-1 alpha-2 code
include_wind/tornado/snow/seismic: Disable specific load types (default: true)
include_elevation/roughness: Include terrain data (default: false)
risk_categories: For US wind, filter to specific categories (e.g., rc2,rc3)

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

Get Environmental Loads › query Parameters

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 country code or name to override auto-detection. Accepts ISO 3166-1 alpha-2 codes (US, SE, NO, DK, GB, ES, KE) or common country names (United States, Sweden, etc.)
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_tornadoboolean
Include tornado wind speed data in response (US only, 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. Valid values: rc1, rc2, rc3, rc4 (e.g., 'rc2,rc3'). If omitted, returns all categories.
standardstring · enum
Design standard for US wind and snow data. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). Affects wind speeds and ground snow loads. For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22
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

Get Environmental Loads › Headers

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.

Get Environmental Loads › Responses

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

terrainobject
Terrain data (only included if requested)

Get Wind Speed Data

GET

https://api.calcs.com

/gis/wind

Returns wind speed design values for a location.

Supported Countries & Standards:

US: ASCE 7-16, ASCE 7-22 (default) - Risk Categories I, II, III, IV
Sweden: EN 1991-1-4 (base wind speed)
Norway: EN 1991-1-4 (base wind speed)
Denmark: EN 1991-1-4 (base wind speed)
UK: EN 1991-1-4 (base wind speed)
Spain: CTE DB SE-AE (base wind speed)
Kenya: KS ISO 4354 (base wind speed)

Response: Array of wind values, one per risk category where applicable.

Get Wind Speed Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code to override auto-detection
Enum values:
US
SE
NO
DK
GB
ES
KE
standardstring · enum
Design standard for US locations. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22

Get Wind Speed Data › Headers

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.

Get Wind Speed Data › Responses

Wind speed data for the location

locationobject
valuesobject[]
_metadataobject

Get Tornado Wind Speed Data

GET

https://api.calcs.com

/gis/tornado

Returns tornado wind speed design values for a location.

Availability:

US only: ASCE 7-22, Risk Categories III and IV

Note: Tornado data is only available for US locations under ASCE 7-22. For other locations, this endpoint returns 404.

Get Tornado Wind Speed Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code (only US supported for tornado)
Enum values:
US
standardstring · enum
Design standard (only ASCE 7-22 supported for tornado)
Enum values:
ASCE 7-22

Get Tornado Wind Speed Data › Headers

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.

Get Tornado Wind Speed Data › Responses

Tornado wind speed data for the location

locationobject
valuesobject[]
_metadataobject

Get Snow Load Data

GET

https://api.calcs.com

/gis/snow

Returns ground snow load design values for a location.

Supported Countries & Standards:

US: ASCE 7-16, ASCE 7-22 (default) - Risk Categories I, II, III, IV
Sweden: EN 1991-1-3
Norway: EN 1991-1-3

Note: Not all locations have snow data. For unsupported locations, returns 404.

Get Snow Load Data › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
countrystring · enum
Optional country code to override auto-detection
Enum values:
US
SE
NO
standardstring · enum
Design standard for US locations. Use 'ASCE 7-22' (current, default) or 'ASCE 7-16' (legacy). Note: ASCE 7-16 returns a single ground snow load value, while ASCE 7-22 returns values per risk category. For non-US locations, the country's national standard is used automatically.
Enum values:
ASCE 7-22
ASCE 7-16
Default: ASCE 7-22

Get Snow Load Data › Headers

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.

Get Snow Load Data › Responses

Snow load data for the location

locationobject
valuesobject[]
_metadataobject

Get Seismic Design Parameters

GET

https://api.calcs.com

/gis/seismic

Returns comprehensive seismic design parameters from USGS for a location.

Data Provided:

Mapped ground motion values (Ss, S1)
Site-modified values (Sms, Sm1)
Design values (Sds, Sd1)
Transition period (TL)
Seismic Design Category (SDC)

Availability:

US only: Via USGS Seismic Design Web Services
Standards: ASCE 7-16, ASCE 7-22 (default)

Parameters:

riskCategory: I, II (default), III, IV
siteClass: Soil classification (default: D)

Note: Only available for US locations. Returns 400 for other countries.

Get Seismic Design Parameters › query Parameters

latitudenumber · min: -90 · max: 90 · required
Latitude in decimal degrees (WGS84)
longitudenumber · min: -180 · max: 180 · required
Longitude in decimal degrees (WGS84)
riskCategorystring · enum
Risk category for seismic design
Enum values:
I
II
III
IV
Default: II
standardstring · enum
Design standard
Enum values:
ASCE 7-16
ASCE 7-22
Default: ASCE 7-22
siteClassstring · enum
Site class for soil conditions
Enum values:
A
B
BC
C
CD
D
DE
E
Default: D

Get Seismic Design Parameters › Headers

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.

Get Seismic Design Parameters › Responses

Seismic design parameters for the location

locationobject
valuesobject[]
_metadataobject