ASCE7-05 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.
Request Parameters
Required parameters
- latitude
-
Latitude for location at which to compute composite results
Example:34 - longitude
-
Longitude for location at which to compute composite results
Example:-118 - riskCategory
-
Risk category for structure
Example:III - siteClass
-
NEHRP site classification
Example:C - title
-
Name for site/report
Example:Example
Output
Web service response
- request
-
- date
-
Timestamp
Example:“YYYY-MM-DDThh:mm:ssZ” - referenceDocument
-
Identifying the reference document for the returned data
Example:“ASCE7-05” - status
-
String ("success" or "error")
Example:“success” - url
-
URL to reproduce this result
Example:“{MOUNT_PATH}/asce7-05.json?latitude=34&longitude=-118&riskCategory=III&siteClass=C&title=Example” - parameters
-
- latitude
-
Latitude for location at which to compute composite results
Example:34 - longitude
-
Longitude for location at which to compute composite results
Example:-118 - riskCategory
-
Risk category for structure
Example:“III” - siteClass
-
NEHRP site classification
Example:“C” - title
-
Name for site/report
Example:“Example”
- response
-
- data
-
- ss
- MCER ground motion (0.2 s)
- fa
- Site amplification factor (0.2 s)
- sms
- Site-modified spectral acceleration value (0.2 s)
- sds
- Numeric seismic design value (0.2 s)
- sdcs
- Seismic design category from SDS
- s1
- MCER ground motion (1.0 s)
- fv
- Site amplification factor (1.0 s)
- sm1
- Site-modified spectral acceleration value (1.0 s)
- sd1
- Numeric seismic design value (1.0 s)
- sdc1
- Seismic design category from SD1
- sdc
- Seismic design category from SDCS and SDC1
- tl
- Long-period transition period in seconds
- t-sub-l
- DEPRECATED
- Long-period transition period in seconds
- twoPeriodDesignSpectrum
- Design horizontal response spectrum
- twoPeriodMCErSpectrum
- MCER horizontal response spectrum
- metadata
-
- spatialInterpolationMethod
- Identifier for the interpolation method used to obtain data for location of interest from underlying gridded datasets
Example
Request
…/asce7-05.json?latitude=34&longitude=-118&riskCategory=III&siteClass=C&title=Example
Response
{
request:{
date:"2019-05-28T16:31:27.742Z",
referenceDocument:"ASCE7-05",
status:"success",
url:"http://localhost:8000/ws/designmaps/asce7-05.json?latitude=34&longitude=-118&riskCategory=III&siteClass=C&title=Example",
parameters:{
latitude:34,
longitude:-118,
riskCategory:"III",
siteClass:"C",
title:"Example"
}
},
response:{
data:{
ss:2.123,
fa:1,
sms:2.123,
sds:1.415,
sdcs:"",
s1:0.784,
fv:1.3,
sm1:1.019,
sd1:0.679,
sdc1:"",
sdc:"E",
tl:8,
t-sub-l:8,
twoPeriodDesignSpectrum:[
[
0,
0.566
],
[
0.025,
0.787
],
[
0.05,
1.008
],
[
0.096,
1.415
],
[
0.1,
1.415
],
[
0.15,
1.415
],
[
0.2,
1.415
],
[
0.25,
1.415
],
[
0.3,
1.415
],
[
0.35,
1.415
],
[
0.4,
1.415
],
[
0.45,
1.415
],
[
0.48,
1.415
],
[
0.5,
1.358
],
[
0.55,
1.235
],
[
0.6,
1.132
],
[
0.65,
1.045
],
[
0.7,
0.97
],
[
0.75,
0.906
],
[
0.8,
0.849
],
[
0.85,
0.799
],
[
0.9,
0.755
],
[
0.95,
0.715
],
[
1,
0.679
],
[
1.05,
0.647
],
[
1.1,
0.617
],
[
1.15,
0.591
],
[
1.2,
0.566
],
[
1.25,
0.543
],
[
1.3,
0.522
],
[
1.35,
0.503
],
[
1.4,
0.485
],
[
1.45,
0.468
],
[
1.5,
0.453
],
[
1.55,
0.438
],
[
1.6,
0.425
],
[
1.65,
0.412
],
[
1.7,
0.4
],
[
1.75,
0.388
],
[
1.8,
0.377
],
[
1.85,
0.367
],
[
1.9,
0.357
],
[
1.95,
0.348
],
[
2,
0.34
],
[
2.05,
0.331
],
[
2.1,
0.323
],
[
2.15,
0.316
],
[
2.2,
0.309
],
[
2.25,
0.302
],
[
2.3,
0.295
],
[
2.35,
0.289
],
[
2.4,
0.283
],
[
2.45,
0.277
],
[
2.5,
0.272
],
[
2.55,
0.266
],
[
2.6,
0.261
],
[
2.65,
0.256
],
[
2.7,
0.252
],
[
2.75,
0.247
],
[
2.8,
0.243
],
[
2.85,
0.238
],
[
2.9,
0.234
],
[
2.95,
0.23
],
[
3,
0.226
],
[
3.05,
0.223
],
[
3.1,
0.219
],
[
3.15,
0.216
],
[
3.2,
0.212
],
[
3.25,
0.209
],
[
3.3,
0.206
],
[
3.35,
0.203
],
[
3.4,
0.2
],
[
3.45,
0.197
],
[
3.5,
0.194
],
[
3.55,
0.191
],
[
3.6,
0.189
],
[
3.65,
0.186
],
[
3.7,
0.184
],
[
3.75,
0.181
],
[
3.8,
0.179
],
[
3.85,
0.176
],
[
3.9,
0.174
],
[
3.95,
0.172
],
[
4,
0.17
],
[
4.05,
0.168
],
[
4.1,
0.166
],
[
4.15,
0.164
],
[
4.2,
0.162
],
[
4.25,
0.16
],
[
4.3,
0.158
],
[
4.35,
0.156
],
[
4.4,
0.154
],
[
4.45,
0.153
],
[
4.5,
0.151
],
[
4.55,
0.149
],
[
4.6,
0.148
],
[
4.65,
0.146
],
[
4.7,
0.145
],
[
4.75,
0.143
],
[
4.8,
0.142
],
[
4.85,
0.14
],
[
4.9,
0.139
],
[
4.95,
0.137
],
[
5,
0.136
],
[
5.05,
0.134
],
[
5.1,
0.133
],
[
5.15,
0.132
],
[
5.2,
0.131
],
[
5.25,
0.129
],
[
5.3,
0.128
],
[
5.35,
0.127
],
[
5.4,
0.126
],
[
5.45,
0.125
],
[
5.5,
0.123
],
[
5.55,
0.122
],
[
5.6,
0.121
],
[
5.65,
0.12
],
[
5.7,
0.119
],
[
5.75,
0.118
],
[
5.8,
0.117
],
[
5.85,
0.116
],
[
5.9,
0.115
],
[
5.95,
0.114
],
[
6,
0.113
],
[
6.05,
0.112
],
[
6.1,
0.111
],
[
6.15,
0.11
],
[
6.2,
0.11
],
[
6.25,
0.109
],
[
6.3,
0.108
],
[
6.35,
0.107
],
[
6.4,
0.106
],
[
6.45,
0.105
],
[
6.5,
0.104
],
[
6.55,
0.104
],
[
6.6,
0.103
],
[
6.65,
0.102
],
[
6.7,
0.101
],
[
6.75,
0.101
],
[
6.8,
0.1
],
[
6.85,
0.099
],
[
6.9,
0.098
],
[
6.95,
0.098
],
[
7,
0.097
],
[
7.05,
0.096
],
[
7.1,
0.096
],
[
7.15,
0.095
],
[
7.2,
0.094
],
[
7.25,
0.094
],
[
7.3,
0.093
],
[
7.35,
0.092
],
[
7.4,
0.092
],
[
7.45,
0.091
],
[
7.5,
0.091
],
[
7.55,
0.09
],
[
7.6,
0.089
],
[
7.65,
0.089
],
[
7.7,
0.088
],
[
7.75,
0.088
],
[
7.8,
0.087
],
[
7.85,
0.087
],
[
7.9,
0.086
],
[
7.95,
0.085
],
[
8,
0.085
],
[
8.05,
0.084
],
[
8.1,
0.083
],
[
8.15,
0.082
],
[
8.2,
0.081
],
[
8.25,
0.08
],
[
8.3,
0.079
],
[
8.35,
0.078
],
[
8.4,
0.077
],
[
8.45,
0.076
],
[
8.5,
0.075
],
[
8.55,
0.074
],
[
8.6,
0.073
],
[
8.65,
0.073
],
[
8.7,
0.072
],
[
8.75,
0.071
],
[
8.8,
0.07
],
[
8.85,
0.069
],
[
8.9,
0.069
],
[
8.95,
0.068
],
[
9,
0.067
]
],
twoPeriodMCErSpectrum:[
[
0,
0.849
],
[
0.025,
1.181
],
[
0.05,
1.512
],
[
0.096,
2.123
],
[
0.1,
2.123
],
[
0.15,
2.123
],
[
0.2,
2.123
],
[
0.25,
2.123
],
[
0.3,
2.123
],
[
0.35,
2.123
],
[
0.4,
2.123
],
[
0.45,
2.123
],
[
0.48,
2.123
],
[
0.5,
2.038
],
[
0.55,
1.852
],
[
0.6,
1.698
],
[
0.65,
1.567
],
[
0.7,
1.455
],
[
0.75,
1.358
],
[
0.8,
1.274
],
[
0.85,
1.199
],
[
0.9,
1.132
],
[
0.95,
1.072
],
[
1,
1.019
],
[
1.05,
0.97
],
[
1.1,
0.926
],
[
1.15,
0.886
],
[
1.2,
0.849
],
[
1.25,
0.815
],
[
1.3,
0.784
],
[
1.35,
0.755
],
[
1.4,
0.728
],
[
1.45,
0.703
],
[
1.5,
0.679
],
[
1.55,
0.657
],
[
1.6,
0.637
],
[
1.65,
0.617
],
[
1.7,
0.599
],
[
1.75,
0.582
],
[
1.8,
0.566
],
[
1.85,
0.551
],
[
1.9,
0.536
],
[
1.95,
0.522
],
[
2,
0.509
],
[
2.05,
0.497
],
[
2.1,
0.485
],
[
2.15,
0.474
],
[
2.2,
0.463
],
[
2.25,
0.453
],
[
2.3,
0.443
],
[
2.35,
0.434
],
[
2.4,
0.425
],
[
2.45,
0.416
],
[
2.5,
0.408
],
[
2.55,
0.4
],
[
2.6,
0.392
],
[
2.65,
0.384
],
[
2.7,
0.377
],
[
2.75,
0.37
],
[
2.8,
0.364
],
[
2.85,
0.357
],
[
2.9,
0.351
],
[
2.95,
0.345
],
[
3,
0.34
],
[
3.05,
0.334
],
[
3.1,
0.329
],
[
3.15,
0.323
],
[
3.2,
0.318
],
[
3.25,
0.313
],
[
3.3,
0.309
],
[
3.35,
0.304
],
[
3.4,
0.3
],
[
3.45,
0.295
],
[
3.5,
0.291
],
[
3.55,
0.287
],
[
3.6,
0.283
],
[
3.65,
0.279
],
[
3.7,
0.275
],
[
3.75,
0.272
],
[
3.8,
0.268
],
[
3.85,
0.265
],
[
3.9,
0.261
],
[
3.95,
0.258
],
[
4,
0.255
],
[
4.05,
0.252
],
[
4.1,
0.248
],
[
4.15,
0.245
],
[
4.2,
0.243
],
[
4.25,
0.24
],
[
4.3,
0.237
],
[
4.35,
0.234
],
[
4.4,
0.232
],
[
4.45,
0.229
],
[
4.5,
0.226
],
[
4.55,
0.224
],
[
4.6,
0.221
],
[
4.65,
0.219
],
[
4.7,
0.217
],
[
4.75,
0.214
],
[
4.8,
0.212
],
[
4.85,
0.21
],
[
4.9,
0.208
],
[
4.95,
0.206
],
[
5,
0.204
],
[
5.05,
0.202
],
[
5.1,
0.2
],
[
5.15,
0.198
],
[
5.2,
0.196
],
[
5.25,
0.194
],
[
5.3,
0.192
],
[
5.35,
0.19
],
[
5.4,
0.189
],
[
5.45,
0.187
],
[
5.5,
0.185
],
[
5.55,
0.184
],
[
5.6,
0.182
],
[
5.65,
0.18
],
[
5.7,
0.179
],
[
5.75,
0.177
],
[
5.8,
0.176
],
[
5.85,
0.174
],
[
5.9,
0.173
],
[
5.95,
0.171
],
[
6,
0.17
],
[
6.05,
0.168
],
[
6.1,
0.167
],
[
6.15,
0.166
],
[
6.2,
0.164
],
[
6.25,
0.163
],
[
6.3,
0.162
],
[
6.35,
0.16
],
[
6.4,
0.159
],
[
6.45,
0.158
],
[
6.5,
0.157
],
[
6.55,
0.156
],
[
6.6,
0.154
],
[
6.65,
0.153
],
[
6.7,
0.152
],
[
6.75,
0.151
],
[
6.8,
0.15
],
[
6.85,
0.149
],
[
6.9,
0.148
],
[
6.95,
0.147
],
[
7,
0.146
],
[
7.05,
0.145
],
[
7.1,
0.143
],
[
7.15,
0.142
],
[
7.2,
0.142
],
[
7.25,
0.141
],
[
7.3,
0.14
],
[
7.35,
0.139
],
[
7.4,
0.138
],
[
7.45,
0.137
],
[
7.5,
0.136
],
[
7.55,
0.135
],
[
7.6,
0.134
],
[
7.65,
0.133
],
[
7.7,
0.132
],
[
7.75,
0.131
],
[
7.8,
0.131
],
[
7.85,
0.13
],
[
7.9,
0.129
],
[
7.95,
0.128
],
[
8,
0.127
],
[
8.05,
0.126
],
[
8.1,
0.124
],
[
8.15,
0.123
],
[
8.2,
0.121
],
[
8.25,
0.12
],
[
8.3,
0.118
],
[
8.35,
0.117
],
[
8.4,
0.116
],
[
8.45,
0.114
],
[
8.5,
0.113
],
[
8.55,
0.111
],
[
8.6,
0.11
],
[
8.65,
0.109
],
[
8.7,
0.108
],
[
8.75,
0.106
],
[
8.8,
0.105
],
[
8.85,
0.104
],
[
8.9,
0.103
],
[
8.95,
0.102
],
[
9,
0.101
]
]
},
metadata:{
modelVersion:"v2.0.x",
spatialInterpolationMethod:"linearlinearlinear"
}
}
}