Property measurement
Measure properties from aerial imagery. Requires the sites:scan scope.
- Call
CreateSitewith one address and a resulttier. The site starts inSITE_STATUS_ACCEPTEDwhile the address is checked and the scan runs in the background. - Poll
GetSiteuntil the status changes, or callListSitesto check many sites at once. An address that cannot be used ends inSITE_STATUS_ISSUE. - Call
GetSitefor the result. The tier decides what it includes.
Polling for changes. Every site has updatedAt and revision. They change on a scan
result, a status change, a tier change, and a correction made in the Duranta app. To read
only what changed, call ListSites with updatedSince set to the last updatedAt you
saw and orderBy set to SITE_ORDER_UPDATED_ASC. Page with nextPageToken, and save
the updatedAt of the last site you processed for the next poll. Set updatedSince a
minute earlier than that: a change can become visible slightly after its updatedAt. Skip
sites whose revision you already have.
| Tier | The result includes |
|---|---|
RESULT_TIER_IMAGE | The measurement map as an inline base64 image in image.data. |
RESULT_TIER_IMAGE_AND_SEGMENTS | The map, plus every surface with its area, perimeter, polygon count and geometry, and the parcel boundary. |
RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINK | All of the above, plus shareUrl: a read-only map link that opens without a Duranta login. |
Tiers will be priced differently. A workspace can request the tiers Duranta has
enabled for it; a higher tier is refused with permission_denied.
CreateSite also takes two optional settings, the same as "AI model" and "Property
boundary" in the Duranta app. They are fixed when the site is created. Resubmitting an
existing externalId without them keeps the site's settings; with a different value it
fails with already_exists, so use a new externalId to scan with other settings.
aiModel | Measures with |
|---|---|
AI_MODEL_AUTO (default) | Aidan classifies the property as residential or commercial, then runs Residential for residential properties. Commercial properties run Commercial - Fast below 5 acres and Commercial - Makros above 5 acres. |
AI_MODEL_RESIDENTIAL | Aidan Residential: semantic segmentation for residential properties. |
AI_MODEL_COMMERCIAL_FAST | Aidan Commercial - Fast: instance segmentation, optimized for speed and smaller properties. |
AI_MODEL_COMMERCIAL_MAKROS | Aidan Commercial - Makros (beta): instance segmentation, optimized for accuracy. Slower. |
propertyBoundary | Limits the scan to |
|---|---|
PROPERTY_BOUNDARY_OFFICIAL (default) | The official county property boundary. |
PROPERTY_BOUNDARY_ESTIMATED | The service area Duranta estimates from the imagery. |
Custom boundary. For a site that is not one parcel, such as an office park or an HOA,
send boundary: a GeoJSON Polygon or MultiPolygon with [longitude, latitude]
coordinates. Duranta measures exactly that area, up to 2 square kilometers, instead of
the parcel it looks up for the address. It is fixed when the site is created, like the
settings above, and cannot be combined with PROPERTY_BOUNDARY_ESTIMATED. The result
returns it as boundary and parcelAreaSqFt.
Endpoints
Submit one property for measurement. Duranta looks the address up with several services and measures the parcel most of them place it on. When they disagree with no majority, the site gets PARCEL_AMBIGUOUS and is not measured or charged: choose the parcel with FindParcels and CreateParcelSite, see [Choosing the parcel](/parcels/).
Get one site by your externalId.
List sites, for example every site with an issue.
List the parcels an address may be on, most likely first, so you can choose the one to measure: use it after a site ends with PARCEL_AMBIGUOUS, or before CreateParcelSite to confirm the parcel up front. Measures nothing and creates no site. Returns a point inside each parcel and its area, not its boundary. See [Choosing the parcel](/parcels/).
Measure exactly the parcel you choose from FindParcels, instead of the one Duranta picks from the address. Pass the externalId of a site that ended with PARCEL_AMBIGUOUS to measure it on this parcel. Otherwise works like CreateSite; read the result with GetSite or ListSites. See [Choosing the parcel](/parcels/).