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 damage assessment information on an individual structure basis. Unlike GetPropertyInformation this service will not provide any information about a parcel or attributes that are parcel derived; all information pertains to the structure only. Damage Assessments are precomputed for graysky collections worldwide 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.

While this service is being finalized, not all 2022+ AOIs will be available, we will publish more AOIs as soon as possible.

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
Mandatory:
`wkt`	Key Value Pair (KVP)	String	The “well-known-text” (WKT) representation of the requested point.	`wkt=POINT (-105.34184578917959 35.92483934252866)`
`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

Andover, Kansas Tornado- Demonstrating aoi

https://api.gic.org/damage/GetPropertyDamage?wkt=POINT(-97.128712 37.672876)&aoi=us-ks-andover-tornado-2022&token={token}

Sample Response (Damage Assessment Information only):

.
.
.
"damage_assessments": {
                    "roof_condition": {
                        "structural_damage_percent": 4.62,
                        "missing_material_percent": 39.35,
                        "tarp_percent": 0.0,
                        "debris_percent": 0.0,
                        "discoloration": {
                            "detected": null,
                            "percentage": 1.73,
                            "score": null
                        }
                    },
                    "fema_classification": "FEMA 4 / Major",
                    "catastrophe_score": 48.59
                }
.
.
.

Companion Graysky Image:

https://api.gic.org/images/ExtractImages/graysky?mode=one&EPSG=4326&zoom=0&xcoordinate=-97.128712&ycoordinate=37.672876&orientation=Nadir&nadirRotatedNorth=yes&aoi=us-ks-andover-tornado-2022&width=600&height=400

________________________________________________________________________________________

Andover, Kansas Tornado- Demonstrating format and search_radius

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

Sample Response (Damage Assessment Information only):

.
.
.
            <damage_assessments>
                <fema_classification>FEMA 4 / Major</fema_classification>
                <catastrophe_score>7.3</catastrophe_score>
                <roof_condition>
                    <tarp_percent>0.0</tarp_percent>
                    <discoloration>
                        <score>null</score>
                        <percentage>31.34</percentage>
                        <detected>null</detected>
                    </discoloration>
                    <debris_percent>0.0</debris_percent>
                    <missing_material_percent>3.88</missing_material_percent>
                    <structural_damage_percent>1.71</structural_damage_percent>
                </roof_condition>
            </damage_assessments>
.
.
.

Companion Graysky Image:

https://api.gic.org/images/ExtractImages/graysky?mode=one&EPSG=4326&zoom=0&xcoordinate=-97.123556&ycoordinate=37.678619&orientation=Nadir&nadirRotatedNorth=yes&aoi=us-ks-andover-tornado-2022&width=2400&height=1600

Vexcel API Documentation

GetPropertyDamage - v1.4