> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pingintel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ping Hazard v1

**Code: PH**

Ping's own hazard aggregator — combines FEMA flood zone, storm surge, wildfire, crime, and distance-to-hazard data into a single per-location hazard profile.

[Data dictionary (.xlsx)](https://data-api-dev.sovfixer.com/api/v1/datasources/PH/data_dictionary.xlsx)

**Required input:** `latitude`, `longitude`

<Note>
  When Ping.Extraction fetches this data on your behalf, the Ping JSON format
  makes these payloads available under the `external_data[PH]` key of each building.
</Note>

### Response Metadata

The following attributes describe the status, context, and quality of the hazard/risk data returned for the location.

| **Data Element**       | **Description**                                                                                   |
| :--------------------- | :------------------------------------------------------------------------------------------------ |
| consulted\_datasources | List of data source codes used to generate the hazard and risk outputs for the location. `object` |
| state                  | The U.S. state where the location is found. `text`                                                |
| county                 | Name of the county where the property is located. `text`                                          |
| fips\_code             | U.S. Census Bureau 5-digit state+county FIPS code for the location. `text`                        |

### Flood Data

The following attributes describe flood-related hazard exposure, proximity to the coast, FEMA flood classification, and surge modeling.

| **Data Element**                               | **Description**                                                                                                                                                          |
| :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| fema\_flood\_zone\_dfirm\_id                   | FEMA Digital Flood Insurance Rate Map (DFIRM) panel identifier. `text`                                                                                                   |
| fema\_flood\_zone\_version\_id                 | Version identifier representing the specific FEMA flood zone data. `text`                                                                                                |
| fema\_flood\_zone\_version\_date               | Date of the FEMA flood zone data version used for this record. `date`                                                                                                    |
| fema\_flood\_zone                              | FEMA flood zone designation indicating the level of flood risk. `text` <details><summary>Values</summary>A, AE, A1–A30, AO, AR, A99, V, VE, V1–V30, B, C, D, X</details> |
| fema\_flood\_zone\_subtype                     | Additional description on the features within the primary FEMA flood zone. `text`                                                                                        |
| slosh\_zone\_category                          | The SLOSH (Sea, Lake, and Overland Surges from Hurricanes) storm surge category assigned to this location. `number` **Values:** 1-5                                      |
| slosh\_zone\_value                             | Estimated storm surge height in feet for the associated SLOSH category. `number`                                                                                         |
| distance\_to\_coast\_miles                     | Distance from the location to the coast, measured in miles. `number`                                                                                                     |
| distance\_to\_coast\_feet                      | Distance from the location to the coast, measured in feet. `number`                                                                                                      |
| distance\_to\_coast\_closest\_point\_longitude | Longitude of the nearest point on the coast to the location. `number`                                                                                                    |
| distance\_to\_coast\_closest\_point\_latitude  | Latitude of the nearest point on the coast to the location. `number`                                                                                                     |
| distance\_to\_coast\_connected\_lines          | WKT LineString connecting the location to the nearest point on the coast. `list[text]`                                                                                   |

### Risk Data

The following attributes provide grade, numeric and textual ratings, and monetary values for different risk categories.

#### Composite

| **Data Element** | **Description**                                                                                                                                                         |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| risk\_score      | FEMA's National Risk Index (NRI) composite score for the location, a national percentile indicating relative risk from natural hazards. `number` **Values:** 0-100      |
| risk\_value      | Expected annual loss in USD used to derive the risk\_score percentile. `currency`                                                                                       |
| risk\_ratng      | Overall risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Avalanche

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| avln\_riskv      | Expected annual loss in USD for avalanche hazards. `currency`                                                                                                                    |
| avln\_risks      | Avalanche hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| avln\_riskr      | Avalanche hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Coastal Flooding

| **Data Element** | **Description**                                                                                                                                                                      |
| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| cfld\_riskv      | Expected annual loss in USD for coastal flood hazards. `currency`                                                                                                                    |
| cfld\_risks      | Coastal flood hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| cfld\_riskr      | Coastal flood hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Cold Wave

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| cwav\_riskv      | Expected annual loss in USD for cold wave hazards. `currency`                                                                                                                    |
| cwav\_risks      | Cold wave hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| cwav\_riskr      | Cold wave hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Drought

| **Data Element** | **Description**                                                                                                                                                                |
| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| drgt\_riskv      | Expected annual loss in USD for drought hazards. `currency`                                                                                                                    |
| drgt\_risks      | Drought hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| drgt\_riskr      | Drought hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Earthquake

| **Data Element** | **Description**                                                                                                                                                                   |
| :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| erqk\_riskv      | Expected annual loss in USD for earthquake hazards. `currency`                                                                                                                    |
| erqk\_risks      | Earthquake hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| erqk\_riskr      | Earthquake hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Hail

| **Data Element** | **Description**                                                                                                                                                             |
| :--------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| hail\_riskv      | Expected annual loss in USD for hail hazards. `currency`                                                                                                                    |
| hail\_risks      | Hail hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| hail\_riskr      | Hail hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Heat Wave

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| hwav\_riskv      | Expected annual loss in USD for heat wave hazards. `currency`                                                                                                                    |
| hwav\_risks      | Heat wave hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| hwav\_riskr      | Heat wave hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Hurricane

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| hrcn\_riskv      | Expected annual loss in USD for hurricane hazards. `currency`                                                                                                                    |
| hrcn\_risks      | Hurricane hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| hrcn\_riskr      | Hurricane hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Ice Storm

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| istm\_riskv      | Expected annual loss in USD for ice storm hazards. `currency`                                                                                                                    |
| istm\_risks      | Ice storm hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| istm\_riskr      | Ice storm hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Landslide

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| lnds\_riskv      | Expected annual loss in USD for landslide hazards. `currency`                                                                                                                    |
| lnds\_risks      | Landslide hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| lnds\_riskr      | Landslide hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Lightning

| **Data Element** | **Description**                                                                                                                                                                  |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ltng\_riskv      | Expected annual loss in USD for lightning hazards. `currency`                                                                                                                    |
| ltng\_risks      | Lightning hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| ltng\_riskr      | Lightning hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Riverine Flooding

| **Data Element** | **Description**                                                                                                                                                                       |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| rfld\_riskv      | Expected annual loss in USD for riverine flood hazards. `currency`                                                                                                                    |
| rfld\_risks      | Riverine flood hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| rfld\_riskr      | Riverine flood hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Strong Wind

| **Data Element** | **Description**                                                                                                                                                                    |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| swnd\_riskv      | Expected annual loss in USD for strong wind hazards. `currency`                                                                                                                    |
| swnd\_risks      | Strong wind hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| swnd\_riskr      | Strong wind hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Tornado

| **Data Element** | **Description**                                                                                                                                                                |
| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| trnd\_riskv      | Expected annual loss in USD for tornado hazards. `currency`                                                                                                                    |
| trnd\_risks      | Tornado hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| trnd\_riskr      | Tornado hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Tsunami

| **Data Element** | **Description**                                                                                                                                                                |
| :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| tsun\_riskv      | Expected annual loss in USD for tsunami hazards. `currency`                                                                                                                    |
| tsun\_risks      | Tsunami hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| tsun\_riskr      | Tsunami hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Volcanic Activity

| **Data Element** | **Description**                                                                                                                                                                          |
| :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| vlcn\_riskv      | Expected annual loss in USD for volcanic activity hazards. `currency`                                                                                                                    |
| vlcn\_risks      | Volcanic activity hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| vlcn\_riskr      | Volcanic activity hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Wildfire

| **Data Element** | **Description**                                                                                                                                                                 |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| wfir\_riskv      | Expected annual loss in USD for wildfire hazards. `currency`                                                                                                                    |
| wfir\_risks      | Wildfire hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| wfir\_riskr      | Wildfire hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

#### Winter Weather

| **Data Element** | **Description**                                                                                                                                                                       |
| :--------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| wntw\_riskv      | Expected annual loss in USD for winter weather hazards. `number`                                                                                                                      |
| wntw\_risks      | Winter weather hazard risk score (national percentile, 0-100). `number` **Values:** 0-100                                                                                             |
| wntw\_riskr      | Winter weather hazard risk rating label. `text` <details><summary>Values</summary>Not Applicable, Very Low, Relatively Low, Relatively Moderate, Relatively High, Very High</details> |

### Fire Data

The following attributes describe wildfire hazard, fire protection, and proximity to fire response infrastructure.

| **Data Element**                           | **Description**                                                                                                                                                                                                                                                                                     |
| :----------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| burn\_probability                          | Annual probability of a wildfire burning the location. `percentage` **Values:** 0.0-1.0                                                                                                                                                                                                             |
| aais\_classification                       | Fire protection classification code and description from the AAIS system (e.g., 'P1, PROTECTED 1' indicates highest protection level). `text` <details><summary>Values</summary>P1, P2, P3, P4, P5, PP1, PP2, PP3, PP4, PP5, U6, U7, U8, U9, U10, U15, U20, U25, U30, U35, U40, U45, U45+</details> |
| ping\_fire\_protection\_class              | ISO/Ping Fire Protection Class (FPC) score; lower values indicate better fire protection. `number` **Values:** 1-10                                                                                                                                                                                 |
| distance\_to\_fire\_station\_feet          | Distance from the location to the nearest fire station, measured in feet. `number`                                                                                                                                                                                                                  |
| distance\_to\_fire\_hydrant\_feet          | Distance from the location to the nearest fire hydrant, measured in feet. `number`                                                                                                                                                                                                                  |
| fire\_station\_point                       | Geographic point representing the nearest fire station, in WKT format (e.g., POINT (longitude latitude)). `text`                                                                                                                                                                                    |
| fire\_station\_closest\_point\_longitude   | Longitude of the closest fire station to the property location. `number`                                                                                                                                                                                                                            |
| fire\_station\_closest\_point\_latitude    | Latitude of the closest fire station to the property location. `number`                                                                                                                                                                                                                             |
| fire\_station\_extra\_data                 | Extra data about the nearest fire station, including name, address, geographic coordinates, city, state, zip code, and whether it is staffed by volunteers. `object`                                                                                                                                |
|   fire\_station\_extra\_data.name          | Fire station name. `text`                                                                                                                                                                                                                                                                           |
|   fire\_station\_extra\_data.address       | Street address of the fire station. `text`                                                                                                                                                                                                                                                          |
|   fire\_station\_extra\_data.city          | City of the fire station. `text`                                                                                                                                                                                                                                                                    |
|   fire\_station\_extra\_data.state         | Two-letter U.S. state code. `text`                                                                                                                                                                                                                                                                  |
|   fire\_station\_extra\_data.zip\_code     | ZIP code of the fire station. `text`                                                                                                                                                                                                                                                                |
|   fire\_station\_extra\_data.full\_address | Single-line concatenation of address, city, state, and zip. `text`                                                                                                                                                                                                                                  |
|   fire\_station\_extra\_data.latitude      | Latitude of the fire station. `number`                                                                                                                                                                                                                                                              |
|   fire\_station\_extra\_data.longitude     | Longitude of the fire station. `number`                                                                                                                                                                                                                                                             |
|   fire\_station\_extra\_data.geometry      | WKT POINT geometry for the fire station location. `text`                                                                                                                                                                                                                                            |
|   fire\_station\_extra\_data.volunteer     | True if the station is staffed by volunteers. `boolean` **Values:** True, False                                                                                                                                                                                                                     |
| fire\_hydrant\_point                       | Geographic point representing the nearest fire hydrant, in WKT format (e.g., POINT (longitude latitude)). `text`                                                                                                                                                                                    |
| fire\_hydrant\_closest\_point\_longitude   | Longitude of the closest fire hydrant to the property location. `number`                                                                                                                                                                                                                            |
| fire\_hydrant\_closest\_point\_latitude    | Latitude of the closest fire hydrant to the property location. `number`                                                                                                                                                                                                                             |

### Crime Data

The following attributes describe crime statistics and safety metrics for the location.

| **Data Element**      | **Description**                                                                                                                            |
| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |
| total\_crime\_grade   | Overall crime grade for the property area. `text` **Values:** A-F                                                                          |
| murder\_grade         | Crime grade for murder/homicide rate in the area. `text` **Values:** A-F                                                                   |
| rape\_grade           | Crime grade for rape/sexual assault rate in the area. `text` **Values:** A-F                                                               |
| robbery\_grade        | Crime grade for robbery rate in the area. `text` **Values:** A-F                                                                           |
| assault\_grade        | Crime grade for aggravated assault rate in the area. `text` **Values:** A-F                                                                |
| burglary\_grade       | Crime grade for burglary rate in the area. `text` **Values:** A-F                                                                          |
| larceny\_grade        | Crime grade for larceny/theft rate in the area. `text` **Values:** A-F                                                                     |
| vehicle\_theft\_grade | Crime grade for motor vehicle theft rate in the area. `text` **Values:** A-F                                                               |
| total\_crime\_index   | Numeric EASI total crime index (US average=100, range 0-200; approximately 2x the national percentile rank). Higher = more crime. `number` |

### Florida Sinkhole Data

The following attributes describe the proximity and characteristics of the nearest known sinkhole in Florida.

| **Data Element**                             | **Description**                                                                                                                                                           |
| :------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| distance\_to\_florida\_sinkhole\_feet        | Distance from the property to the nearest known Florida sinkhole, in feet. `number`                                                                                       |
| florida\_sinkhole\_point                     | Geographic point representing the nearest known sinkhole in Florida, in WKT format (e.g., POINT (longitude latitude)). `text`                                             |
| florida\_sinkhole\_closest\_point\_longitude | Longitude of the closest known sinkhole in Florida to the property location. `number`                                                                                     |
| florida\_sinkhole\_closest\_point\_latitude  | Latitude of the closest known sinkhole in Florida to the property location. `number`                                                                                      |
| florida\_sinkhole\_extra\_data               | Extra data about the closest Florida sinkhole, including coordinates, event dates, geological characteristics, damage reports, and other sinkhole-specific data. `object` |

### Elevation Data

The following attributes describe the elevation and topographic characteristics of the location.

| **Data Element**   | **Description**                                                                                                            |
| :----------------- | :------------------------------------------------------------------------------------------------------------------------- |
| elevation\_meters  | Elevation of the location above sea level, in meters. `number`                                                             |
| resolution\_meters | Size of each grid cell in the underlying risk data, in meters. Smaller values indicate higher spatial resolution. `number` |