# Storm Sample

Storm hazards covering marine/coastal storm warnings, sourced from NWS and other agencies. Note: This type covers general storm warnings distinct from tropical cyclones, winter storms, and severe weather categories. These hazards aggregate multiple NWS alert products into a single consolidated hazard record.

## Storm-Specific Properties

### Incident Data

The `incident.properties` object for storm hazards follows the NWS alert format, containing metadata from the issuing weather service offices about the storm event and its expected conditions.

**Key incident properties for storms (NWS alert format) include:**

* `senderName` - Name of the issuing authority (e.g., "NWS Marquette MI")
* `headline` - Brief summary of the alert (e.g., "Storm Watch, Gale Watch, Gale Warnings and Small Craft Advisories...")
* `description` - Detailed description including individual alert text (may be very long for multi-alert events)
* `severity` - Severity classification (e.g., "WATCH")
* `urgency` - Urgency level (e.g., "Future")
* `certainty` - Certainty classification (e.g., "Possible")
* `event` - Event type descriptor ("Storm")
* `messagePhenomena` - NWS phenomena code ("SR" for Storm)
* `messageSignificance` - NWS significance code ("W" for Warning)
* `officeId` - Issuing NWS office identifier (e.g., "PAFC")
* `eventId` - NWS event identifier (e.g., "PAFC-SR-W-1054")
* `locationName` - Detailed description of affected geographic areas
* `areaDescription` - Human-readable area description matching locationName
* `affectedZoneIds` - List of NWS zone identifiers covered by the alert
* `geocode` - SAME and UGC zone code mappings for the alert area

### Features

The `features` property is `null` for this storm hazard. When NWS alert features are available through the enrichment pipeline, this property may contain CAP\_INFO features with alert polygon geometries representing individual alert areas.

### Exposure Areas

Single level - source-provided alert area. The `exposureAreas` FeatureCollection contains one feature with an `exposureLevel` property (e.g., level 2 for STRONG) covering the combined geographic extent of all consolidated storm warning zones.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Storm - Lake Superior, northern Michigan and Isle Royale, United States"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "NWS Marquette MI has issued a Storm watch for March 16, 2026 00:00:00 UTC through March 17, 2026 06:00:00 UTC...."
    }
  ],
  "severity": "WATCH",
  "category": "EVENT",
  "incident": {
    "uuid": "9ed6ea4a-8766-451a-badd-e86406a092ae",
    "type": "STORM",
    "sourceId": 1801,
    "sourceRecordId": "b8c0ab98-a53f-4d64-8519-cd47a56cca41",
    "properties": {
      "senderName": "NWS Marquette MI",
      "urgency": "Future",
      "id": "urn:oid:2.49.0.1.840.0.c32136499bb124f5c75829611b3a379547836a61.002.4",
      "headline": "Storm Watch, Gale Watch, Gale Warnings and Small Craft Advisories for Lake Superior (Northern Michigan and Isle Royale), United States",
      "severity": "WATCH",
      "certainty": "Possible",
      "status": "Actual",
      "...": ""
    }
  },
  "uuid": "02aee4e9-2c51-4b4f-ba84-7296ddf2beb7",
  "comment": null,
  "createdAt": 1773433232,
  "relatedHazards": [],
  "longitude": -88.36131,
  "latitude": 47.12715,
  "version": 2,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": null,
  "exposureAreas": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": {
          "exposureLevel": 2
        }
      }
    ]
  },
  "exposureAssessment": {
    "population": {
      "total": 201,
      "total0_14": 35,
      "total15_64": 131,
      "households": 81,
      "vulnerable": 24,
      "total65_Plus": 35
    },
    "capital": {
      "total": 906105300,
      "school": 0,
      "hospital": 0
    },
    "totalByCountry": [
      {
        "population": {
          "total": 0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0,
          "vulnerable": 0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      },
      {
        "population": {
          "total": 201,
          "total0_14": 35,
          "total15_64": 131,
          "households": 81,
          "vulnerable": 24,
          "total65_Plus": 35
        },
        "country": "USA",
        "capital": {
          "total": 906105300,
          "school": 0,
          "hospital": 0
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 48.2,
        "waterNeedsUnit": "gal",
        "waterNeeds": 19.09925,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 2.41,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 276.668
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 201,
          "total0_14": 35,
          "total15_64": 131,
          "households": 81,
          "vulnerable": 24,
          "total65_Plus": 35
        },
        "country": "USA",
        "capital": {
          "total": 906105300,
          "school": 0,
          "hospital": 0
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 48.2,
        "waterNeedsUnit": "gal",
        "waterNeeds": 19.09925,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 2.41,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 276.668
      },
      {
        "population": {
          "total": 0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0,
          "vulnerable": 0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      }
    ],
    "exposureLevels": [
      {
        "level": "2",
        "data": {
          "population": {
            "total": 201,
            "total0_14": 35,
            "total15_64": 131,
            "households": 81,
            "vulnerable": 24,
            "total65_Plus": 35
          },
          "capital": {
            "total": 906105300,
            "school": 0,
            "hospital": 0
          },
          "totalByCountry": [
            {
              "population": {
                "total": 0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0,
                "vulnerable": 0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            },
            {
              "population": {
                "total": 201,
                "total0_14": 35,
                "total15_64": 131,
                "households": 81,
                "vulnerable": 24,
                "total65_Plus": 35
              },
              "country": "USA",
              "capital": {
                "total": 906105300,
                "school": 0,
                "hospital": 0
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 48.2,
              "waterNeedsUnit": "gal",
              "waterNeeds": 19.09925,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 2.41,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 276.668
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0,
                "vulnerable": 0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            },
            {
              "population": {
                "total": 201,
                "total0_14": 35,
                "total15_64": 131,
                "households": 81,
                "vulnerable": 24,
                "total65_Plus": 35
              },
              "country": "USA",
              "capital": {
                "total": 906105300,
                "school": 0,
                "hospital": 0
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 48.2,
              "waterNeedsUnit": "gal",
              "waterNeeds": 19.09925,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 2.41,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 276.668
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 50610.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 72.3,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 2.41,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 83.145
        },
        "exposureDescription": "STRONG"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773433216842",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 50610.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 72.3,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 2.41,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 83.145
  },
  "type": "STORM",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1773619200,
  "updatedAt": 1773433216,
  "endedAt": 1773727200
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, `alertGeometry` and `exposureAreas` contain complete GeoJSON coordinate arrays. The `incident.properties` object has been truncated with `"..."` to show only key fields; the full `description` field contains text from all consolidated NWS alert products. The `features` property is `null` for this hazard. The `source` field is `null` for NWS storm hazards. Population values within `exposureAssessment` are integers; `capital.school` and `capital.hospital` are counts of exposed facilities.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-v2-docs.disasteraware.com/hazards/hazard-samples/storm-sample.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.