AASHTO-2009 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 (Input)
All parameters are required
- latitude
-
Latitude of location of interest, in decimal degrees
Example:34.05 - longitude
-
Longitude for location of interest, in decimal degrees
Example:-118.25 - siteClass
-
Site Class, as defined in Table 3.4.2.1-1 of seismic design reference
document
Options:
Afor “Hard rock”
Bfor “Rock”
Cfor “Very dense soil and soft rock”
Dfor “Stiff soil”
E(See Table 3.4.2.1-1) - title
-
Title for location/request
Example:Example
Response Parameters (Output)
Includes information about request, followed by response
- request
-
- date
- Timestamp, in format YYYY-MM-DDThh:mm:ssZ
- referenceDocument
- Seismic design reference document: “AASHTO-2009”
- status
- 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
- siteClass
- See definitions of request parameters above
- title
- See definitions of request parameters above
- response
-
- data
-
- pga
- PGA, the mapped horizontal Peak Ground Acceleration, in units of g
- fpga
- F PGA , the site coefficient for PGA, from Table 3.4.2.3-1 of the seismic design reference document
- as
- A s = F PGA x PGA (Equation 3.4.1-1), the design peak ground acceleration, in units of g
- ss
- S S , the mapped short-period (0.2-second) spectral acceleration, in units of g
- fa
- F a , the site coefficient for S S , from Table 3.4.2.3-1
- sds
- S DS = F a x S S (Equation 3.4.1-2), the design short-period (0.2-second) spectral acceleration, in units of g
- s1
- S 1 , the mapped 1-second spectral acceleration, in units of g
- fv
- F v , the site coefficient for S 1 , from Table 3.4.2.3-2
- sd1
- S D1 = F v x S 1 (Equation 3.4.1-3), the design 1-second spectral acceleration, in units of g
- sdc
- SDC, the Seismic Design Category from Table 3.5-1
- ts
- T S = S D1 / S DS (Equation 3.4.1-6), in seconds, for construction of design response spectrum
- t0
- T 0 = 0.2T S (Equation 3.4.1-5), in seconds, for construction of design response spectrum
- twoPeriodDesignSpectrum
- Two-period design response spectrum
- metadata
-
- griddedValuesID
-
Identifier for underlying gridded values:
“1998-HI-AASHTO-05-050-R1.rnd” for Hawaii
“2002-US-AASHTO-05-050-R1.rnd” for the conterminous United States
“2003-PRVI-AASHTO-05-050-R1.rnd” for Puerto Rico & the U.S. Virgin Islands
“2006-AK-AASHTO-05-050-R1.rnd” for Alaska - spatialInterpolationMethod
- Identifier for spatial interpolation method used to obtain values for location of interest from underlying gridded values: "linearlinearlinear" for bilinear
Example
Request
… /aashto-2009.json?latitude=34&longitude=-118&siteClass=C&title=Example
Response
{
request:{
date:"2019-06-13T15:46:45.448Z",
referenceDocument:"AASHTO-2009",
status:"success",
url:"http://localhost:8000/ws/designmaps/aashto-2009.json?latitude=34&longitude=-118&siteClass=C&title=Example",
parameters:{
latitude:34,
longitude:-118,
siteClass:"C",
title:"Example"
}
},
response:{
data:{
pga:0.637,
fpga:1,
as:0.637,
ss:1.512,
fa:1,
sds:1.512,
s1:0.551,
fv:1.3,
sd1:0.716,
sdc:"D",
ts:0.474,
t0:0.095,
twoPeriodDesignSpectrum:[
[
0,
0.637
],
[
0.025,
0.868
],
[
0.05,
1.099
],
[
0.095,
1.512
],
[
0.1,
1.512
],
[
0.15,
1.512
],
[
0.2,
1.512
],
[
0.25,
1.512
],
[
0.3,
1.512
],
[
0.35,
1.512
],
[
0.4,
1.512
],
[
0.45,
1.512
],
[
0.474,
1.512
],
[
0.5,
1.433
],
[
0.55,
1.302
],
[
0.6,
1.194
],
[
0.65,
1.102
],
[
0.7,
1.023
],
[
0.75,
0.955
],
[
0.8,
0.895
],
[
0.85,
0.843
],
[
0.9,
0.796
],
[
0.95,
0.754
],
[
1,
0.716
],
[
1.05,
0.682
],
[
1.1,
0.651
],
[
1.15,
0.623
],
[
1.2,
0.597
],
[
1.25,
0.573
],
[
1.3,
0.551
],
[
1.35,
0.531
],
[
1.4,
0.512
],
[
1.45,
0.494
],
[
1.5,
0.478
],
[
1.55,
0.462
],
[
1.6,
0.448
],
[
1.65,
0.434
],
[
1.7,
0.421
],
[
1.75,
0.409
],
[
1.8,
0.398
],
[
1.85,
0.387
],
[
1.9,
0.377
],
[
1.95,
0.367
],
[
2,
0.358
],
[
2.05,
0.349
],
[
2.1,
0.341
],
[
2.15,
0.333
],
[
2.2,
0.326
],
[
2.25,
0.318
],
[
2.3,
0.311
],
[
2.35,
0.305
],
[
2.4,
0.298
],
[
2.45,
0.292
],
[
2.5,
0.287
],
[
2.55,
0.281
],
[
2.6,
0.276
],
[
2.65,
0.27
],
[
2.7,
0.265
],
[
2.75,
0.26
],
[
2.8,
0.256
],
[
2.85,
0.251
],
[
2.9,
0.247
],
[
2.95,
0.243
],
[
3,
0.239
],
[
3.05,
0.235
],
[
3.1,
0.231
],
[
3.15,
0.227
],
[
3.2,
0.224
],
[
3.25,
0.22
],
[
3.3,
0.217
],
[
3.35,
0.214
],
[
3.4,
0.211
],
[
3.45,
0.208
],
[
3.5,
0.205
],
[
3.55,
0.202
],
[
3.6,
0.199
],
[
3.65,
0.196
],
[
3.7,
0.194
],
[
3.75,
0.191
],
[
3.8,
0.189
],
[
3.85,
0.186
],
[
3.9,
0.184
],
[
3.95,
0.181
],
[
4,
0.179
]
]
},
metadata:{
griddedValuesID:"2002-US-AASHTO-05-050-R1.rnd",
spatialInterpolationMethod:"linearlinearlinear"
}
}
}