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:
A for “Hard rock”
B for “Rock”
C for “Very dense soil and soft rock”
D for “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
FPGA, the site coefficient for PGA, from Table 3.4.2.3-1 of the seismic design reference document
as
As = FPGA x PGA (Equation 3.4.1-1), the design peak ground acceleration, in units of g
ss
SS, the mapped short-period (0.2-second) spectral acceleration, in units of g
fa
Fa, the site coefficient for SS, from Table 3.4.2.3-1
sds
SDS = Fa x SS (Equation 3.4.1-2), the design short-period (0.2-second) spectral acceleration, in units of g
s1
S1, the mapped 1-second spectral acceleration, in units of g
fv
Fv, the site coefficient for S1, from Table 3.4.2.3-2
sd1
SD1 = Fv x S1 (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
TS = SD1 / SDS (Equation 3.4.1-6), in seconds, for construction of design response spectrum
t0
T0 = 0.2TS (Equation 3.4.1-5), in seconds, for construction of design response spectrum
sdSpectrum
Sa, the design response spectrum from Figure 3.4.1-1 and Equation 3.4.1-4
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": "2018-06-03T00:50:52.810Z",
        "referenceDocument": "AASHTO-2009",
        "status": "success",
        "url": "/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,
          "sdSpectrum": [
            [
              0,
              0.605
            ],
            [
              0.025,
              0.844
            ],
            [
              0.05,
              1.084
            ],
            [
              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,
              null
            ],
            [
              0.55,
              null
            ],
            [
              0.6,
              null
            ],
            [
              0.65,
              null
            ],
            [
              0.7,
              null
            ],
            [
              0.75,
              null
            ],
            [
              0.8,
              null
            ],
            [
              0.85,
              null
            ],
            [
              0.9,
              null
            ],
            [
              0.95,
              null
            ],
            [
              1,
              null
            ],
            [
              1.05,
              null
            ],
            [
              1.1,
              null
            ],
            [
              1.15,
              null
            ],
            [
              1.2,
              null
            ],
            [
              1.25,
              null
            ],
            [
              1.3,
              null
            ],
            [
              1.35,
              null
            ],
            [
              1.4,
              null
            ],
            [
              1.45,
              null
            ],
            [
              1.5,
              null
            ],
            [
              1.55,
              null
            ],
            [
              1.6,
              null
            ],
            [
              1.65,
              null
            ],
            [
              1.7,
              null
            ],
            [
              1.75,
              null
            ],
            [
              1.8,
              null
            ],
            [
              1.85,
              null
            ],
            [
              1.9,
              null
            ],
            [
              1.95,
              null
            ],
            [
              2,
              null
            ]
          ]
        },
        "metadata": {
          "griddedValuesID": "2002-US-AASHTO-05-050-R1.rnd",
          "spatialInterpolationMethod": "linearlinearlinear"
        }
      }
    }