Datadory notebook
Soil survey data for construction: the ground's own screening record, delivered
Datadory delivers soil survey data for construction covering the USDA Natural Resources Conservation Service's authoritative SSURGO database - roughly 100,000+ soil map unit polygons spanning more than 95% of US counties, each keyed by mukey, muname and musym with component-level and horizon-level attributes underneath and engineering suitability ratings on top: dwellings with basements, septic tank absorption fields, local roads. Beside the seismic event catalog that completes a pre-design screen. Delivered daily, weekly, or hourly as an API, files, or your warehouse.
1,744 datasets. Pick your catch.
What counts as soil survey data for construction?
Three layers stacked inside one record, and each answers a different question about the same polygon.
The map unit layer is where everyone starts. One polygon per mapping area, keyed three ways: mukey is the unique key that joins everything else, muname is the human-readable name that encodes the slope range outright, and musym matches what a printed soil map shows.
The attribute stack beneath it is where the geotechnical detail lives: component-level shares and properties, then horizon-level attributes - the profile of each soil within the unit.
The interpretation layer on top turns all of it into engineering verdicts: suitability ratings for dwellings with basements, septic tank absorption fields and roads, resolved against a defined area of interest rather than eyeballed off a legend.
Datadory delivers all three from Web Soil Survey (WSS), USDA NRCS's authoritative soil survey record covering more than 95% of US counties. Inside our twenty-eight-record construction & engineering slice it scores 8 out of 10, and it is the only record that describes the ground itself - every other dataset in the slice measures something humans did to it.
Which fields ride on a soil map unit?
Two real map units from the SSURGO database, exactly as they land in a delivery:
mukey: 49456
muname: Sarkar-McGilvery complex, 75 to 120 percent slopes
musym: 10F
mukey: 49457
muname: Kupreanof-Tolstoi association, 5 to 35 percent slopes
musym: 11BOne row per map unit polygon, and the two names above do real work before you open a single property column. "75 to 120 percent slopes" flags terrain you would not grade a building pad onto; "5 to 35 percent slopes" reads like ordinary hillside development. The name is a first-pass screen you get for nothing.
| Field | Reads as |
|---|---|
mukey | Unique map unit key - the join column for every attribute beneath the polygon |
muname | Association or complex name with its slope range encoded inline |
musym | Symbol printed on the soil map itself |
MapunitPoly | Polygon geometry for soil map unit boundaries |
SurveyAreaPoly | Polygon geometry for soil survey area boundaries |
| Suitability/rating interpretations | Engineering and land-use ratings per area of interest: dwellings with basements, septic tank absorption fields, roads |
| Component & horizon attributes | Shares and properties per soil component, then per horizon - the full geotechnical stack, folded out with your sample |
The complete dictionary ships with your sample, including the alternative area-of-interest keys - coordinates, a list of map unit keys, a soil survey area or an existing WSS area-of-interest id.
What does coverage look like across geography, time and grain?
Geography is the headline. Soil maps span more than 95% of US counties plus US territories - roughly 100,000+ map unit polygons nationwide under one taxonomy. That single fact changes what a land team can attempt: a forty-parcel pipeline across four states resolves against one legend instead of four.
Granularity stacks three depths - polygon, component, horizon - along one join path. You walk from a parcel's map unit down to the soils that make up its share and their horizon properties without leaving the schema. Request ceilings run at 100,000 tabular rows or 250,000 spatial features, which is why long corridors arrive tiled into areas of interest rather than truncated mid-pull.
How does a site screen actually run?
Five decisions separate a defensible screen from a casual lookup:
Name the geography and the asset type in a sample request and rows scoped to your parcels go out the same day.
Which records complete a site screen besides soils?
A soil screen rarely stops at dirt, and three sibling records finish the picture inside the same industry slice.
Loads. USGS Earthquake Hazards API (FDSN) holds millions of worldwide event records reaching into the early 1900s for larger magnitudes, twenty-five documented fields apiece: origin time, epicenter, hypocenter depth, magnitude with its scale, quantified uncertainty, review status and PAGER alert level. Scored 9 out of 10, the highest in the construction & engineering slice.
Together the four records cover ground, loads, approvals and money - the four questions any site decision quietly asks.
How do the records compare side by side?
Four records, four different questions - and choosing among them decides what your screen can claim:
| Record | What it measures | Coverage & history | Grain |
|---|---|---|---|
| Web Soil Survey (WSS) | Ground condition: SSURGO map units with engineering suitability ratings | More than 95% of US counties, continuously maintained | One polygon per map unit, component and horizon tables beneath |
| Chicago Building Permits | Built activity and approval friction in Chicago | Permits issued January 3, 2006 to the present | One row per permit, 122 fields |
| NYC DOB Job Application Filings | Built activity and approval friction in New York | Job applications from January 1, 2000 forward | One row per application document, 95 fields |
Where does soil survey data stop short of an engineering answer?
Four limits belong in any methodology note, and all four favor teams that know them in advance.
A map unit is not a measurement at your footing line. It describes an association of soils across a polygon, and component shares vary inside it. Treat a favourable dwelling-with-basements rating as a screening signal that still needs borings and lab work to confirm - the granularity statement stops deliberately short of geotechnical truth.
Revisions are silent. Map units change where NRCS re-maps them, nothing announces it, and there is no release calendar to subscribe to. Snapshot discipline wins: capture retrieval dates with every extract and re-pull when revisions matter to the analysis.
Ratings are use-specific, not transferable. A septic tank absorption field verdict says nothing about subgrade, and a roads rating does not clear a basement. Match each requested interpretation to the decision it feeds instead of pulling one rating and generalizing.
Ceilings are real. Requests cap at 100,000 tabular rows or 250,000 spatial features, so corridors get tiled into areas of interest rather than discovered limits mid-pull. The same chunking discipline the seismic side imposes at its own request bounds.
Who builds on soil survey data?
Five personas get outsized value, and each works a different corner of the record.
Civil and geotechnical engineers use it the way nobody else can: as the first screen that decides whether a parcel deserves a drilling budget at all. Developers and data-product builders slot soil layers straight into property dashboards and due-diligence tools - the highest relevance fit in our catalog's construction slice. Data scientists and ML engineers train land-use and geotechnical models on a nationally consistent, mukey-keyed feature table with verified field definitions. Market researchers and consultants fold buildability context into feasibility reports without hand-tracing scanned soil maps. Journalists, academics and students report and teach from the authoritative national soil record itself.
Persona-by-persona workflow breakdowns live on developers builders use cases for construction engineering and data scientists use cases for construction engineering.
Why get soil survey data through Datadory?
Because the hard part was never knowing SSURGO exists - it is keeping a polygon-plus-component-plus-horizon estate usable once it leaves the government app. Ratings arrive resolved to your area of interest instead of hand-read off legends; mukey joins hold steady between refreshes so a model trained this quarter still runs next quarter; and every extract ships with its retrieval date stamped, because a continuously revised database will not look identical next quarter.
Start with a sample: name the parcels, corridor or counties, and rows shaped exactly like the field dictionary go out sized to test in your own pipeline the same week.
Where to go next
Start with the construction engineering data hub, which indexes all twenty-eight records in the slice and shows where a ground-condition screen sits among them. Then go to the products themselves: Web Soil Survey (WSS) for the soil core and USGS Earthquake Hazards API (FDSN) for the loading history of the planet. The best construction & engineering datasets ranking scores the leaders side by side, the demand-side counterpart to a site screen is tracked monthly back to January 1990 in our Europe construction output index walkthrough, and the construction engineering data guide maps the wider pool - output statistics, permit records, safety enforcement and macro indicators.
Pick up where this leaves off
Every one of these ships with sample rows before you commit to anything.
Web Soil Survey (WSS)
USGS Earthquake Hazards API (FDSN)
Chicago Building Permits
NYC DOB Job Application Filings
Want rows instead of a pitch? Name the datasets.
API, files, or your warehouse. Daily, weekly, or hourly.
Get a sampleQuestions worth asking
What is soil survey data used for in construction?
Screening ground before money moves. Map unit names triage slope, engineering interpretation ratings score foundation, wastewater and road suitability, and component-level attributes feed models - all before a drilling budget exists. Datadory delivers the ratings resolved to your area of interest rather than read off a printed map.
How much of the United States does the soil survey cover?
Soil maps cover more than 95% of US counties plus the territories - roughly 100,000+ map unit polygons under one national SSURGO taxonomy. Because every county shares the same legend, a multi-state land pipeline stays comparable without reconciling fifty different state schemes.
Can I identify a buildable parcel from the map unit name alone?
Partially. The name encodes the slope range directly: Sarkar-McGilvery complex, 75 to 120 percent slopes flags terrain you would not grade a pad onto, while Kupreanof-Tolstoi association, 5 to 35 percent slopes reads like ordinary hillside development. Everything deeper than slope needs the mukey and its joined attributes.
Is a soil map unit rating a substitute for a geotechnical investigation?
No, and it does not claim to be. A map unit describes an association of soils across a polygon; component shares vary inside it, so even a favourable dwelling-with-basements rating is a screening signal. Use it to decide which parcels deserve borings, then let borings confirm what the screen suggested.
Why pair soil survey data with earthquake records?
Because a pre-design screen asks two different questions about one footprint: what the ground is made of, and what has shaken it. The USGS event catalog supplies loads - time, location, depth, magnitude, alert level - while SSURGO map units supply ground condition, both cut to the same area of interest.