NAM12KM Web Service

NAM12KM

Click here for a complete list of operations.

GetValuesObject

This function returns a string formatted as XML containing Unidata North American Model (NAM) time series data. The function takes Latitude/Longitude coordinates in decimal degrees at a single point.returns the time series of total precipitation. The function uses NCEP North American Model : AWIPS 218 (B) grid over the continental United States - Model runs are made at 06Z, 12Z, 18Z and 00Z, with analysis and forecasts every 3 hours out to 84 hours. Grid dimensions are 614 by 428 points, and the resolution is 12.19 km. The east and west longitudinal extents of the grid (in decimal degrees) are -49.30897 and -133.49621. The north and south latitude extents of the grid (in decimal degrees) are 57.35624 and 12.12367. For more information please refer to http://motherlode.ucar.edu:8080/thredds/catalog/model/NCEP/NAM/CONUS_12km/latest.html

Valid Variables include:

1 - Total Precipitation (kg m-2 or mm rainfall)

This service will only produce the latest forecast. Any dates only narrow the returned data for this request. The current valid range of date and time for data retrieval is from today to 2 days in the future (format = yyyy-mm-ddThh:mm).If no dates are passed, Today to three days from now are the default values.

Test arguments: GetValues("GEOM:POINT(-113 45)", "NAM:1", null, null)

Test arguments: GetValues("GEOM:POINT(-113 45)", "NAM:1", [Current Time in yyyy-mm-ddThh:mm format], )

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /wateroneflow/NAM12k/Service.asmx HTTP/1.1
Host: river.sdsc.edu
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.cuahsi.org/his/1.0/ws/GetValuesObject"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetValuesObject xmlns="http://www.cuahsi.org/his/1.0/ws/">
      <location>string</location>
      <variable>string</variable>
      <startDate>string</startDate>
      <endDate>string</endDate>
      <authToken>string</authToken>
    </GetValuesObject>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetValuesObjectResponse xmlns="http://www.cuahsi.org/his/1.0/ws/">
      <timeSeriesResponse xmlns="http://www.cuahsi.org/waterML/1.0/">
        <queryInfo>
          <creationTime>dateTime</creationTime>
          <queryURL>string</queryURL>
          <querySQL>string</querySQL>
          <criteria>
            <locationParam>string</locationParam>
            <variableParam>string</variableParam>
            <timeParam xsi:nil="true" />
          </criteria>
          <note type="string" href="string" title="string" show="string" />
          <note type="string" href="string" title="string" show="string" />
          <extension />
        </queryInfo>
        <timeSeries name="string">
          <sourceInfo />
          <variable oid="normalizedString" metadataDateTime="dateTime">
            <variableCode xsi:nil="true" />
            <variableCode xsi:nil="true" />
            <variableName>string</variableName>
            <variableDescription>string</variableDescription>
            <valueType>Field Observation or Sample or Model Simulation Result or Derived Value</valueType>
            <generalCategory>Water Quality or Climate or Hydrology or Geology or Biota</generalCategory>
            <sampleMedium>Surface Water or Ground Water or Sediment or Soil or Air or Tissue or Precipitation</sampleMedium>
            <units xsi:nil="true" />
            <options xsi:nil="true" />
            <note xsi:nil="true" />
            <note xsi:nil="true" />
            <related xsi:nil="true" />
            <extension />
          </variable>
          <values timeZoneShiftApplied="boolean" unitsAbbreviation="normalizedString" unitsCode="token" unitsType="Angle or Area or Dimensionless or Energy or Energy Flux or Flow or Force or Frequency or Length or Light or Mass or Permeability or Power or Pressure/Stress or Resolution or Scale or Temperature or Time or Velocity or Volume" count="nonNegativeInteger" unitsAreConverted="boolean">
            <value xsi:nil="true" />
            <value xsi:nil="true" />
            <qualifier xsi:nil="true" />
            <qualifier xsi:nil="true" />
            <qualityControlLevel xsi:nil="true" />
          </values>
        </timeSeries>
      </timeSeriesResponse>
    </GetValuesObjectResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /wateroneflow/NAM12k/Service.asmx HTTP/1.1
Host: river.sdsc.edu
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetValuesObject xmlns="http://www.cuahsi.org/his/1.0/ws/">
      <location>string</location>
      <variable>string</variable>
      <startDate>string</startDate>
      <endDate>string</endDate>
      <authToken>string</authToken>
    </GetValuesObject>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetValuesObjectResponse xmlns="http://www.cuahsi.org/his/1.0/ws/">
      <timeSeriesResponse xmlns="http://www.cuahsi.org/waterML/1.0/">
        <queryInfo>
          <creationTime>dateTime</creationTime>
          <queryURL>string</queryURL>
          <querySQL>string</querySQL>
          <criteria>
            <locationParam>string</locationParam>
            <variableParam>string</variableParam>
            <timeParam xsi:nil="true" />
          </criteria>
          <note type="string" href="string" title="string" show="string" />
          <note type="string" href="string" title="string" show="string" />
          <extension />
        </queryInfo>
        <timeSeries name="string">
          <sourceInfo />
          <variable oid="normalizedString" metadataDateTime="dateTime">
            <variableCode xsi:nil="true" />
            <variableCode xsi:nil="true" />
            <variableName>string</variableName>
            <variableDescription>string</variableDescription>
            <valueType>Field Observation or Sample or Model Simulation Result or Derived Value</valueType>
            <generalCategory>Water Quality or Climate or Hydrology or Geology or Biota</generalCategory>
            <sampleMedium>Surface Water or Ground Water or Sediment or Soil or Air or Tissue or Precipitation</sampleMedium>
            <units xsi:nil="true" />
            <options xsi:nil="true" />
            <note xsi:nil="true" />
            <note xsi:nil="true" />
            <related xsi:nil="true" />
            <extension />
          </variable>
          <values timeZoneShiftApplied="boolean" unitsAbbreviation="normalizedString" unitsCode="token" unitsType="Angle or Area or Dimensionless or Energy or Energy Flux or Flow or Force or Frequency or Length or Light or Mass or Permeability or Power or Pressure/Stress or Resolution or Scale or Temperature or Time or Velocity or Volume" count="nonNegativeInteger" unitsAreConverted="boolean">
            <value xsi:nil="true" />
            <value xsi:nil="true" />
            <qualifier xsi:nil="true" />
            <qualifier xsi:nil="true" />
            <qualityControlLevel xsi:nil="true" />
          </values>
        </timeSeries>
      </timeSeriesResponse>
    </GetValuesObjectResponse>
  </soap12:Body>
</soap12:Envelope>