Request structure
Wind/Hail Risk Score can be requested as a supplementary data source. The windHailRiskScore supplementary data source can be requested along with other supplementary data sources such as hurricaneScore and defensibleSpace.
The Wind/Hail Risk Score can be requested independently without requiring windScore or hailScore in the same request. As the Wind/Hail Risk Score is attached to footprint feature classes (Roof or Building Lifecycle), any pack that returns footprint features needs to be supplied via the packs parameter (i.e. roof_char). Alternatively, the classes parameter can be used to supply the Roof and/or Building Lifecycle feature class IDs instead.
Wind/Hail Risk Score is only available for Gen 6 resources, so when making date-based features requests, systemVersionPrefix=gen6 will also be needed.
As clipped/unclipped feature geometry is closely linked to the parcelMode request parameter, when wanting to generate scores for clipped building footprints (e.g. requesting scores for a single property in row houses) parcelMode=true must be supplied.
Example Request using windHailRiskScore
curl "https://api.nearmap.com/ai/features/v4/features.json?polygon=-108.083501%2C36.802239%2C-108.083695%2C36.802397%2C-108.084614%2C36.803152%2C-108.083134%2C36.803882%2C-108.082868%2C36.803245%2C-108.082504%2C36.802355%2C-108.082863%2C36.802315%2C-108.083501%2C36.802239&packs=roof_char&include=windHailRiskScore&since=2024-06-03&until=2024-06-03&systemVersionPrefix=gen6&parcelMode=true&apikey=$APIKEY"
Response structure
- For features that will have Wind/Hail Risk Score supplementary data (i.e. Roof and Building Lifecycle class), a new field is added called
windHailRiskScore. - Only with Roof features, unless the roof has significant damage detected. Then the wind/hail risk score will be associated with the Building Lifecycle feature. The
windHailRiskScore field contains: - Risk Data:
riskScore: An integer from 1-5 representing combined wind and hail claim likelihood (1 = most likely to file a wind or hail claim, 5 = least likely)riskRateFactor: A float representing the rate adjustment factor that can be used to adjust premium based on combined wind/hail risk
modelInputFeatures: An object containing the component scores used as inputs:windRiskScore: The individual Wind Risk Score (1-5)hailRiskScore: The individual Hail Risk Score (1-5)
Sample response (excerpt):
