# Extreme Temperature Sample

Extreme temperature hazards including extreme heat and extreme cold events, sourced from national weather services (BoM, NWS, Environment Canada) via CAP alerts. These hazards represent official warnings about dangerous temperature conditions that pose risks to public health and safety.

## Extreme Temperature-Specific Properties

### Incident Data

The `incident.properties` object for extreme temperature hazards follows the CAP (Common Alerting Protocol) structure, containing metadata from the issuing weather service about the temperature event and its expected impact.

**Key incident properties for extreme temperature (CAP-based) include:**

* `senderName` - Name of the issuing authority (e.g., "NWS Tucson AZ and NWS Phoenix AZ")
* `headline` - Brief summary of the alert (e.g., "Extreme Heat Watch for South-Central and Southwest Arizona...")
* `description` - Detailed description of expected conditions
* `severity` - CAP severity level (e.g., "WATCH")
* `urgency` - CAP urgency classification (e.g., "Future")
* `certainty` - CAP certainty level (e.g., "Likely")
* `event` - Event type descriptor (e.g., "Extreme Heat")
* `effective` - ISO 8601 timestamp for when the alert takes effect
* `expires` - ISO 8601 timestamp for when the alert expires
* `category` - CAP category classification (e.g., "Met" for meteorological)

### Features

The `features` property is `null` for this extreme temperature hazard. When CAP alert features are available through the enrichment pipeline, the `features` FeatureCollection may contain:

* **CAP\_INFO** - MultiPolygon geometry representing the alert area, with properties mirroring the CAP alert fields including `severity`, `urgency`, `certainty`, `headline`, `description`, `senderName`, `effective`, `expires`, `area` (with `areaDesc` and `geocode`), and `featureType: "CAP_INFO"`
* **SMART\_ALERT** - MultiPolygon geometry representing the computed alert boundary with `featureType: "SMART_ALERT"`
* **EXPOSURE\_AREA** - MultiPolygon geometry for exposure assessment with `severity` (e.g., "STRONG") and `featureType: "EXPOSURE_AREA"`

### Exposure Areas

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

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Excessive Heat - Southwest Arizona & Southeast California, United States"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "NWS Tucson AZ and NWS Phoenix AZ has issued a Excessive Heat watch for March 18, 2026 18:00:00 UTC through March 23, 2026 03:00:00 UTC...."
    }
  ],
  "severity": "WATCH",
  "category": "EVENT",
  "incident": {
    "uuid": "188d8d91-f309-43fa-91dd-97e69254451b",
    "type": "EXTREMETEMPERATURE",
    "sourceId": 1801,
    "sourceRecordId": "9ed9bd39-704a-4ba3-a168-517c97685c40",
    "properties": {
      "senderName": "NWS Tucson AZ and NWS Phoenix AZ",
      "urgency": "Future",
      "id": "urn:oid:2.49.0.1.840.0.fa0ab7ac06584aa567d945d616152173e78fb62b.001.1",
      "headline": "Extreme Heat Watch for South-Central and Southwest Arizona (including Phoenix Metro) and Southeast California through March 22",
      "severity": "WATCH",
      "certainty": "Likely",
      "status": "Actual",
      "...": ""
    }
  },
  "uuid": "f353c464-3cad-4fb9-9d3f-77fad3c5e1c0",
  "comment": null,
  "createdAt": 1773430392,
  "relatedHazards": [],
  "longitude": -111.42524,
  "latitude": 32.42098,
  "version": 3,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": null,
  "exposureAreas": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": {
          "exposureLevel": 2
        }
      }
    ]
  },
  "exposureAssessment": {
    "population": {
      "total": 7090018,
      "total0_14": 1247845,
      "total15_64": 4605676,
      "households": 2847394,
      "vulnerable": 850007,
      "total65_Plus": 1235788
    },
    "capital": {
      "total": 797777412400,
      "school": 2657,
      "hospital": 114
    },
    "totalByCountry": [
      {
        "population": {
          "total": 18,
          "total0_14": 5,
          "total15_64": 12,
          "households": 5,
          "vulnerable": 7,
          "total65_Plus": 1
        },
        "country": "MEX",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Mexico",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 13944.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 19.92,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.664,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 22.908
      },
      {
        "population": {
          "total": 7090000,
          "total0_14": 1247840,
          "total15_64": 4605664,
          "households": 2847390,
          "vulnerable": 850000,
          "total65_Plus": 1235787
        },
        "country": "USA",
        "capital": {
          "total": 797777412400,
          "school": 2657,
          "hospital": 114
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 1700000.0,
        "waterNeedsUnit": "gal",
        "waterNeeds": 673625.0,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 85000.0,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 9758000.0
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 18,
          "total0_14": 5,
          "total15_64": 12,
          "households": 5,
          "vulnerable": 7,
          "total65_Plus": 1
        },
        "country": "MEX",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Mexico",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 13944.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 19.92,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.664,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 22.908
      },
      {
        "population": {
          "total": 7090000,
          "total0_14": 1247840,
          "total15_64": 4605664,
          "households": 2847390,
          "vulnerable": 850000,
          "total65_Plus": 1235787
        },
        "country": "USA",
        "capital": {
          "total": 797777412400,
          "school": 2657,
          "hospital": 114
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 1700000.0,
        "waterNeedsUnit": "gal",
        "waterNeeds": 673625.0,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 85000.0,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 9758000.0
      }
    ],
    "exposureLevels": [
      {
        "level": "2",
        "data": {
          "population": {
            "total": 7090018,
            "total0_14": 1247845,
            "total15_64": 4605676,
            "households": 2847394,
            "vulnerable": 850007,
            "total65_Plus": 1235788
          },
          "capital": {
            "total": 797777412400,
            "school": 2657,
            "hospital": 114
          },
          "totalByCountry": [
            {
              "population": {
                "total": 18,
                "total0_14": 5,
                "total15_64": 12,
                "households": 5,
                "vulnerable": 7,
                "total65_Plus": 1
              },
              "country": "MEX",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Mexico",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 13944.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 19.92,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.664,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 22.908
            },
            {
              "population": {
                "total": 7090000,
                "total0_14": 1247840,
                "total15_64": 4605664,
                "households": 2847390,
                "vulnerable": 850000,
                "total65_Plus": 1235787
              },
              "country": "USA",
              "capital": {
                "total": 797777412400,
                "school": 2657,
                "hospital": 114
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 1700000.0,
              "waterNeedsUnit": "gal",
              "waterNeeds": 673625.0,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 85000.0,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 9758000.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 18,
                "total0_14": 5,
                "total15_64": 12,
                "households": 5,
                "vulnerable": 7,
                "total65_Plus": 1
              },
              "country": "MEX",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Mexico",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 13944.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 19.92,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.664,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 22.908
            },
            {
              "population": {
                "total": 7090000,
                "total0_14": 1247840,
                "total15_64": 4605664,
                "households": 2847390,
                "vulnerable": 850000,
                "total65_Plus": 1235787
              },
              "country": "USA",
              "capital": {
                "total": 797777412400,
                "school": 2657,
                "hospital": 114
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 1700000.0,
              "waterNeedsUnit": "gal",
              "waterNeeds": 673625.0,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 85000.0,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 9758000.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 1785000000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 2550000.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 85000.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 2932500.0
        },
        "exposureDescription": "STRONG"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773430370086",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 1785000000.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 2550000.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 85000.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 2932500.0
  },
  "type": "EXTREMETEMPERATURE",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1773943200,
  "updatedAt": 1773430368,
  "endedAt": 1774234800
}
```

{% 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 `features` property is `null` for this hazard. The `source` field is `null` for NWS extreme temperature 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/extremetemperature-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.