Introduction

The GetPropertyDamage service will take a lat/lon coordinate and return a metadata response (JSON or xml) for structures with associated catastrophic damage attributes as well as some pre-damage attributes. This service is run against graysky imagery and is available for all graysky collections from March 2022 and beyond.

• Damage Assessment

• Catastrophic Response

• Insurance Assessments

This is a transactional service; each requests will be billed against the agreed upon rate and aggregated into a billing cycle. Please contact Customer Advocacy at support@vexcelgroup.com.

Open

Technical Details

This Property Damage service provides access to computer-generated post-catastrophe damage assessment information on an individual structure basis. Damage Assessments are precomputed for graysky collections and are available for all graysky events beginning in 2022. catastrophe_score is calculated based on the detected structural_damage_percent, missing_material_percent, tarp_percent and debris_percent. fema_classification is an estimation of damage using FEMA’s classification categories, it is not derived from FEMA nor guaranteed to match FEMA’s official classification but is intended to offer a prediction of FEMA’s survey. The HistoScore attribute will provide an estimate of the source imagery’s clarity or obscurity (cloud, smoke, shadow, etc.). The structure of this service’s response contains an array of structures, within each structure is a post-catastrophe object (damage assessment attributes) and a pre-catastrophe object (attributes similar to what is available from GetPropertyInformation for the target structure’s parcel and all parcel-based attributes, including the pre-catastrophe structure attributes).

Data Dictionary

The following list contains definitions for the objects that are unique to this service. For definitions of all other objects, please reference the Data Dictionary in the GetPropertyInformation service.

Base URL

This service will answer to requests on following URL (mandatory parameters only):

https://api.gic.org/damage/GetPropertyDamage?wkt={wkt}&token={token}

Parameters

Examples

Tampa, Florida Hurricane- Demonstrating aoi

https://api.gic.org/damage/GetPropertyDamage?wkt=POINT (-82.497153 27.573122)&aoi=us-fl-milton-hurricane-2024&token={token}

Sample Response (Damage Assessment Information only):

. . . "post_catastrophe": { "structure": [ { "catastrophe_score": 0.0, "fema_classification": null, "roof_condition": { "structural_damage_percent": 0.0, "missing_material_percent": 0.0, "tarp_percent": 0.0, "debris_percent": null, "discoloration": { "detected": true, "percentage": 16.31, "score": 0.65 } }, "source_image_metadata": { "camera_technology": "UltraCam_Condor_4.1_f120", "gsd": 3.98, . . .

 

Companion Graysky Image:

 

Open

https://api.gic.org/images/ExtractImages/graysky?mode=one&EPSG=4326&zoom=0&xcoordinate=-82.497153&ycoordinate=27.573122&orientation=Nadir&nadirRotatedNorth=yes&aoi=us-fl-milton-hurricane-2024&width=600&height=400

________________________________________________________________________________________

Camarillo Mountain, California Fire - Demonstrating format and search_radius

https://api.gic.org/damage/GetPropertyDamage?wkt=POINT(-119.061084 34.248623)&format=xml&search_radius=10&token={token}

Sample Response (Damage Assessment Information only):

<properties> <property> <post_catastrophe> <structure> <catastrophe_score>100.0</catastrophe_score> <fema_classification>FEMA 6 / Destroyed</fema_classification> <roof_condition> <tarp_percent>null</tarp_percent> <discoloration> <score>null</score> <percentage>null</percentage> <detected>null</detected> </discoloration> <debris_percent>null</debris_percent> <missing_material_percent>null</missing_material_percent> <structural_damage_percent>null</structural_damage_percent> </roof_condition> <source_image_metadata> <child_aoi>graydata-707</child_aoi> . . .

 

Companion Graysky Image:

 

Open

https://api.gic.org/images/ExtractImages/graysky?mode=one&EPSG=4326&zoom=0&xcoordinate=-119.061084&ycoordinate=34.248623&orientation=Nadir&nadirRotatedNorth=yes&aoi=us-ca-camarillomountain-fire-2024&width=2400&height=1600