Request structure
Defensible Space can be requested as a new supplementary data source. The defensibleSpace supplementary data source can be requested along with other supplementary data sources such as roofConditionConfidenceStats.
As Defensible Space information is attached to a footprint feature class, such as Roof or Building Lifecycle, any pack that returns any of the footprint features needs to be supplied via the packs parameter (i.e. roof_char). Alternatively, the classes parameter can also be used to supply the Roof and/or Building Lifecycle feature class IDs instead.
Defensible Space is only available for Gen 6 AI resources, so when making date-based feature requests, you will need to use systemVersionPrefix=gen6.
As clipped/unclipped feature geometry is closely linked to the parcelMode request parameter, parcelMode=true must be supplied when wanting to generate Defensible Space for clipped building footprints. For example, when requesting Defensible Space for a single property in row houses.
Example Request using defensibleSpace
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=defensibleSpace&since=2024-06-03&until=2024-06-03&systemVersionPrefix=gen6&parcelMode=true&apikey=$APIKEY"
Response structure
- For features that will have defensible space supplementary data (i.e. Roof and Building Lifecycle class), a new field called
defensibleSpace has been added. - Defensible space data is only included for Roof features. If the roof has significant damage detected, Defensible Space will be associated with the Building Lifecycle feature instead.
- The
defensibleSpace field contains the zone definitions and each zone will contain the coverage information of the risk objects. A breakdown of each risk object coverage as well as its aggregate geometry clipped to the zone can be found under a field called riskObjects. - Another top level field called
aggregate has been added. This field contains a child field called defensibleSpace, which is the Defensible Space information for the whole parcel. This is calculated from the union of all Roof, or Building Lifecycle, Defensible Spaces. It follows the same schema as the footprint Defensible Space.
Sample response (excerpt)
