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.

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.

Object				Description	Unit	Possible Values

Object				Description	Unit	Possible Values
`damage_` `assessments`	`catastrophe_score`			A score representing the catastrophic condition of the roof.		0 to 100
	`fema_classification`			An estimation of damage using FEMA’s classification categories. `null` - no damage (0) `FEMA 0 / Minor` (1-15) `FEMA 1 / Moderate` (15-30) `FEMA 2 / Moderate` (30-45) `FEMA 3 / Moderate` (45-60) `FEMA 4 / Major` (60-75) `FEMA 5 / Major` (75-90) `FEMA 6 / Destroyed` (90-100) ⓘ Beginning September 2022 Wildfire events will only use two classifications: 0 = no damage due to fire (pre-existing damage may be present) 6 = destroyed by fire		FEMA 0 to FEMA 6
	`roof_condition`	`structural_damage_percent`		Percentage of the roof detected as containing structural damage	Percentage	0 to 100
		`missing_material_percent`		Percentage of the roof detected as containing missing material.	Percentage	0 to 100
		`tarp_percent`		Percentage of the roof detected as containing a tarp.	Percentage	0 to 100
		`debris_percent`		Percentage of the roof detected as containing debris.	Percentage	0 to 100
		`discoloration`	`detected`	Whether the network detected any discoloration on the roof.		true, false
			`percentage`	Percentage of the roof containing discoloration.	Percentage	0 to 100
			`score`	A confidence score for the detection.
	`source_image_metadata`	`HistoScore` February 2023		An estimation of the clarity of the source image. 0 = bad clarity, 1 = excellent clarity.		0 to 1

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

Parameter	Parameter Type	Data Type	Description	Example Format	Notes

Parameter	Parameter Type	Data Type	Description	Example Format	Notes
Mandatory:
`wkt`	Key Value Pair (KVP)	String	The “well-known-text” (WKT) representation of the requested point.	`wkt=POINT (-105.34184578917959 35.92483934252866)`	The point must fall within a building footprint to return property information.
`token`	Key Value Pair (KVP)	String	The token used to authenticate the request.	`token={token}`
Optional:
`format`	Key Value Pair (KVP)	String	The format of the response `json` - default - JavaScript Object Notation `xml` - Extensible Markup Language	`format=json`
`aoi`	Key Value Pair (KVP)	String	The identifier of the damage event which contains the imagery from which to derive the structure damage assessment.	`aoi=us-la-neworleans-tornado-2022`
`child_aoi`			The identifier of the specific collection flight from which to derive the damage information and building footprints.	`child_aoi=graydata-363`
`search_radius`	Key Value Pair (KVP)	Integer	The radius in meters with which to search for the nearest intersecting structures.	`search_radius=15`
`only_damages`	Key Value Pair (KVP)	String	Modifies the response to omit the pre-catastrophe objects. `false` - default - returns the full response (both pre-catastrophe and post-catastrophe) `true` - the response will not contain any of the information found within the pre-catastrophe object.	`only_damages=true`
`unit-system`	Key Value Pair (KVP)	String	Determines the unitary system in which values are returned. `metric` - default - metric units (meters and sqmeters) `imperial` - imperial units (feet and square feet)	`unit-system=imperial`

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:

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:

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

Vexcel API Documentation

GetPropertyDamage - v1.4