Enriches exposure data for the specified location.
A location is a property, building, business, or other asset that may be damaged by catastrophe events. Prior to risk analysis, a location must be enriched with geolocation data, hazard lookup data, or enhanced risk data.
This operation supports two distinct jobs, depending on the job type specified in the request body:
- If
geocodeis specified for thetypeparameter, the operation geocodes the specified location. - If
hazardis specified for thetypeparameter, the operation looks up hazard data or enhanced risk data for the specified location.
Geocoding
Geocoding enriches a location exposure with geolocation data that precisely identifies the global coordinates of a site. Geocoding is a prerequisite for all catastrophe modelling processes. A location may be geocoded at different resolution levels. The lower the resolution level, the more accurate the the location coordinates returned by the geocoding service.
Risk Modeler not only provides geocoding support for countries that have RMS catastrophe models, but also supports geocoding for a large number of countries where no models are currently available. The specific countries that can be geocoded depend on your organization's licensing agreements with Moody's.
| Layer | Engine | Available Versions |
|---|---|---|
geocode | RL | 18.0, 18.1, 21.0, 22.0, 23.0, 24.0, 25.0 |
geocode | HD | 18.0, 18.1, 21.0, 22.0, 23.0, 24.0, 25.0 |
Moody's recommends that the hazard layer version matches the version specified in the model profile in the modeling job.
Geocoding Licensing
The Risk Data API supports the definition, importation, and geocoding of locations in over 230 countries. Locations may be geocoded in countries that have RMS catastrophe models and countries that have no models. Your ability to geocode locations in specific countries depend on your company’s licensing agreements with Moody's.
Hazard lookups
If hazard is specified for the type parameter, the operation looks up hazard data for the specified location.
The Hazard lookup retrieves data about local conditions and potential hazards for a location. Hazarding enriches a location exposure with risk data drawn from an RMS peril model database, a collection of site hazard values that characterize the vulnerability of a location to a catastrophe event. While some hazard data is required prior to analysis, other hazard data can be licensed and retrieved to help you further understand a location's risk. Hazard lookups are not performed for non-modeled countries.
Moody's recommends that the version of hazard layer specified matches the version specified in the model profile in the modeling job.
This operation supports hazard data lookups for two DLM (RL) peril models: earthquake, windstorm. Other DLM peril models, do not require hazard lookups prior to modeling.
| Layer | Engine | Available Versions | Regions |
|---|---|---|---|
earthquake | RL | 18.0, 18.1, 21.0, 22.0, 23.0, 24.0, 25.0 | |
windstorm | RL | 18.0, 18.1, 21.0, 22.0, 23.0, 24.0, 25.0 |
This operation supports hazard data lookups for high-definition (HD) models. Hazard lookup data may be restricted to locations in selected regions:
| Layer | Engine | Available Versions | Available Regions |
|---|---|---|---|
distance_to_fire_station | HD | 1.0 | United States |
distance_to_inner_coast | HD | 1.0 | United States |
fema_firm | HD | 1.0, 3.0 | United States |
fl_hazard | HD | 1.0, 1.1, 1.2, 1.3 | |
global_fl_depth | HD | 1.0, 2.0 | Europe, New Zealand, Global |
hd_earthquake | HD | ||
mmi | HD | 18.0, 18.1, 3.0 | North America, Central and South America, Europe |
subsidence | HD | United States | |
surge | HD | 1.0, 1.1, 1.2, 1.3 | |
wf_model_hazard | HD | United States, Canada | |
wf_supplemental_hazard | HD | United States | |
wildfire | HD | 1.0, 1.1, 1.2, 1.3 | |
ws_model_hazard | HD | ||
ws_windpool_zone | HD | 1.0 | United States |
Hazard lookups are required for modeling surge losses using the US Inland Flood HD model (fl_hazard and surge) only.
Enhanced Risk Data
Enhanced risk data is not required for modeling, but it can be retrieved during hazard lookup to better understand a location's risk. Enhanced risk data includes risk scores and ESDB exposure enrichment,
Enhanced risk data is available for high-resolution locations only, e.g. locations geocoded at postal code resolution (GeoResolutionCode = 5) or better.
| Layer | Engine | Type | Available Versions | Regions |
|---|---|---|---|---|
cs_risk_score | HD | Risk Score | 1.0, 1.1 | United States, Canada, Europe |
distance_to_fault | HD | Enhanced Hazard | 17.0 | United States |
eq_risk_score | HD | Risk Score | 18.0, 18.1, 22.0 24.0 | United States, Canada, Central & South America, Caribbean, Southeast Asia |
esdb_building_attributes | HD | ESDB | 7.1, 7.2, 8.0,8.2, 9.1, 10.0 | United States |
fl_depth | HD | Enhanced Hazard | 1.0, 1.1, 1.2 1.3, 2.0 | Global, United States, Europe, New Zealand |
fl_risk_score | HD | Risk Score | 1.0, 2.0 | United States, Europe, India |
tr_risk_score | HD | Risk Score | United States | |
ws_risk_score | HD | Risk Score | 18.0, 18.1, 21.0, 22.0 23.0 | |
wt_risk_score | HD | Risk Score | 18.0, 18.1, 21.0, 22.0 23.0 | United States, Canada |
Enhanced Risk Data Licensing
Enhanced risk data requires a separate license that is available whether or not you license Moody's models.
If you select enhanced risk data but do not license it for any region, you see an error message when you click Submit on the Geocode and Hazard screen.
If you select a enhanced risk data that's available for multiple regions, and you don't license it for the region where you have exposures, you can submit the job but the hazard data won't be retrieved for that region.
For information about what hazard data is licensed by your organization, your Intelligent Risk Platform™ administrator can check the Licenses > Data section of Admin Center.