ASCE7-22 Web Service Documentation
This software is preliminary or provisional and is subject to revision.
It is being provided to meet the need for timely best science. The
software has not received final approval by the U.S. Geological Survey
(USGS). No warranty, expressed or implied, is made by the USGS or the
U.S. Government as to the functionality of the software and related
material nor shall the fact of release constitute any such warranty. The
software is provided on the condition that neither the USGS nor the U.S.
Government shall be held liable for any damages resulting from the
authorized or unauthorized use of the software.
The documentation below is still being finalized.
Furthermore, vertical response spectra outputs have not yet been added.
Request Parameters (Input)
For an example request, please see below.
- latitude
-
Latitude of location of interest, in decimal degrees
Example:34.05 - longitude
-
Longitude of location of interest, in decimal degrees
Example:-118.25 - riskCategory
-
Risk Category, as defined in Chapter 1
Options:I, II, III, or IV - siteClass
-
Site Class, as defined in Chapter 20
Options:Default, A, B, BC, C, CD, D, DE, E - title
-
Title for location/request (can be blank)
Example:Los Angeles
Response Parameters (Output)
Includes information about the request, followed by the response.
- request
-
- date
- Timestamp, in format YYYY-MM-DDThh:mm:ssZ
- referenceDocument
- Seismic design reference document: "ASCE7-22"
- status
- Status of response to request, either “success” or “error”
- url
- URL of request/response; see example below
- parameters
-
- latitude
- See definitions of request parameters above
- longitude
- See definitions of request parameters above
- riskCategory
- See definitions of request parameters above
- siteClass
- See definitions of request parameters above
- title
- See definitions of request parameters above
- response
-
- data
-
- pgam
- PGAM, the Geometric-Mean Maximum Considered Earthquake (MCEG) peak ground acceleration for the user-specified Site Class, in units of g
- sms
- SMS = 1.5 x SDS, the Risk-Targeted Maximum Considered Earthquake (MCER) spectral response acceleration for short periods (of the two-period spectrum) and the user-specified Site Class
- sm1
- SM1 = 1.5 x SD1, the MCER spectral response acceleration for 1 second (of the two-period spectrum) and the user-specified Site Class
- sds
- SDS, the design spectral response acceleration for short periods (of the two-period spectrum) and the user-specified Site Class, in units of g
- sd1
- SD1, the design spectral response acceleration for 1 second (of the two-period spectrum) and the user-specified Site Class, in units of g
- sdc
- SDC, the Seismic Design Category
- ss
- SS, the MCER spectral response acceleration at 0.2 seconds for Site Class BC, in units of g
- s1
- S1, the MCER spectral response acceleration at 1 second for Site Class BC, in units of g
- ts
- T S = S D1 / S DS , in seconds, for construction of the two-period design spectrum
- t0
- T 0 = 0.2 x T S , in seconds, for construction of the two-period design response spectrum
- tl
- TL, the long-period transition period, in seconds, for construction of the two-period design response spectrum
- cv
- CV, the vertical coefficient
- multiPeriodDesignSpectrum
-
Multi-period design response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- multiPeriodMCErSpectrum
-
Multi-period MCER response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- twoPeriodDesignSpectrum
-
Two-period design response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- twoPeriodMCErSpectrum
-
Two-period MCER
response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- verticalDesignSpectrum
-
Vertical design response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- verticalMCErSpectrum
-
Vertical MCER
response spectrum
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- underlyingData
-
- pgauh
- Probabilistic uniform-hazard (2%-in-50-years), geometric-mean peak ground acceleration, in units of g
- pga84th
- Deterministic 84th-percentile, geometric-mean peak ground acceleration (without deterministic lower limit), in units of g
- riskTargetedSpectrum
-
Probabilistic risk-targeted, maximum-direction response
spectrum (for 1%-in-50-years collapse risk)
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- eightyFourthSpectrum
-
Deterministic 84th-percentile, maximum-direction response
spectrum (without deterministic lower limit)
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- metadata
-
- modelVersion
- Version of the underlying USGS National Seismic Hazard Model
- vs30
- VS30, the shear-wave velocity used for the user-specified Site Class, in units of m/s
- scienceBaseURL
- URL of ScienceBase webpage where files of underlying gridded values are posted
- spatialInterpolationMethod
- Identifier for spatial interpolation method used to obtain values for location of interest from underlying gridded values: "linearloglinear" for bilinear of natural logarithm of values
- maxDirFactors
-
Maximum-direction response scale factors (obsolete)
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of scale factors
- dllSpectrum
-
Deterministic lower limit response spectrum for the
user-specified Site Class
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- pgadFloor
- Deterministic lower limit peak ground acceleration (PGAG) for the user-specified Site Class, in units of g
Example
Request
…/asce7-22.json?latitude=34&longitude=-118&riskCategory=III&siteClass=C&title=Example
Response
{
request:{
date:"2019-06-13T15:49:32.786Z",
referenceDocument:"ASCE7-22",
status:"success",
url:"http://localhost:8000/ws/designmaps/asce7-22.json?latitude=34&longitude=-118&riskCategory=III&siteClass=C&title=Example",
parameters:{
latitude:34,
longitude:-118,
riskCategory:"III",
siteClass:"C",
title:"Example"
}
},
data:{
pgam:0.55,
sms:1.86,
sm1:1.07,
sds:1.24,
sd1:0.71,
sdc:"E",
ss:1.8,
s1:0.75,
ts:0.576,
t0:0.115,
tl:8,
cv:null,
multiPeriodDesignSpectrum:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
0.58,
0.58,
0.59,
0.63,
0.77,
0.95,
1.09,
1.28,
1.37,
1.37,
1.34,
1.23,
1.12,
0.87,
0.71,
0.45,
0.32,
0.2,
0.14,
0.11,
0.068,
0.045
]
},
multiPeriodMCErSpectrum:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
0.87,
0.88,
0.89,
0.95,
1.15,
1.43,
1.64,
1.93,
2.05,
2.06,
2.01,
1.85,
1.68,
1.31,
1.07,
0.68,
0.48,
0.3,
0.21,
0.16,
0.1,
0.068
]
},
twoPeriodDesignSpectrum:{
periods:[
0,
0.025,
0.05,
0.1,
0.12,
0.15,
0.2,
0.25,
0.3,
0.35,
0.4,
0.45,
0.5,
0.55,
0.58,
0.6,
0.65,
0.7,
0.75,
0.8,
0.85,
0.9,
0.95,
1,
1.05,
1.1,
1.15,
1.2,
1.25,
1.3,
1.35,
1.4,
1.45,
1.5,
1.55,
1.6,
1.65,
1.7,
1.75,
1.8,
1.85,
1.9,
1.95,
2,
2.05,
2.1,
2.15,
2.2,
2.25,
2.3,
2.35,
2.4,
2.45,
2.5,
2.55,
2.6,
2.65,
2.7,
2.75,
2.8,
2.85,
2.9,
2.95,
3,
3.05,
3.1,
3.15,
3.2,
3.25,
3.3,
3.35,
3.4,
3.45,
3.5,
3.55,
3.6,
3.65,
3.7,
3.75,
3.8,
3.85,
3.9,
3.95,
4,
4.05,
4.1,
4.15,
4.2,
4.25,
4.3,
4.35,
4.4,
4.45,
4.5,
4.55,
4.6,
4.65,
4.7,
4.75,
4.8,
4.85,
4.9,
4.95,
5,
5.05,
5.1,
5.15,
5.2,
5.25,
5.3,
5.35,
5.4,
5.45,
5.5,
5.55,
5.6,
5.65,
5.7,
5.75,
5.8,
5.85,
5.9,
5.95,
6,
6.05,
6.1,
6.15,
6.2,
6.25,
6.3,
6.35,
6.4,
6.45,
6.5,
6.55,
6.6,
6.65,
6.7,
6.75,
6.8,
6.85,
6.9,
6.95,
7,
7.05,
7.1,
7.15,
7.2,
7.25,
7.3,
7.35,
7.4,
7.45,
7.5,
7.55,
7.6,
7.65,
7.7,
7.75,
7.8,
7.85,
7.9,
7.95,
8,
8.05,
8.1,
8.15,
8.2,
8.25,
8.3,
8.35,
8.4,
8.45,
8.5,
8.55,
8.6,
8.65,
8.7,
8.75,
8.8,
8.85,
8.9,
8.95,
9
],
ordinates:[
0.49,
0.66,
0.82,
1.14,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.24,
1.19,
1.1,
1.02,
0.95,
0.89,
0.84,
0.79,
0.75,
0.71,
0.68,
0.65,
0.62,
0.59,
0.57,
0.55,
0.53,
0.51,
0.49,
0.48,
0.46,
0.45,
0.43,
0.42,
0.41,
0.4,
0.39,
0.38,
0.37,
0.36,
0.35,
0.34,
0.33,
0.32,
0.32,
0.31,
0.3,
0.3,
0.29,
0.29,
0.28,
0.27,
0.27,
0.26,
0.26,
0.25,
0.25,
0.25,
0.24,
0.24,
0.23,
0.23,
0.23,
0.22,
0.22,
0.22,
0.21,
0.21,
0.21,
0.2,
0.2,
0.2,
0.2,
0.19,
0.19,
0.19,
0.19,
0.18,
0.18,
0.18,
0.18,
0.17,
0.17,
0.17,
0.17,
0.17,
0.16,
0.16,
0.16,
0.16,
0.16,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.1,
0.099,
0.098,
0.098,
0.097,
0.096,
0.096,
0.095,
0.094,
0.094,
0.093,
0.093,
0.092,
0.091,
0.091,
0.09,
0.09,
0.089,
0.088,
0.087,
0.086,
0.085,
0.084,
0.083,
0.082,
0.081,
0.08,
0.079,
0.078,
0.077,
0.076,
0.075,
0.074,
0.074,
0.073,
0.072,
0.071,
0.07
]
},
twoPeriodMCErSpectrum:{
periods:[
0,
0.025,
0.05,
0.1,
0.12,
0.15,
0.2,
0.25,
0.3,
0.35,
0.4,
0.45,
0.5,
0.55,
0.58,
0.6,
0.65,
0.7,
0.75,
0.8,
0.85,
0.9,
0.95,
1,
1.05,
1.1,
1.15,
1.2,
1.25,
1.3,
1.35,
1.4,
1.45,
1.5,
1.55,
1.6,
1.65,
1.7,
1.75,
1.8,
1.85,
1.9,
1.95,
2,
2.05,
2.1,
2.15,
2.2,
2.25,
2.3,
2.35,
2.4,
2.45,
2.5,
2.55,
2.6,
2.65,
2.7,
2.75,
2.8,
2.85,
2.9,
2.95,
3,
3.05,
3.1,
3.15,
3.2,
3.25,
3.3,
3.35,
3.4,
3.45,
3.5,
3.55,
3.6,
3.65,
3.7,
3.75,
3.8,
3.85,
3.9,
3.95,
4,
4.05,
4.1,
4.15,
4.2,
4.25,
4.3,
4.35,
4.4,
4.45,
4.5,
4.55,
4.6,
4.65,
4.7,
4.75,
4.8,
4.85,
4.9,
4.95,
5,
5.05,
5.1,
5.15,
5.2,
5.25,
5.3,
5.35,
5.4,
5.45,
5.5,
5.55,
5.6,
5.65,
5.7,
5.75,
5.8,
5.85,
5.9,
5.95,
6,
6.05,
6.1,
6.15,
6.2,
6.25,
6.3,
6.35,
6.4,
6.45,
6.5,
6.55,
6.6,
6.65,
6.7,
6.75,
6.8,
6.85,
6.9,
6.95,
7,
7.05,
7.1,
7.15,
7.2,
7.25,
7.3,
7.35,
7.4,
7.45,
7.5,
7.55,
7.6,
7.65,
7.7,
7.75,
7.8,
7.85,
7.9,
7.95,
8,
8.05,
8.1,
8.15,
8.2,
8.25,
8.3,
8.35,
8.4,
8.45,
8.5,
8.55,
8.6,
8.65,
8.7,
8.75,
8.8,
8.85,
8.9,
8.95,
9
],
ordinates:[
0.74,
0.98,
1.23,
1.71,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.86,
1.78,
1.64,
1.53,
1.43,
1.34,
1.26,
1.19,
1.13,
1.07,
1.02,
0.97,
0.93,
0.89,
0.86,
0.82,
0.79,
0.76,
0.74,
0.71,
0.69,
0.67,
0.65,
0.63,
0.61,
0.59,
0.58,
0.56,
0.55,
0.53,
0.52,
0.51,
0.5,
0.49,
0.48,
0.46,
0.45,
0.45,
0.44,
0.43,
0.42,
0.41,
0.4,
0.4,
0.39,
0.38,
0.38,
0.37,
0.36,
0.36,
0.35,
0.34,
0.34,
0.33,
0.33,
0.32,
0.32,
0.31,
0.31,
0.31,
0.3,
0.3,
0.29,
0.29,
0.29,
0.28,
0.28,
0.27,
0.27,
0.27,
0.26,
0.26,
0.26,
0.25,
0.25,
0.25,
0.25,
0.24,
0.24,
0.24,
0.23,
0.23,
0.23,
0.23,
0.23,
0.22,
0.22,
0.22,
0.22,
0.21,
0.21,
0.21,
0.21,
0.21,
0.2,
0.2,
0.2,
0.2,
0.2,
0.19,
0.19,
0.19,
0.19,
0.19,
0.19,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.18,
0.17,
0.17,
0.17,
0.17,
0.17,
0.17,
0.17,
0.16,
0.16,
0.16,
0.16,
0.16,
0.16,
0.16,
0.16,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.15,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.14,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.13,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.12,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11,
0.11
]
},
verticalDesignSpectrum:{
periods:[
],
ordinates:[
]
},
verticalMCErSpectrum:{
periods:[
],
ordinates:[
]
},
underlyingData:null
},
metadata:{
vs30:530,
modelVersion:"v5.0.x",
pgadFloor:0.55,
pgadPercentileFactor:1,
sadFloor:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
0.73,
0.73,
0.74,
0.79,
0.96,
1.19,
1.37,
1.61,
1.71,
1.71,
1.66,
1.53,
1.38,
1.07,
0.86,
0.6,
0.45,
0.31,
0.24,
0.19,
0.11,
0.07
]
},
sadPercentileFactor:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1,
1
]
},
maxDirectionFactor:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.2,
1.203,
1.206,
1.213,
1.219,
1.234,
1.25,
1.253,
1.256,
1.261,
1.267,
1.272,
1.286,
1.3
]
},
spatialInterpolationMethod:"linearloglinear"
}
}
}