Property measurement

Property measurement

Measure properties from aerial imagery. Requires the sites:scan scope.

  1. Call CreateSite with one address and a result tier. The site starts in SITE_STATUS_ACCEPTED while the address is checked and the scan runs in the background.
  2. Poll GetSite until the status changes, or call ListSites to check many sites at once. An address that cannot be used ends in SITE_STATUS_ISSUE.
  3. Call GetSite for 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.

TierThe result includes
RESULT_TIER_IMAGEThe measurement map as an inline base64 image in image.data.
RESULT_TIER_IMAGE_AND_SEGMENTSThe map, plus every surface with its area, perimeter, polygon count and geometry, and the parcel boundary.
RESULT_TIER_IMAGE_SEGMENTS_AND_SHARE_LINKAll 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.

aiModelMeasures 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_RESIDENTIALAidan Residential: semantic segmentation for residential properties.
AI_MODEL_COMMERCIAL_FASTAidan Commercial - Fast: instance segmentation, optimized for speed and smaller properties.
AI_MODEL_COMMERCIAL_MAKROSAidan Commercial - Makros (beta): instance segmentation, optimized for accuracy. Slower.
propertyBoundaryLimits the scan to
PROPERTY_BOUNDARY_OFFICIAL (default)The official county property boundary.
PROPERTY_BOUNDARY_ESTIMATEDThe 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