Roof Measurement API - Area, Pitch, Condition, Hail Risk

Measure and assess any US property from aerial imagery: roof area and roofing squares, pitch, eave height, material, shape, facet count and estimated age, a five point roof condition rating with the specific defects behind it, and wildfire and hail vulnerability scores - every reading with the model confidence that qualifies it.

What this actor does

• Roof measurements without climbing on the roof. Three dimensional roof area in square feet and in roofing squares, predominant pitch expressed over 12, eave height measured in four cardinal directions, footprint, facet count and roof shape. This is the estimate that goes into a restoration bid before anyone sets a ladder against the wall.
• A roof condition rating you can argue with. The headline rating runs compromised, poor, fair, good, excellent - and every sub-element behind it comes back as its own column: ponding, patching, tarps, rust, structural damage, missing or peeling material, streaking, natural discoloration, material degradation and loose organic matter. A "poor" with rust and a "poor" with ponding are different repairs, and this tells them apart.
• Estimated roof age. Years, from aerial history and property records, for underwriting and replacement planning.
• Wildfire and hail vulnerability scores with their reasons. Numeric ratings for both hazards, the post-mitigation wildfire rating, hail loss severity, and the structure counts, densities and vegetation coverage in the two concentric zones around the building - 0 to 30 feet and 30 to 250 feet - that drive defensible space decisions.
• Property features an underwriter asks about. Pool presence, count, condition, type, occlusion, slide, diving board and enclosure; trampolines; fences and whether the fence material is combustible; lot and yard debris area and coverage; driveway and lawn condition; HVAC unit counts; parking lot paved area with deterioration and illumination.
• One row per structure, not one per property. A house, a detached garage and a shed are three buildings with three roofs in three conditions. They arrive as three rows, joined by the address you asked for, instead of being averaged into one number that describes none of them.
• Screen a list cheaply before you analyse it. Property summary mode reads the headline roof condition, primary material and solar panel presence for twenty addresses in a single call, so a portfolio can be triaged before spending on full analyses.
• The imagery behind the answer. Rank the aerial captures over a point - top down and all four angled views - with capture dates, ground sample distance, zoom range and whether the image is a composite stitched from several frames. Search stitched orthomosaic imagery over an area by spectrum, positioning quality and capture window.
• Pay per result. You are charged for rows carrying a real record. Addresses the provider cannot geocode and locations with no capture are free.

Bring your own key

This actor calls the provider with your own application credentials, issued in the provider's developer portal. Access is an OAuth2 client credentials grant, so there are two values rather than one: a client ID and a client secret. Paste both into the input, or set the secret as the DATA_API_KEY secret. Nothing runs on anyone else's credentials, and a run without them ends cleanly with an explanation rather than failing.

The actor mints a bearer token, caches it for 55 minutes of its one hour life, and re-mints it once if a long run outlives it. A pasted Bearer or Basic prefix is stripped, so copying the whole header line instead of the value still works.

Try it free in the sandbox first

The provider runs a free sandbox that mirrors production behaviour over about 1.5 square miles of Omaha, Nebraska. Turn on Use the free sandbox and query an address inside that area - for example 4220 Barker Ave, Omaha, NE 68105 - to confirm your credentials and see the shape of the output before spending anything.

Outside that box the sandbox returns nothing. That is a correct answer to a question nobody meant to ask, so this actor says so on the row rather than reporting it as a provider failure, and it refuses an out-of-box coordinate before spending the call at all.

Every number arrives with a confidence

Nothing this provider returns is a bare value. A roof area is {value, unit, confidence}; so is a condition rating, a hazard score and a pool detection. A shaper that reads only the value silently turns a hedged computer vision reading into an apparent fact.

So each reading is written as its own columns - the value, its unit, and the model confidence - and the confidence sits beside the number it qualifies. When the model supplies reasons, as it does for the wildfire and hail ratings, those travel too. On a vision-derived measurement the confidence is half the answer.

Data packs are licensed one at a time

The provider sells its data in packs - roof area, pitch and eave height, material and condition, roof age, property condition, risk scores, building outlines, ortho imagery, oblique imagery - and your application is entitled to the ones you bought.

Two things follow. Leaving Data packs empty returns whatever your application already holds, which is usually what you want. And naming a pack you do not hold gets the whole request rejected rather than trimmed to what you do hold, so the actor reports that case as an entitlement problem naming the packs it asked for, instead of as a generic forbidden error.

Example output

{
  "recordType": "structure",
  "requested": "4220 Barker Ave, Omaha, NE 68105",
  "requestedKind": "address",
  "found": true,
  "structureIndex": 1,
  "structureLatitude": 41.25042,
  "structureLongitude": -95.97661,
  "roofArea": 2184.6,
  "roofAreaUnit": "sqft",
  "roofAreaConfidence": 0.93,
  "roofSquares": 22,
  "roofPredominantPitch": 6,
  "roofShape": "gable",
  "roofMaterialPrimary": "shingle",
  "roofMaterialPrimaryConfidence": 0.88,
  "roofConditionRating": "fair",
  "roofConditionRatingConfidence": 0.81,
  "roofAge": 14,
  "roofPonding": "no",
  "roofPatching": "yes",
  "roofStreaking": "roof_streaking_minor",
  "roofFacetCount": 8,
  "eaveHeight": "{\"north\":10.2,\"east\":10.4,\"south\":10.1,\"west\":10.3}",
  "eaveHeightUnit": "ft",
  "treeOverhang": "tree_overhang_minor",
  "structureHailRating": 6.2,
  "structureWildfireRating": 3.1,
  "structureWildfireRatingReasons": "vegetation within 30 ft; combustible fence",
  "structureCountZone1": 1,
  "structureCountZone2": 14
}

FAQ

What does this Roof Measurement API return?

Roof measurements and condition for a US property, derived from aerial imagery: three dimensional roof area in square feet and roofing squares, predominant pitch over 12, eave height by cardinal direction, roof shape, facet count, primary material and full material list, estimated roof age in years, and a five point condition rating backed by per-defect findings for ponding, patching, tarps, rust, structural damage, missing material, streaking, discoloration and material degradation. It also returns property-level features and wildfire and hail vulnerability scores.

How accurate are the measurements, and how do I tell?

Every measurement and classifier carries a model confidence between 0 and 1 in its own column beside the value, so a reading you can rely on is distinguishable from one the model hedged. Measurements are computer-vision estimates from aerial imagery rather than survey-grade figures, and the ground sample distance of the underlying imagery is available through the imagery modes. For the wildfire and hail ratings the model also returns the ranked reasons behind the score.

Do I need my own account with the data provider?

Yes. This is a bring-your-own-key actor: it calls the API with your own application's client ID and client secret from the provider's developer portal, and never with anyone else's. The provider also offers a free sandbox covering about 1.5 square miles of Omaha, Nebraska, which is the fastest way to confirm a credential works before spending anything.

What is the difference between property data and property summary mode?

Property data analyses one property in full and returns a property row, a row for each structure on it, and optionally a row for each aerial image behind it. Property summary screens up to twenty addresses in a single call and returns only the headline roof condition rating, primary roof material and solar panel presence for each. Summary is the cheap triage pass over a portfolio; property data is the detailed look at the addresses that pass it.

Why does a property produce several rows?

Because a property is usually several buildings. A house, a garage and a shed have three separate roofs that can be in three different conditions, and averaging them produces a number that describes none of them. Each structure gets its own row, keyed to the address you requested and numbered, alongside one property-level row for the things that belong to the lot rather than to a building.

How long does a request take?

Analysis is asynchronous. The actor submits the request, receives a job identifier and polls until the job finishes, which the provider signals by answering with the result rather than with an in-progress status. Typical properties complete in seconds; the actor polls for up to six minutes before treating the job as failed rather than as empty.

Can I get the aerial images themselves?

The actor returns image metadata and a ready download link per image - the reference, the token, whether the view is top down or angled, the cardinal direction, the capture date and the bounding box. The image bytes are not written into the dataset, because a spreadsheet full of encoded pictures is unusable; follow the link with the same credentials to fetch the file.

Which US areas are covered?

Coverage follows the provider's aerial imagery library, which is national but not uniform: capture dates and ground sample distance vary by location. Imagery capture mode answers that question directly for any point, listing every capture over it with its date and resolution, so you can check coverage before ordering analysis.

Keyword map

roof measurement API, roof report API, roof area API, roofing squares, roof pitch API, roof condition API, roof age API, roof material detection, aerial imagery API, property condition API, property data API, property intelligence API, insurance underwriting data, wildfire risk score API, hail damage risk API, defensible space data, pool detection API, trampoline detection, solar panel detection API, orthomosaic imagery API, oblique aerial imagery, geospatial property data, roof inspection data, restoration estimating data, property risk API