FEMA USA Structures
GeoUSservices2.arcgis.com
Building-level footprints for structures across the United States and its territories, produced by Oak Ridge National Laboratory for FEMA, with occupancy class, primary use, address, height, floor area, elevation, county and census tract codes and a modelled building population estimate.
Capabilities (15)
GET /v1/data/usastructures/count1 creditReturns a single JSON object with the number of buildings matching a SQL where clause, with no rows.
GET /v1/data/usastructures/count-in-bbox1 creditReturns a single JSON object with the number of buildings intersecting a WGS84 bounding box.
GET /v1/data/usastructures/distinct-values1 creditReturns the distinct values present in one or more fields across the buildings matching a where clause.
GET /v1/data/usastructures/extent1 creditReturns only the WGS84 extent (xmin, ymin, xmax, ymax), covering every building matching a where clause.
GET /v1/data/usastructures/footprints-in-bbox1 creditReturns a GeoJSON FeatureCollection of building outline polygons intersecting a WGS84 bounding box, each carrying the full attribute set.
GET /v1/data/usastructures/footprints-near-point1 creditReturns a GeoJSON FeatureCollection of building outline polygons within a radius in metres of a longitude/latitude, each carrying the full attribute set.
GET /v1/data/usastructures/in-bbox1 creditReturns every building intersecting a WGS84 bounding box, with all attributes and no geometry.
GET /v1/data/usastructures/layer-metadata1 creditReturns the structures layer definition: all 36 field names with their types, aliases and official FEMA field descriptions, plus the layer extent and drawing info.
GET /v1/data/usastructures/near-point1 creditReturns every building whose footprint falls within a given radius in metres of a longitude/latitude, with all attributes and no geometry.
GET /v1/data/usastructures/object-ids1 creditReturns just the OBJECTID list for the buildings matching a where clause, with no attributes and no geometry.
GET /v1/data/usastructures/search1 creditRuns a SQL where clause against the structures table and returns matching buildings with all attributes and no geometry.
GET /v1/data/usastructures/service-metadata1 creditReturns the feature service descriptor: layer list, maxRecordCount, full extent, spatial reference and the query capabilities the service supports.
GET /v1/data/usastructures/statistics1 creditRuns server-side aggregates (count, sum, min, max, avg, stddev, percentile) over the buildings matching a where clause, optionally grouped by one or more fields.
GET /v1/data/usastructures/structure1 creditReturns the single building record with the given GlobalID, including its UUID, address, occupancy, height, floor area, elevation range and population estimate.
GET /v1/data/usastructures/top-features1 creditReturns the top N buildings within each group (for example the tallest building in every county) using the service's queryTopFeatures operation.
Response example
The shape of data from usastructures/count (Count structures matching a filter). A sample, not live data.
{
"count": 367168
}Ask with this source
A prompt for your agent that names this source and how to call it through the crw MCP.
Count structures matching a filter
Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Count structures matching a filter" (count). You only need how many buildings match - a state, county, ZIP or occupancy type - and not the records themselves. Example options: where=PROP_ST='Rhode Island'. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "count". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Count structures in a bounding box
Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Count structures in a bounding box" (count-in-bbox). You want building density or a feasibility check for a map area before pulling the records, which may exceed the 2000-row page. Example options: xmin=-105.2805, ymin=40.0100, xmax=-105.2700. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "count-in-bbox". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Distinct values of a field
Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Distinct values of a field" (distinct-values). You need the real vocabulary of a field - which occupancy types, counties or building codes actually occur - before writing a filter. Example options: where=STATE_FIPS='44', outFields=PRIM_OCC, orderByFields=PRIM_OCC. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "distinct-values". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Bounding box of a result set
Use FEMA USA Structures (usastructures) from fastCRW Pergamon, capability "Bounding box of a result set" (extent). You want to know where a set of buildings sits, or to fit a map to it, without downloading any features. Example options: where=FIPS='44003'. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "usastructures" and capability "extent". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Licence
Item licence statement on the authoritative "USA Structures" layer (ArcGIS item 0ec8512ad21e4bb987d7e848d14e7e24), verbatim: "This work is licensed under a Creative Commons by Attribution (CC BY 4.0) license. See Credits and Map for Attribution." with links headed "View License Deed" (https://creativecommons.org/licenses/by/4.0) and "View Legal Code" (https://creativecommons.org/licenses/by/4.0/legalcode). The same item's credits field reads: "Oak Ridge National Laboratory (ORNL); Federal Emergency Management Agency (FEMA) Geospatial Response Office". CC BY 4.0 grants, in its own words, the right to "copy and redistribute the material in any medium or format" and to "remix, transform, and build upon the material for any purpose, even commercially", provided attribution is given.
https://creativecommons.org/licenses/by/4.0/Attribution
Display this wherever you show the data. It arrives on every response as provenance.attribution_text.
USA Structures - Oak Ridge National Laboratory (ORNL) and FEMA Geospatial Response Office, hosted by Esri U.S. Federal Datasets, CC BY 4.0
Cache: up to 3600s
