> ## Documentation Index > Fetch the complete documentation index at: https://docs.mireye.ai/llms.txt > Use this file to discover all available pages before exploring further. # Field catalog > Full reference of every field exposed by /v1/fetch and /v1/ask. The catalog is the source of truth for every field name, unit, source, and preset assignment. The live, machine-readable version is at [`GET /v1/meta/fields`](/api-reference/meta-fields); this page renders the same data for human browsing. Schema version: **0.14.0** — **296 fields** across 7 layers. ## How to read this table * **Name** — the catalog field name you pass to `/v1/fetch`. * **Layer** — one of `terrain`, `land_cover`, `built_environment`, `utilities`, `parcels`. Mireye fetches each layer in parallel; fields in the same layer share a fetch round-trip. * **Type** — JSON type returned in the `value` field (`float`, `int`, `bool`, `string`). * **Unit** — SI unit, or `—` for enums / booleans / strings. * **Source** — canonical short name of the federal source. * **Description** — what the value represents. * **Presets** — which preset bundles include this field. ## All fields | Name | Layer | Type | Unit | Source | Description | Presets | | ----------------------------------------------------- | ------------------ | ------ | --------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `elevation` | terrain | float | meters | USGS\_3DEP | Ground elevation above the NAVD88 vertical datum at the queried point. Sourced from the USGS 3DEP 1/3 arc-second seamless DEM (\~10m), with the USGS EPQS dynamic service as a coverage fallback. | terrain, flood\_risk, wildfire\_underwrite, site\_selection, wind\_siting | | `slope_degrees` | terrain | float | degrees | USGS\_3DEP | Surface slope in degrees, computed from the USGS 3DEP DEM at the queried point. 0 = flat; 90 = vertical. | terrain, wildfire\_underwrite, site\_selection, solar\_siting, wind\_siting, storage\_siting, data\_center\_siting, natural\_hazard | | `aspect_degrees` | terrain | float | degrees | USGS\_3DEP | Slope aspect (compass bearing the slope faces) in degrees, 0=N, 90=E, 180=S, 270=W. | solar\_siting | | `aspect_cardinal` | terrain | string | — | USGS\_3DEP | Slope aspect as a cardinal direction (N, NE, E, ..., NW) — the compass direction the slope faces. | terrain, solar\_siting | | `coast_distance_m` | terrain | float | meters | NOAA\_CUSP | Geodesic distance from the queried point to the nearest NOAA CUSP shoreline vertex. Always populated; very large (>200km) for inland points. | terrain, flood\_risk | | `soil_drainage_class` | terrain | string | — | USDA\_SSURGO | USDA SSURGO soil drainage class at the queried point (e.g. 'Well drained', 'Poorly drained', 'Excessively drained'). | terrain | | `soil_map_unit_name` | terrain | string | — | USDA\_SSURGO | USDA SSURGO soil map-unit name at the queried point. | — | | `bedrock_depth_cm` | terrain | float | centimeters | USDA\_STATSGO | Depth to bedrock in centimeters from USDA STATSGO. Censored at the dataset's measurement ceiling for deep-bedrock locations. | terrain, wind\_siting | | `intersects_nhd_area` | terrain | bool | — | USGS\_NHDPLUS\_HR | True if the queried point intersects a USGS NHDPlus HR NHDArea hydrographic polygon, such as a stream/river area, canal/ditch, inundation area, wash, levee, or other areal hydrographic landmark. | flood\_risk | | `nearest_flowline_name` | terrain | string | — | USGS\_NHDPLUS\_HR | Name of the nearest USGS NHDPlus stream / river flowline. | — | | `nearest_waterbody_name` | terrain | string | — | USGS\_NHDPLUS\_HR | Name of the nearest USGS NHDPlus waterbody (lake, reservoir, pond). | flood\_risk | | `huc_12_name` | terrain | string | — | USGS\_WBD | Name of the USGS HUC-12 watershed containing the queried point. | — | | `within_floodplain_polygon` | terrain | bool | — | FEMA\_NFHL | True if the queried point falls inside a FEMA National Flood Hazard Layer Special Flood Hazard Area polygon. | flood\_risk, site\_selection, data\_center\_siting, natural\_hazard | | `intersects_wetland` | terrain | bool | — | USFWS\_NWI | True if the queried point falls inside a USFWS National Wetlands Inventory polygon (a biological wetland definition). | flood\_risk, site\_selection | | `wetland_type` | terrain | string | — | USFWS\_NWI | Decoded Cowardin classification of the wetland at (or nearest to) the point, in plain English (e.g. 'Palustrine Emergent Persistent Temporarily Flooded'). Falls back to the coarse NWI WETLAND\_TYPE 8-bucket (e.g. 'Freshwater Forested/Shrub Wetland') when a code cannot be decoded. | flood\_risk, site\_selection | | `wetland_subtype` | terrain | string | — | USFWS\_NWI | Raw Cowardin classification code from NWI ATTRIBUTE (e.g. 'PFO1A' = Palustrine / Forested / Broad-Leaved Deciduous / Temporarily Flooded). | flood\_risk | | `wetland_acres` | terrain | float | acre | USFWS\_NWI | Total acreage of the NWI wetland polygon at (or nearest to) the point — NOT the share of any parcel. | flood\_risk | | `nearest_wetland_distance_m` | terrain | float | m | USFWS\_NWI | Geodesic meters to the nearest NWI wetland within a 500 m search; 0 if the point is on a wetland; null if none within 500 m. | flood\_risk, site\_selection | | `wetlands_within_100m_count` | terrain | int | — | USFWS\_NWI | Count of NWI wetland polygons within 100 m of the point. | flood\_risk, site\_selection | | `wetlands_within_500m_count` | terrain | int | — | USFWS\_NWI | Count of NWI wetland polygons within 500 m of the point. | flood\_risk | | `surface_water_permanence_pct` | terrain | float | percent | JRC\_GSW | JRC Global Surface Water permanence percentage at the queried 30m cell (0 = never surface water, 100 = permanent open water). | flood\_risk, data\_center\_siting | | `lcms_class` | land\_cover | string | — | USFS\_LCMS | USFS Land Change Monitoring System dominant land-cover class at the queried point, served from a bootstrapped \~120m block-mode CONUS grid (annual LCMS product). Life-form taxonomy — classes include Trees, Shrubs, Grass/Forb/Herb, cover mixes, Barren or Impervious, Water, Snow or Ice (no dedicated crop class). CONUS only. | wildfire\_underwrite, land\_cover, site\_selection | | `land_use_class` | land\_cover | string | — | USFS\_LCMS | USFS LCMS land-use class (Agriculture / Developed / Forest / Other / Rangeland or Pasture / Non-Processing Area Mask), served from a bootstrapped \~120m block-mode CONUS grid. CONUS only. | land\_cover | | `tree_canopy_pct` | land\_cover | float | percent | USFS\_NLCD\_TCC | Tree canopy cover percentage (0-100) at the point, sampled from the USFS/NLCD Tree Canopy Cover product served as a bootstrapped \~120m CONUS grid. CONUS only. | wildfire\_underwrite, land\_cover, solar\_siting | | `ndvi_current` | land\_cover | float | — | SENTINEL2\_NDVI | Most recent Sentinel-2 NDVI (Normalized Difference Vegetation Index) at the queried cell, range -1 to +1. Higher = greener / more photosynthetic activity. | wildfire\_underwrite | | `ndvi_change_5y` | land\_cover | float | — | SENTINEL2\_NDVI | 5-year change in NDVI at the queried cell. Negative values indicate vegetation loss; positive indicate growth or recovery. | wildfire\_underwrite | | `cdl_class` | land\_cover | string | — | USDA\_CDL | USDA Cropland Data Layer class name at the queried point — a crop (Corn, Soybeans, Cotton, Winter Wheat, …) OR a non-crop CDL land-cover class (Developed, Open Water, Deciduous Forest, Grassland/Pasture, …). NULL only when the point is outside the CDL CONUS grid or on a background/nodata cell. Pair with is\_cultivated to distinguish cultivated cropland from non-crop cover. | land\_cover | | `is_cultivated` | land\_cover | bool | — | USDA\_CDL | True if the queried point is on USDA-mapped cultivated cropland. | solar\_siting | | `dominant_crop_5y` | land\_cover | string | — | USDA\_CDL | Most-frequent crop classification over the last 5 CDL years at the queried point. Helps see past 1-year rotation noise. | land\_cover | | `primary_building_height_m` | built\_environment | float | meters | OVERTURE\_BUILDINGS | Height in meters of the building containing (or nearest to) the queried point, from Overture Buildings. | building\_lookup | | `primary_building_num_floors` | built\_environment | int | — | OVERTURE\_BUILDINGS | Number of floors of the primary building at/near the queried point. | building\_lookup | | `primary_building_footprint_sqm` | built\_environment | float | square\_meters | OVERTURE\_BUILDINGS | Building footprint area in square meters from Overture Buildings. | building\_lookup | | `primary_building_overture_class` | built\_environment | string | — | OVERTURE\_BUILDINGS | Overture-classified building category (residential / commercial / industrial / civic / etc.) of the primary building. | building\_lookup | | `nearest_major_road_name` | built\_environment | string | — | OVERTURE\_TRANSPORTATION | Name of the nearest major road (motorway / trunk / primary / secondary) from Overture Roads. | — | | `nearest_major_road_distance_m` | built\_environment | float | meters | OVERTURE\_TRANSPORTATION | Geodesic distance to the nearest major road in meters. | site\_selection | | `nearest_bridge_name` | built\_environment | string | — | FHWA\_NBI | Name of the nearest FHWA-NBI catalogued bridge. | — | | `nearest_power_plant_name` | utilities | string | — | EIA\_ATLAS | Name of the nearest electric power-generating facility (EIA Atlas). | utilities | | `nearest_power_plant_distance_m` | utilities | float | meters | EIA\_ATLAS | Geodesic distance in meters to the nearest EIA Atlas power plant. | utilities, storage\_siting, grid\_interconnect | | `nearest_power_plant_primary_fuel` | utilities | string | — | EIA\_ATLAS | Primary fuel of the nearest power plant (Natural Gas, Coal, Nuclear, Solar, Wind, Hydro, etc.). | utilities | | `nearest_power_plant_capacity_mw` | utilities | float | megawatts | EIA\_ATLAS | Summer (net) generating capacity in megawatts of the nearest power plant, as published by the EIA Atlas — typically \~10% below nameplate capacity. Do not treat as nameplate. | utilities, grid\_interconnect | | `nearest_transmission_line_distance_m` | utilities | float | meters | EIA\_ATLAS | Distance in meters to the nearest EIA Atlas transmission line. | site\_selection, utilities, storage\_siting, grid\_interconnect | | `nearest_transmission_line_voltage_kv` | utilities | float | kilovolts | EIA\_ATLAS | Operating voltage (kV) of the single nearest EIA/HIFLD transmission line. Null when the source publishes no numeric voltage for that segment. | site\_selection, utilities | | `nearest_transmission_line_voltage_class` | utilities | string | — | EIA\_ATLAS | Voltage-class band of the nearest line (e.g. "100-161", "345", "500") from source VOLT\_CLASS. A range, not a point value. | site\_selection, utilities | | `nearest_transmission_line_voltage_basis` | utilities | string | — | EIA\_ATLAS | How the nearest line's voltage is known: numeric, class\_band, or not\_published. | site\_selection, utilities | | `nearest_transmission_line_status` | utilities | string | — | EIA\_ATLAS | Operating status of the nearest line: "IN SERVICE", "UNDER CONSTRUCTION", "INACTIVE", or null when unpublished. | utilities | | `nearest_transmission_line_owner` | utilities | string | — | EIA\_ATLAS | Owner/operator of the nearest line (e.g. "ONCOR ELECTRIC DELIVERY CO.") from source OWNER; null when unpublished. | utilities | | `max_transmission_line_voltage_kv_within_radius` | utilities | float | kilovolts | EIA\_ATLAS | Highest NUMERIC operating voltage (kV) among all transmission lines within \~2 km (transmission\_lines\_radius\_m). Null when no in-range line publishes a numeric voltage. | site\_selection, utilities | | `max_transmission_line_voltage_class_within_radius` | utilities | string | — | EIA\_ATLAS | Highest voltage-class band among all lines within \~2 km, ranking class-band-only lines alongside numeric ones. Always >= the band implied by max\_transmission\_line\_voltage\_kv\_within\_radius. | site\_selection, utilities | | `transmission_lines_within_radius_count` | utilities | int | — | EIA\_ATLAS | Count of EIA/HIFLD transmission segments within \~2 km (transmission\_lines\_radius\_m). | site\_selection, utilities, data\_center\_siting, grid\_interconnect | | `nearest_gas_pipeline_distance_m` | utilities | float | meters | EIA\_ATLAS | Distance in meters to the nearest EIA interstate natural-gas pipeline. | utilities, data\_center\_siting | | `nearest_public_water_system_name` | utilities | string | — | EPA\_SDWIS | Name of the EPA SDWIS public water system serving the queried point. | — | | `nearest_rail_line_distance_m` | utilities | float | meters | BTS\_NTAD | Distance in meters to the nearest BTS NTAD rail line. | data\_center\_siting | | `nearest_airport_name` | utilities | string | — | FAA\_NASR | Name of the nearest FAA NASR airport. | — | | `nearest_airport_distance_m` | utilities | float | meters | FAA\_NASR | Distance in meters to the nearest FAA NASR airport. | wind\_siting | | `nearest_port_name` | utilities | string | — | BTS\_PORTS | Name of the nearest BTS Principal Port. | — | | `nearest_antenna_structure_distance_m` | utilities | float | meters | FCC\_ASR | Geodesic distance in meters to the nearest FCC-registered antenna structure within a 2 km buffer. Source is the FCC ULS Antenna Structure Registration (ASR), which only includes structures >=200 ft AGL (FAA Form 7460 threshold); small cells and sub-threshold towers are not in the federal index. | — | | `nearest_antenna_structure_height_m` | utilities | float | meters | FCC\_ASR | Overall height above ground (in meters) of the nearest FCC ASR antenna structure. Always >=60.96 m by construction. | — | | `nearest_antenna_structure_type` | utilities | string | — | FCC\_ASR | FCC structure-type code for the nearest antenna structure (e.g. BTWR = building-mounted tower, BANT = antenna on building, TOWER = freestanding tower, GTOWER = guyed tower). | — | | `nearest_antenna_structure_owner` | utilities | string | — | FCC\_ASR | FCC ASR registration number of the nearest antenna structure. Cross-reference [https://wireless2.fcc.gov/UlsApp/AsrSearch/](https://wireless2.fcc.gov/UlsApp/AsrSearch/) for the registrant entity. | — | | `antenna_structures_within_500m_count` | utilities | int | — | FCC\_ASR | Count of FCC ASR antenna structures within 500 m of the queried point. Dense urban clusters (broadcast row, downtown rooftops) typically register multiple structures inside this radius. | — | | `antenna_structures_within_2km_count` | utilities | int | — | FCC\_ASR | Count of FCC ASR antenna structures within the 2 km query buffer. Zero count means no registered tall antennas within 2 km. | — | | `political_region` | parcels | string | — | OVERTURE\_DIVISIONS | US state name from Overture Divisions at the queried point. | boundaries | | `political_county` | parcels | string | — | OVERTURE\_DIVISIONS | County name from Overture Divisions at the queried point. | boundaries | | `political_locality` | parcels | string | — | OVERTURE\_DIVISIONS | Locality / city name from Overture Divisions. | boundaries | | `tract_geoid` | parcels | string | — | US\_CENSUS\_GEOCODER | US Census tract GEOID (11 digits: STATE+COUNTY+TRACT) containing the queried point. | boundaries | | `intersects_conservation_easement` | parcels | bool | — | USGS\_PADUS | True if the queried point intersects a USGS PAD-US 4.1 conservation easement. PAD-US is the federal aggregation of conservation easements after NCED was discontinued in 2025. | site\_selection | | `easement_holder` | parcels | string | — | USGS\_PADUS | Holder organization of the intersecting conservation easement. | — | | `easement_type` | parcels | string | — | USGS\_PADUS | Type/category of the intersecting PAD-US conservation easement. | — | | `easement_purpose` | parcels | string | — | USGS\_PADUS | Stated purpose of the intersecting easement. PAD-US 4.1 publishes no stated-purpose attribute for easement records, so this is null (semantic absence) even when an easement is present. | — | | `easement_acres` | parcels | float | acres | USGS\_PADUS | GIS acreage of the intersecting PAD-US conservation easement. | — | | `easement_year_established` | parcels | int | — | USGS\_PADUS | Year the intersecting PAD-US conservation easement was established. | — | | `intersects_protected_area` | parcels | bool | — | USGS\_PADUS | True if the queried point intersects a USGS PAD-US 4.1 protected area (Fee or Designation): parks, refuges, wilderness, military, NGO preserves. | site\_selection | | `protected_area_name` | parcels | string | — | USGS\_PADUS | Name of the intersecting PAD-US protected area (most protective unit). | — | | `protected_area_gap_status` | parcels | int | — | USGS\_PADUS | GAP status (1–4) of the intersecting PAD-US protected area — the conservation-strictness axis. | site\_selection | | `protected_area_designation` | parcels | string | — | USGS\_PADUS | Designation type (Wilderness/Refuge/Park…) of the intersecting protected area. | — | | `protected_area_manager` | parcels | string | — | USGS\_PADUS | Managing entity of the intersecting PAD-US protected area. | — | | `protected_area_public_access` | parcels | string | — | USGS\_PADUS | Public-access level (Open/Restricted/Closed/Unknown) of the protected area. | — | | `intersects_critical_habitat` | parcels | bool | — | USFWS\_CRITHAB | True if the queried point intersects USFWS ESA-designated critical habitat (Final OR Proposed polygon). | site\_selection | | `critical_habitat_status` | parcels | string | — | USFWS\_CRITHAB | Designation status of the intersecting critical habitat: Final or Proposed. | site\_selection | | `critical_habitat_species` | parcels | string | — | USFWS\_CRITHAB | Listed species (common + scientific name) the critical habitat is designated for. | — | | `critical_habitat_listing_status` | parcels | string | — | USFWS\_CRITHAB | ESA listing status (Endangered/Threatened) of the critical-habitat species. | — | | `parcel_geometry_wkt` | parcels | string | — | REGRID | WKT polygon of the matched Regrid parcel (WGS84). POLYGON only — for a multi-polygon parcel use parcel\_boundary\_geojson, which keeps every part. | site\_selection | | `parcel_boundary_geojson` | parcels | string | — | REGRID | GeoJSON Polygon/MultiPolygon of the matched Regrid parcel (WGS84) as a JSON string; json.loads it. Preserves MultiPolygon parts that parcel\_geometry\_wkt truncates. | site\_selection | | `parcel_id` | parcels | string | — | REGRID | Stable Regrid identifier for the matched parcel. | site\_selection | | `parcel_apn` | parcels | string | — | REGRID | Assessor's parcel number (APN) for the matched parcel. | — | | `parcel_area_m2` | parcels | float | square\_meters | REGRID | Area of the single matched Regrid parcel in square meters, derived from Regrid's calculated acreage (ll\_gisacre) or square footage (ll\_gissqft) — Regrid's US schema has no metric area column — falling back to county-provided gisacre/sqft. | site\_selection | | `parcel_address` | parcels | string | — | REGRID | Situs/site address of the matched Regrid parcel, when present. | — | | `parcel_data_source` | parcels | string | — | REGRID | Which Regrid tier produced this parcel: regrid\_paid or regrid\_free\_tier. | — | | `parcel_owner` | parcels | string | — | REGRID | Owner of record for the exact Regrid parcel at the queried point, or for the bounded nearest parcel when an exact point lookup misses. | — | | `parcel_zoning` | parcels | string | — | REGRID | Zoning designation for the exact Regrid parcel at the queried point, or for the bounded nearest parcel when an exact point lookup misses. | site\_selection, solar\_siting, storage\_siting | | `parcel_match_type` | parcels | string | — | REGRID | How the Regrid parcel was matched: exact\_intersect for point-in-parcel matches, or nearest\_within\_radius for bounded fallback matches. | — | | `parcel_match_distance_m` | parcels | float | meters | REGRID | Distance from the query point to the selected Regrid parcel geometry; 0 for exact point-in-parcel matches. | — | | `parcel_match_radius_m` | parcels | float | meters | REGRID | Configured Regrid nearest-parcel fallback radius used for this match; 0 for exact point-in-parcel matches. | — | | `ghi_annual_kwh_m2_day` | climate | float | kWh/m2/day | NREL\_SOLAR\_RESOURCE\_V1 | Annual-average global horizontal irradiance at the point, sampled from the NREL PSM v3 multiyear (1998-2016) \~4 km solar-resource raster (local index; no API key needed). | solar\_siting | | `dni_annual_kwh_m2_day` | climate | float | kWh/m2/day | NREL\_SOLAR\_RESOURCE\_V1 | Annual-average direct normal (beam) irradiance, sampled from the NREL PSM v3 multiyear (1998-2016) \~4 km solar-resource raster (local index; no API key needed). Drives CSP and tracking-system economics. | solar\_siting | | `pv_capacity_factor_pct` | climate | float | pct | NREL\_PVWATTS\_V8 | Modeled first-year AC capacity factor for a fixed-tilt open-rack PV system, from NREL PVWatts v8 (latitude tilt, south-facing). | solar\_siting | | `pv_specific_yield_kwh_per_kw` | climate | float | kWh/kW | NREL\_PVWATTS\_V8 | Modeled annual AC energy per kW-DC installed (ac\_annual / system\_capacity) for a fixed-tilt system, from NREL PVWatts v8. | solar\_siting | | `optimal_fixed_tilt_degrees` | climate | float | degrees | NREL\_PVWATTS\_V8 | Energy-maximising fixed array tilt. Reported as the latitude rule-of-thumb (\|lat\|); exact optimum is within a few degrees (see provenance notes). | solar\_siting | | `surface_albedo_annual` | climate | float | — | NREL\_NSRDB\_GOES\_TMY\_V4 | Dimensionless 0-1 broadband ground albedo (annual mean), from the NREL NSRDB GOES TMY series. Drives bifacial PV rear-side gain. | solar\_siting | | `mean_wind_speed_100m_ms` | climate | float | m/s | NREL\_WIND\_TOOLKIT | Long-term annual-mean wind speed at 100m hub height (NREL WIND Toolkit, 2 km CONUS, 2007-2014 climatology). | wind\_siting | | `mean_wind_speed_120m_ms` | climate | float | m/s | NREL\_WIND\_TOOLKIT | Annual-mean wind speed at 120m (current-generation hub height), NREL WIND Toolkit. | wind\_siting | | `mean_wind_speed_160m_ms` | climate | float | m/s | NREL\_WIND\_TOOLKIT | Annual-mean wind speed at 160m (tall-tower/repowering height), NREL WIND Toolkit. | wind\_siting | | `wind_power_density_100m_wm2` | climate | float | W/m2 | NREL\_WIND\_TOOLKIT | Mean wind power density at 100m (time-mean of 0.5*rho*v^3), the canonical resource grade. NREL WIND Toolkit-derived. | wind\_siting | | `prevailing_wind_direction_100m_cardinal` | climate | string | — | NREL\_WIND\_TOOLKIT | 16-point modal wind-from sector (energy-weighted) at 100m, NREL WIND Toolkit. | wind\_siting | | `weibull_k_100m` | climate | float | — | NREL\_WIND\_TOOLKIT | Weibull shape parameter k of the 100m wind-speed distribution, NREL WIND Toolkit. | wind\_siting | | `wind_capacity_factor_pct` | climate | float | pct | NREL\_REV\_LANDBASED\_WIND\_SC\_2024 | Modeled mean capacity factor of a reference 115m-hub / 170m-rotor turbine at the nearest NREL reV land-based supply-curve point. | wind\_siting | | `wind_least_cost_interconnect_distance_m` | climate | float | m | NREL\_REV\_LANDBASED\_WIND\_SC\_2024 | NREL reV modeled least-cost spur distance from the nearest supply-curve point to the nearest available substation. | wind\_siting, storage\_siting, grid\_interconnect | | `design_wet_bulb_temperature_0_4pct_degc` | climate | float | degC | NREL\_NSRDB\_GOES\_TMY\_V4 | TMY-based approximation of the 0.4% cooling design wet-bulb: the 99.6th percentile of hourly wet-bulb over one NREL NSRDB GOES-TMY year, solved psychrometrically from dry-bulb + dew-point. A single typical year clips extremes, so this runs slightly cool of the true multi-year ASHRAE design value (reported at medium confidence). | data\_center\_siting | | `mean_annual_dry_bulb_temperature_degc` | climate | float | degC | NOAA\_NCEI\_NORMALS\_GRIDDED | Mean annual dry-bulb air temperature from NOAA NCEI 1991-2020 gridded normals (\~4.6 km). CONUS only. | solar\_siting, data\_center\_siting | | `mean_annual_relative_humidity_pct` | climate | float | pct | NREL\_NSRDB\_GOES\_TMY\_V4 | Mean annual relative humidity, the mean of the hourly RH column from the same NREL NSRDB GOES-TMY series the design wet-bulb is derived from (one fetch, one climatology, self-consistent). | data\_center\_siting | | `days_above_32c_annual_count` | climate | int | days | NOAA\_NCEI\_NCLIMGRID\_DAILY | Mean days/yr with Tmax >= 32C (90F), from NOAA NCEI nClimGrid-Daily (\~5 km) averaged across years. CONUS only. | solar\_siting, data\_center\_siting | | `mean_annual_snow_cover_days` | climate | int | days | NSIDC\_MODIS\_SNOW\_COVER\_DURATION | Mean annual snow-cover days from the NSIDC-0791 MODIS/Terra 0.01deg snow-cover-duration climatology (WY2001-2023). CONUS only. | solar\_siting | | `seismic_design_category` | hazards | string | — | USGS\_DESIGNMAPS\_ASCE7 | ASCE 7-22 Seismic Design Category (A-F) from the USGS design-maps web service. Site class is assumed D (code default); recorded in provenance. | natural\_hazard | | `seismic_pga_2pct_50yr_g` | hazards | float | g | USGS\_NSHM | Peak ground acceleration at 2% exceedance in 50yr (\~2475-yr return), firm-rock VS30=760, from the USGS 2023 NSHM. CONUS only. | natural\_hazard | | `design_wind_speed_mph` | hazards | float | mph | NOAA\_ASCE\_WIND\_VECTORS | ASCE 7-22 basic design wind speed (3-second gust, Risk Category II / 700-yr MRI, Exposure C) from NOAA's free CC0 mirror of the ASCE wind vectors. | natural\_hazard | | `wildfire_annual_frequency` | hazards | float | — | FEMA\_NRI | Annualized wildfire event frequency (events/yr) for the containing Census tract, from FEMA National Risk Index (WFIR\_AFREQ). | natural\_hazard | | `tornado_annual_frequency` | hazards | float | — | FEMA\_NRI | Annualized tornado event frequency (events/yr) for the containing Census tract, from FEMA NRI (TRND\_AFREQ). | natural\_hazard | | `hail_annual_frequency` | hazards | float | — | FEMA\_NRI | Annualized hail event frequency (events/yr) for the containing Census tract, from FEMA NRI (HAIL\_AFREQ). | natural\_hazard | | `lightning_annual_flash_days` | hazards | float | days | FEMA\_NRI | Estimated lightning days per year for the containing Census tract, from FEMA NRI (LTNG\_AFREQ; days/yr, not flash count). | natural\_hazard | | `landslide_susceptibility_index` | hazards | int | — | USGS\_LANDSLIDE\_SUSCEPTIBILITY | USGS Slope-Relief-Threshold landslide susceptibility (0-81 = count of susceptible 10 m cells in the 90 m cell). National. | natural\_hazard | | `nearest_dam_distance_m` | hazards | float | m | USACE\_NID | Straight-line distance to the nearest dam in the USACE National Inventory of Dams, searched within a 10 km screening band. | data\_center\_siting, natural\_hazard | | `nearest_dam_hazard_potential` | hazards | str | — | USACE\_NID | USACE hazard-potential class of the nearest NID dam (High / Significant / Low / Undetermined). | data\_center\_siting, natural\_hazard | | `high_hazard_dams_within_10km` | hazards | int | — | USACE\_NID | Count of High hazard-potential NID dams within 10 km of the point. | data\_center\_siting, natural\_hazard | | `nearest_hazardous_facility_distance_m` | hazards | float | m | EPA\_FRS\_RMP | Distance to the nearest EPA Risk Management Program (RMP) facility geocode in the Facility Registry Service, searched within 10 km. | data\_center\_siting | | `nearest_hazardous_facility_name` | hazards | str | — | EPA\_FRS\_RMP | EPA FRS primary name of the nearest RMP-registered facility (upstream casing preserved). | data\_center\_siting | | `housing_units_within_1km` | hazards | int | — | CENSUS\_TIGERWEB | 2020 Census housing units across blocks intersecting a 1 km band around the point (TIGERweb tabblock HU100; edge blocks counted whole). | site\_selection, solar\_siting, wind\_siting, data\_center\_siting | | `housing_units_density_per_km2` | hazards | float | units/km2 | CENSUS\_TIGERWEB | Housing units per km2 of block land area within the 1 km band (water excluded from the denominator), from 2020 Census blocks. | solar\_siting, wind\_siting, data\_center\_siting | | `nearest_substation_distance_m` | utilities | float | meters | EIA\_POWER | Great-circle distance to the nearest electric substation (EIA Atlas, >=69kV layer), the physical interconnection injection point. | storage\_siting, data\_center\_siting, grid\_interconnect | | `nearest_substation_max_voltage_kv` | utilities | float | kV | EIA\_POWER | Maximum voltage (MAX\_VOLT) of the nearest electric substation, from EIA Atlas. | storage\_siting, data\_center\_siting, grid\_interconnect | | `nearest_substation_status` | utilities | string | — | EIA\_POWER | Operational status of the nearest substation (e.g. IN SERVICE / UNDER CONST / PROPOSED / NOT AVAILABLE), from EIA Atlas. | storage\_siting, data\_center\_siting, grid\_interconnect | | `electric_utility_service_territory` | utilities | string | — | EIA\_POWER | Name of the retail electric utility whose service territory contains the point. First routing key for interconnection / PPA / tariff. | storage\_siting, data\_center\_siting, grid\_interconnect | | `avg_retail_electricity_price_industrial_usd_per_kwh` | utilities | float | USD/kWh | EIA\_ELEC\_SALES\_REVENUE\_PRICE | Most-recent industrial-sector average retail electricity price for the area (EIA; state-level, refinable to utility once territory is known). | storage\_siting, data\_center\_siting | | `egrid_subregion` | utilities | string | — | EPA\_EGRID | EPA eGRID subregion code (e.g. RFCW, CAMX, ERCT) whose polygon contains the point. | data\_center\_siting, grid\_interconnect | | `egrid_co2_output_rate_kg_per_mwh` | utilities | float | kgCO2e/MWh | EPA\_EGRID | Annual total-output CO2e rate of the containing eGRID subregion (EPA eGRID). | storage\_siting, data\_center\_siting | | `interconnection_queue_active_capacity_county_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Total nameplate MW of active-queue generation/storage projects in the containing county (LBNL 'Queued Up', keyed by county FIPS). | storage\_siting, data\_center\_siting, grid\_interconnect | | `nearest_proposed_generator_distance_m` | utilities | float | meters | EIA\_860M | Distance to the nearest proposed / under-construction generator (EIA-860M Planned tab). Existing power-plant fields cover operating plants only. | storage\_siting, grid\_interconnect | | `surface_water_supply_use_index_huc12` | utilities | float | — | USGS\_IWAA\_WATER\_BUDGET | USGS surface-water supply-and-use index (0 = no limitation to 1 = total local depletion) for the containing HUC12 watershed. | data\_center\_siting | | `public_water_system_population_served` | utilities | int | — | EPA\_CWS\_SERVICE\_AREAS | Population served by the EPA community water system whose service-area polygon contains the point. | data\_center\_siting | | `huc12_thermoelectric_consumptive_use_m3_per_day` | utilities | float | m3/day | USGS\_THERMOELECTRIC\_WATER\_USE | Existing freshwater thermoelectric consumptive use summed in the containing HUC12, latest full year 2020 (USGS 2008-2020 reanalysis). | data\_center\_siting | | `nearest_groundwater_well_depth_to_water_m` | utilities | float | meters | USGS\_NWIS\_OGC | Depth to water at the nearest USGS NWIS groundwater well (param 72019). Sparse / often a historical reading — use as a coarse indicator. | data\_center\_siting | | `fiber_provider_count` | utilities | int | — | FCC\_BDC\_FIXED | Count of distinct ISPs reporting Fiber-to-the-Premises (FTTP) mass-market availability in the FCC BDC H3 res-8 hexagon containing the point (live ArcGIS Living Atlas mirror). | data\_center\_siting | | `fiber_broadband_available` | utilities | bool | — | FCC\_BDC\_FIXED | Whether >=1 ISP reports fiber (FTTP) mass-market availability in the FCC BDC H3 res-8 hexagon containing the point (live ArcGIS Living Atlas mirror). | data\_center\_siting | | `mobile_5g_coverage_class` | utilities | string | — | FCC\_BDC\_MOBILE | Best modeled 5G-NR coverage tier whose polygon contains the point (FCC BDC mobile, max across carriers). | data\_center\_siting | | `nearest_urban_area_distance_m` | utilities | float | meters | CENSUS\_TIGER\_URBAN | Straight-line distance to the nearest 2020 Census Urban Area boundary (0 if inside an urban area). | site\_selection, data\_center\_siting | | `surface_management_agency` | parcels | string | — | BLM\_SMA | Federal surface-managing agency of the containing parcel (BLM/USFS/NPS/FWS/DOD/BOR/BIA/OTHER\_FEDERAL/STATE/PRIVATE\_OR\_UNKNOWN), from the BLM SMA layer. | solar\_siting, wind\_siting, storage\_siting, data\_center\_siting | | `special_use_airspace_type` | parcels | string | — | FAA\_SUA | FAA Special Use Airspace containing the point (moa / restricted / prohibited / warning / alert / none; most-restrictive when multiple). | wind\_siting | | `blm_solar_application_land_status` | parcels | string | — | BLM\_SOLAR\_PEIS\_2024 | 2024 Western Solar Plan ROD (Approved Plan) land status of the point on BLM land (available / avoidance / excluded / other / drecp\_cdca / western\_washington / not\_blm\_solar\_planning\_area). | solar\_siting | | `golden_eagle_nest_density_index` | parcels | float | — | USFWS\_GOEA\_RND | USFWS predicted relative golden-eagle nest-site density (0-1) at the point. Western US only; null elsewhere by design. | wind\_siting | | `nearest_wind_turbine_distance_m` | built\_environment | float | meters | USWTDB | Distance to the nearest existing wind turbine (USGS/LBNL US Wind Turbine Database). | wind\_siting | | `nearest_wind_turbine_hub_height_m` | built\_environment | float | meters | USWTDB | Hub height of the nearest USWTDB turbine. | wind\_siting | | `nearest_wind_turbine_total_height_m` | built\_environment | float | meters | USWTDB | Total tip height of the nearest USWTDB turbine. | wind\_siting | | `nearest_wind_project_capacity_mw` | built\_environment | float | MW | USWTDB | Nameplate capacity of the project containing the nearest USWTDB turbine. | wind\_siting | | `nearest_utility_solar_facility_distance_m` | built\_environment | float | meters | USPVDB | Distance to the centroid of the nearest operating utility-scale (>=1MW) ground-mount PV facility (USGS USPVDB; the source carries facility centroids, not footprint polygons). | solar\_siting, storage\_siting | | `nearest_utility_solar_facility_capacity_mw` | built\_environment | float | MW | USPVDB | AC nameplate capacity of the nearest utility-scale PV facility (USPVDB). | solar\_siting | | `nearest_repowering_site_distance_m` | built\_environment | float | meters | EPA\_REPOWERING | Distance to the nearest EPA RE-Powering screened contaminated/disturbed site (brownfield, landfill, mine), from the 2021 RE-Powering Mapper dataset (\~190k sites). | site\_selection, solar\_siting, wind\_siting, data\_center\_siting | | `soil_shrink_swell_class` | terrain | string | — | USDA\_SSURGO | Expansive-soil class (Low / Moderate / High / Very High) of the dominant component, derived from SSURGO linear extensibility (lep\_r) via Soil Data Access. | data\_center\_siting, natural\_hazard | | `prime_farmland_classification` | terrain | string | — | USDA\_SSURGO | SSURGO farmland classification collapsed to an enum (prime / prime\_if\_conditions\_met / statewide\_importance / unique / local\_importance / not\_prime). | solar\_siting, wind\_siting, storage\_siting | | `natural_gas_citygate_price_usd_per_mcf` | utilities | float | USD/MCF | EIA\_NATURAL\_GAS\_PRICES | Most-recent monthly city-gate natural-gas price for the state (EIA natural-gas/pri/sum, process PG1; latest non-null month). | data\_center\_siting | | `natural_gas_industrial_price_usd_per_mcf` | utilities | float | USD/MCF | EIA\_NATURAL\_GAS\_PRICES | Most-recent monthly industrial natural-gas price for the state (EIA natural-gas/pri/sum, process PIN; latest non-null month). | data\_center\_siting | | `in_shale_play` | utilities | bool | — | EIA\_SHALE\_PLAYS | Whether the point falls within a mapped EIA tight-oil / shale-gas play polygon (Lower-48; point-in-polygon). | data\_center\_siting | | `nearest_shale_play_name` | utilities | string | — | EIA\_SHALE\_PLAYS | Name of the primary (largest-area) shale play containing the point; stacked plays are noted in provenance. Absent if not in any play. | data\_center\_siting | | `sedimentary_basin_name` | utilities | string | — | USGS\_SEDIMENTARY\_BASINS | Name of the USGS sedimentary basin containing the point (point-in-polygon; the clean single-basin "name" label). Absent if not in any mapped basin. | data\_center\_siting | | `nearest_gas_compressor_distance_m` | utilities | float | m | EIA\_GAS\_INFRASTRUCTURE | Geodesic distance to the nearest natural-gas compressor station (HIFLD/EIA point layer; nearest within 200 km). | data\_center\_siting | | `nearest_gas_storage_distance_m` | utilities | float | m | EIA\_GAS\_INFRASTRUCTURE | Geodesic distance to the nearest underground natural-gas storage facility (HIFLD/EIA point layer; nearest within 200 km). | data\_center\_siting | | `nearest_lng_terminal_distance_m` | utilities | float | m | EIA\_GAS\_INFRASTRUCTURE | Geodesic distance to the nearest LNG import/export terminal, EXISTING OR PROPOSED/APPROVED (HIFLD/EIA point layer, sourced from FERC's existing-and-proposed terminal layer; nearest within 200 km). A proposed terminal may not yet be built — confirm current status with the operator/FERC. | data\_center\_siting | | `drought_category` | climate | string | — | USDM\_CURRENT | US Drought Monitor category at the point (D0 Abnormally Dry .. D4 Exceptional), the MAX class of the severity-nested dissolved USDM polygons containing the point. Null = point in no drought polygon (better than D0). | data\_center\_siting | | `in_opportunity_zone` | built\_environment | bool | — | HUD\_OPPORTUNITY\_ZONES | True if the queried point falls inside a designated Qualified Opportunity Zone (QOZ) census tract; False if it does not. | site\_selection, data\_center\_siting | | `opportunity_zone_tract_geoid` | built\_environment | string | — | HUD\_OPPORTUNITY\_ZONES | The 11-character GEOID10 census-tract code of the designated Opportunity Zone containing the point (null when the point is not in any OZ). | data\_center\_siting | | `in_air_quality_nonattainment` | hazards | bool | — | EPA\_GREEN\_BOOK | True if the point falls in any current EPA NAAQS nonattainment area (ozone / PM2.5 / PM10 / CO / SO2 / NO2 / lead). | data\_center\_siting | | `air_quality_nonattainment_pollutants` | hazards | string | — | EPA\_GREEN\_BOOK | Comma-joined distinct pollutant names for which the point is in a nonattainment area (e.g. "Ozone (2015),PM2.5 (2012)"). | data\_center\_siting | | `air_quality_worst_classification` | hazards | string | — | EPA\_GREEN\_BOOK | Worst ozone/CO nonattainment classification among matches (Extreme > Severe > Serious > Moderate > Marginal). | data\_center\_siting | | `nearest_brownfield_distance_m` | hazards | float | m | EPA\_ACRES | Straight-line distance to the nearest EPA ACRES brownfield site within an 8 km screening band (EPA Facility Registry Service). | data\_center\_siting | | `brownfields_within_radius_count` | hazards | int | — | EPA\_ACRES | Count of EPA ACRES brownfield sites within 8 km of the point. | data\_center\_siting | | `nearest_superfund_distance_m` | hazards | float | m | EPA\_SEMS | Straight-line distance to the nearest EPA SEMS Superfund-inventory site within an 8 km screening band (EPA Facility Registry Service). | data\_center\_siting | | `superfund_sites_within_radius_count` | hazards | int | — | EPA\_SEMS | Count of EPA SEMS Superfund-inventory sites within 8 km of the point. | data\_center\_siting | | `air_district_name` | hazards | string | — | CARB\_AIR\_DISTRICTS | Name of the California air district (CARB) whose boundary contains the point (e.g. "Bay Area", "South Coast"). Null outside California. | data\_center\_siting | | `nearest_submarine_cable_distance_m` | utilities | float | meters | NOAA\_MARINECADASTRE\_SUBMARINE\_CABLE | Geodesic distance to the nearest NOAA-charted submarine cable right-of-way corridor; 0 when the point lies inside a corridor. | data\_center\_siting | | `nearest_submarine_cable_name` | utilities | str | — | NOAA\_MARINECADASTRE\_SUBMARINE\_CABLE | Name of the nearest charted submarine cable system (e.g. "North Pacific Cable System"), when the corridor carries a cablesystem name. | data\_center\_siting | | `nearest_long_haul_rail_corridor_distance_m` | utilities | float | meters | BTS\_NTAD | Distance in meters to the nearest BTS NTAD mainline rail line (a long-haul right-of-way corridor). | data\_center\_siting | | `nearest_gas_pipeline_operator` | utilities | string | — | EIA\_ATLAS | Operator/company of the nearest EIA interstate natural-gas pipeline (source Operator field). | — | | `nearest_gas_pipeline_type` | utilities | string | — | EIA\_ATLAS | Type of the nearest gas pipeline — Interstate or Intrastate (source TYPEPIPE). | — | | `gas_pipelines_within_radius_count` | utilities | int | — | EIA\_ATLAS | Count of EIA gas pipeline segments within the search radius (pipelines\_radius\_m). | — | | `nearest_petroleum_pipeline_distance_m` | utilities | float | meters | EIA\_ATLAS | Distance in meters to the nearest EIA petroleum-product pipeline. | — | | `nearest_petroleum_pipeline_operator` | utilities | string | — | EIA\_ATLAS | Operator of the nearest petroleum-product pipeline. | — | | `nearest_petroleum_pipeline_product` | utilities | string | — | EIA\_ATLAS | Commodity carried by the nearest petroleum-product pipeline (e.g. crude oil, refined products, HGL/NGL). | — | | `petroleum_pipelines_within_radius_count` | utilities | int | — | EIA\_ATLAS | Count of petroleum-product pipeline segments within pipelines\_radius\_m. | — | | `pipelines_radius_m` | utilities | float | meters | EIA\_ATLAS | Search radius in meters used for the gas + petroleum pipeline proximity counts. | — | | `nearest_interstate_gas_pipeline_distance_m` | utilities | float | meters | HIFLD\_GAS\_TRANSMISSION\_PIPELINES | Unbounded geodesic distance in meters to the nearest EIA INTERSTATE natural-gas transmission trunkline (TYPEPIPE = Interstate). | data\_center\_siting | | `nearest_interstate_gas_pipeline_operator` | utilities | string | — | HIFLD\_GAS\_TRANSMISSION\_PIPELINES | Operator/company of the nearest EIA interstate natural-gas transmission trunkline (source Operator field). | — | | `nearest_gas_transmission_pipeline_distance_m` | utilities | float | meters | HIFLD\_GAS\_TRANSMISSION\_PIPELINES | Unbounded geodesic distance in meters to the nearest EIA gas TRANSMISSION pipeline of ANY type (interstate or intrastate). | — | | `grid_price_usd_per_mwh` | utilities | float | USD/MWh | MIREYE\_MODELED\_ENERGY\_COST | Grid electricity price expressed per MWh — the EIA state industrial retail price (USD/kWh) x 1000. All-in retail (includes delivery, capital recovery, O\&M). Derived; MEDIUM confidence (deterministic unit conversion). | data\_center\_siting | | `modeled_onsite_gas_generation_cost_usd_per_mwh` | utilities | float | USD/MWh | MIREYE\_MODELED\_ENERGY\_COST | MODELED fuel-only cost of on-site natural-gas generation — the EIA state industrial gas price (USD/Mcf) / 1.037 MMBtu/Mcf x 9.5 MMBtu/MWh simple-cycle genset heat rate. NOT a delivered-power quote. Derived; LOW confidence (heat-rate assumption dominates). | data\_center\_siting | | `substations_within_radius_count` | utilities | int | — | EIA\_POWER | Count of EIA Atlas electric substations (>=69 kV layer) within substations\_radius\_m (10 km) of the point. | site\_selection, data\_center\_siting, grid\_interconnect | | `substations_radius_m` | utilities | float | meters | EIA\_POWER | Search radius (meters) used for substations\_within\_radius\_count — the fixed 10 km band. | site\_selection, data\_center\_siting, grid\_interconnect | | `estimated_annual_power_cost_usd_per_mw` | utilities | float | USD/MW/year | MIREYE\_MODELED\_ENERGY\_COST | DERIVED annual energy cost per MW of continuous (100% load-factor) load at the EIA state industrial retail rate (price x 8,760,000 kWh/MW-yr). A cross-market planning figure, NOT a tariff quote. Derived; MEDIUM confidence (deterministic unit conversion). | data\_center\_siting | | `transmission_redundancy_flag` | utilities | bool | — | MIREYE\_DERIVED\_SITING | DERIVED screening flag — True when >=2 mapped transmission segments lie within \~2 km AND >=3 substations within 10 km (EIA Atlas / HIFLD map topology). Indicates multiple potential feed paths EXIST ON THE MAP, not a deliverability or N-1 claim. Derived; MEDIUM confidence. | site\_selection, data\_center\_siting, grid\_interconnect | | `grading_difficulty_class` | terrain | string | — | MIREYE\_DERIVED\_SITING | DERIVED civil-engineering grading class from the point-sampled 3DEP slope: flat (\<2 deg), moderate (2-8 deg), difficult (>8 deg). A screening rule of thumb, not a code standard. Derived; MEDIUM confidence. | site\_selection, solar\_siting, wind\_siting, storage\_siting, data\_center\_siting | | `residential_context_class_1km` | hazards | string | — | MIREYE\_DERIVED\_SITING | DERIVED categorical band of 2020 Census housing units within 1 km: isolated (0), sparse (1-49), moderate (50-499), dense (>=500). A community-pushback exposure proxy, NOT a nearest-residence distance. Derived; MEDIUM confidence. | site\_selection, data\_center\_siting | | `nearest_class_i_area_distance_m` | hazards | float | meters | EPA\_CLASS\_I\_AREAS | Geodesic distance to the nearest EPA mandatory Class I federal area (national park / wilderness > 6000 acres); 0 when the point lies inside one. | data\_center\_siting | | `nearest_class_i_area_name` | hazards | str | — | EPA\_CLASS\_I\_AREAS | Name of the nearest Class I federal area (e.g. "Yosemite NP", "Sequoia NP"). | data\_center\_siting | | `nearest_class_i_area_agency` | hazards | str | — | EPA\_CLASS\_I\_AREAS | Managing federal agency of the nearest Class I area (USDI-NPS / USDA-FS / USDI-FWS / BIA). | data\_center\_siting | | `in_air_quality_maintenance` | hazards | bool | — | EPA\_GREEN\_BOOK | True if the point falls in any current EPA NAAQS maintenance area (a former nonattainment area redesignated to attainment, still under an approved maintenance plan). | data\_center\_siting | | `air_quality_maintenance_pollutants` | hazards | string | — | EPA\_GREEN\_BOOK | Comma-joined distinct pollutant names for which the point is in a maintenance area (e.g. "Ozone (2008),CO"). | data\_center\_siting | | `interconnection_queue_active_capacity_pjm_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the PJM interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_miso_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the MISO interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_ercot_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the ERCOT interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_caiso_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the CAISO interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_spp_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the SPP interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_nyiso_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the NYISO interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_isone_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to the ISO-NE interconnection queue (LBNL 'Queued Up' project-level region attribution). | grid\_interconnect | | `interconnection_queue_active_capacity_west_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to LBNL's non-ISO 'West' bucket — projects interconnecting through non-CAISO Western utilities (BPA, PacifiCorp, APS, WAPA...), NOT an organized ISO/RTO market. | grid\_interconnect | | `interconnection_queue_active_capacity_southeast_mw` | utilities | float | MW | LBNL\_QUEUED\_UP | Active-queue nameplate MW in the containing county attributed to LBNL's non-ISO 'Southeast' bucket — projects interconnecting through Southeastern utilities (Duke, Southern Company, TVA, FPL...), NOT an organized ISO/RTO market. | grid\_interconnect | | `iso_rto` | utilities | string | — | HIFLD\_ISO\_RTO | ISO/RTO electricity market whose territory footprint contains the point (PJM, MISO, ERCOT, CAISO, SPP, NYISO, or ISO-NE), from the HIFLD/ORNL Independent System Operators polygons (2019-era delineation, point-in-polygon). | grid\_interconnect | | `nearest_hospital_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open hospital (Overture places, conflated Meta/Microsoft/Foursquare POI data; confidence >= 0.5, US only). | site\_selection, points\_of\_interest | | `nearest_hospital_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open hospital (Overture places). | points\_of\_interest | | `nearest_fire_station_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open fire station (Overture places; confidence >= 0.5, US only). | site\_selection, points\_of\_interest | | `nearest_fire_station_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open fire station (Overture places). | points\_of\_interest | | `nearest_school_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open school, preschool through K-12 (Overture places; confidence >= 0.5, US only). | site\_selection, points\_of\_interest | | `nearest_school_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open school (Overture places). | points\_of\_interest | | `nearest_grocery_store_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open grocery store or supermarket (Overture places; confidence >= 0.5, US only). | site\_selection, points\_of\_interest | | `nearest_lodging_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open lodging (hotel/motel/resort/hostel; Overture places; confidence >= 0.5, US only). | site\_selection, points\_of\_interest | | `poi_count_1km` | built\_environment | int | — | OVERTURE\_PLACES | Count of Overture places (points of interest / amenities) within 1 km of the point — restaurants, cafes, bars, shops, gas stations, pharmacies, banks, schools, and every other POI category (confidence >= 0.5, permanently-closed records excluded, US only). | site\_selection, points\_of\_interest | | `nearest_major_road_class` | built\_environment | string | — | OVERTURE\_TRANSPORTATION | Overture road class of the nearest major road (motorway / trunk / primary / secondary). | site\_selection | | `nearest_road_distance_m` | built\_environment | float | meters | OVERTURE\_TRANSPORTATION | Geodesic distance to the nearest vehicular Overture road of any class within the 500 m query radius (pedestrian/cycle classes excluded). | — | | `nearest_road_name` | built\_environment | string | — | OVERTURE\_TRANSPORTATION | Primary name of the nearest vehicular Overture road of any class. | — | | `nearest_road_class` | built\_environment | string | — | OVERTURE\_TRANSPORTATION | Overture road class of the nearest vehicular road (motorway / trunk / primary / secondary / tertiary / residential / service / unclassified / ...; pedestrian/cycle classes are excluded from the search). | — | | `nearest_road_surface` | built\_environment | string | — | OVERTURE\_TRANSPORTATION | Surface of the nearest vehicular Overture road (paved / unpaved / gravel / dirt / ...), from the first road\_surface rule on the segment. | — | | `roads_within_500m_count` | built\_environment | int | — | OVERTURE\_TRANSPORTATION | Count of vehicular Overture road segments within 500 m of the point (pedestrian/cycle classes excluded). | site\_selection | | `total_road_length_within_500m_m` | built\_environment | float | meters | OVERTURE\_TRANSPORTATION | Summed centerline length in meters of vehicular Overture road segments clipped to a 500 m radius disc around the point (pedestrian/cycle classes excluded). | — | | `nearest_usgs_gage_id` | utilities | string | — | USGS\_NWIS\_OGC | Monitoring-location id (e.g. USGS-08075900) of the nearest USGS gage that reported a daily-mean discharge within the last 7 days, within \~10 km. | — | | `nearest_usgs_gage_name` | utilities | string | — | USGS\_NWIS\_OGC | Station name of the nearest actively-reporting USGS discharge gage (from the monitoring-locations collection). | — | | `nearest_usgs_gage_distance_m` | utilities | float | meters | USGS\_NWIS\_OGC | Geodesic distance to the nearest USGS gage that reported a daily-mean discharge within the last 7 days. | — | | `nearest_usgs_gage_daily_discharge_cfs` | utilities | float | cubic feet per second | USGS\_NWIS\_OGC | Latest daily-mean streamflow (discharge, USGS parameter 00060) at the nearest actively-reporting USGS gage. The reading date is disclosed in the field notes; daily values lag \~1 day. | data\_center\_siting | | `fema_flood_zone` | terrain | str | — | FEMA\_NFHL | FEMA NFHL flood-zone code at the queried point (e.g. AE, VE, X, A, AO), from the SFHA-driving polygon where multiple intersect. | data\_center\_siting | | `flood_zone_subtype` | terrain | str | — | FEMA\_NFHL | FEMA NFHL zone subtype (ZONE\_SUBTY) at the point, e.g. FLOODWAY, "0.2 PCT ANNUAL CHANCE FLOOD HAZARD", or a coastal-A / LiMWA descriptor. | — | | `coastal_high_hazard` | terrain | bool | — | FEMA\_NFHL | True if the FEMA flood zone is V-family (V/VE/V1-30) — a coastal high-hazard area subject to high-velocity wave action (breaking waves >= 3 ft). | — | | `fema_base_flood_elevation` | terrain | float | feet | FEMA\_NFHL | FEMA Base Flood Elevation (STATIC\_BFE) at the point, NAVD88, when the intersecting polygon carries one on a NAVD88 datum. | — | | `wetland_fraction_of_parcel` | parcels | float | — | USFWS\_NWI | Fraction (0.0-1.0) of the matched Regrid parcel's own boundary covered by USFWS NWI wetland polygons — the parcel share, computed by intersecting NWI wetlands with the parcel boundary in the parcel's local UTM (equal-area) projection. NOT the whole mapped wetland polygon's size (see the terrain-layer wetland\_acres for that). | — | | `wetland_acres_on_parcel` | parcels | float | acre | USFWS\_NWI | Absolute acres of USFWS NWI wetland polygon area intersecting the matched Regrid parcel's own boundary — the parcel-clipped wetland acreage, computed in the parcel's local UTM (equal-area) projection. NOT the whole mapped wetland polygon's size (see the terrain-layer wetland\_acres for that). | site\_selection | | `dhi_annual_kwh_m2_day` | climate | float | kWh/m2/day | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual diffuse horizontal irradiance sum (kWh/m2/day) from one NREL NSRDB GOES-TMY year — the portion of GHI arriving as diffuse (non-beam) sky light. | — | | `diffuse_fraction_annual` | climate | float | — | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual diffuse fraction (ΣDHI/ΣGHI, 0-1) from one NREL NSRDB GOES-TMY year — the share of global irradiance arriving as diffuse (non-beam) light. | — | | `clearsky_ghi_annual_kwh_m2_day` | climate | float | kWh/m2/day | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual clear-sky (cloud-free-modeled) global horizontal irradiance sum (kWh/m2/day) from one NREL NSRDB GOES-TMY year — the theoretical maximum GHI absent clouds and aerosols. | — | | `clearsky_dni_annual_kwh_m2_day` | climate | float | kWh/m2/day | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual clear-sky direct normal irradiance sum (kWh/m2/day) from one NREL NSRDB GOES-TMY year — the theoretical maximum beam irradiance absent clouds and aerosols. | — | | `clear_sky_ratio_ghi_annual` | climate | float | — | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual clear-sky ratio for GHI (ΣGHI/ΣClearsky GHI, 0-1) from one NREL NSRDB GOES-TMY year — the fraction of the theoretical clear-sky global irradiance actually realized once clouds and aerosols are accounted for. | — | | `dni_clear_sky_ratio_annual` | climate | float | — | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual clear-sky ratio for DNI (ΣDNI/ΣClearsky DNI, 0-1) from one NREL NSRDB GOES-TMY year — the fraction of the theoretical clear-sky beam irradiance actually realized. | — | | `aerosol_optical_depth_annual_mean` | climate | float | — | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual mean aerosol optical depth (dimensionless, MERRA-2-derived) from one NREL NSRDB GOES-TMY year — atmospheric aerosol loading (haze, smoke, dust) that scatters and absorbs irradiance. | — | | `precipitable_water_annual_mean_cm` | climate | float | cm | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual mean total-column precipitable water (cm, MERRA-2-derived) from one NREL NSRDB GOES-TMY year — atmospheric water vapor that attenuates irradiance. | — | | `near_surface_wind_speed_annual_mean_ms` | climate | float | m/s | NREL\_NSRDB\_GOES\_TMY\_V4 | Annual mean near-surface (10 m) wind speed (m/s, MERRA-2-derived) from one NREL NSRDB GOES-TMY year — used to estimate PV module cooling and thermal derate. | — | | `poa_irradiance_optimal_tilt_kwh_m2_yr` | climate | float | kWh/m2/yr | NREL\_PVWATTS\_V8 | Annual plane-of-array irradiance — the sum of the 12 monthly PVWatts poa\_monthly values (each already kWh/m2 for that month) — at the advertised optimal fixed tilt (\|lat\|), open-rack. From the SAME NREL PVWatts v8 call that yields capacity factor / specific yield. | — | | `soil_ponding_frequency_class` | terrain | string | — | USDA\_SSURGO | Worst-case ponding frequency class (None / Rare / Occasional / Frequent / Very frequent) of the dominant SSURGO component, aggregated across its 12 monthly comonth records via Soil Data Access. | — | | `developable_acres_proxy` | parcels | float | acre | MIREYE\_DERIVED\_SITING | DERIVED Regrid parcel acreage net of parcel-clipped NWI wetland overlap only, floored at 0. A screening proxy, NOT a survey or buildable-area determination. Rides the metered Regrid parcel root (no extra paid call). Derived; MEDIUM confidence. | site\_selection | | `btm_gas_candidacy_flag` | utilities | bool | — | MIREYE\_DERIVED\_SITING | DERIVED knockout screen for on-site (behind-the-meter) gas-generation candidacy: an EIA interstate gas pipeline within 10 km (formula v2, distance-only; v1's shale-play conjunct was dropped — shale membership gates wellhead gas, not transported gas). NOT a deliverability claim. Derived; MEDIUM confidence. | data\_center\_siting | | `tax_incentive_stack` | built\_environment | string | — | MIREYE\_DERIVED\_SITING | DERIVED comma-joined federal-incentive flags (opportunity\_zone, brownfield\_repowering\_screened). Indicative only, NOT a benefits determination. Empty string = no flag fired. Derived; MEDIUM confidence. | site\_selection, data\_center\_siting | | `near_epa_repowering_site` | built\_environment | bool | — | MIREYE\_DERIVED\_SITING | DERIVED companion bool to tax\_incentive\_stack: an EPA RE-Powering screened contaminated/disturbed site within 1 km. Survives a partial-input failure independently of the joined stack. Derived; MEDIUM confidence. | site\_selection, data\_center\_siting | | `soil_hydrologic_group` | terrain | string | — | USDA\_SSURGO | USDA SSURGO hydrologic soil group of the dominant component (A/B/C/D and dual A/D, B/D, C/D; first letter = artificially-drained condition, second = natural undrained state). | solar\_siting, storage\_siting, data\_center\_siting | | `soil_restrictive_layer_depth_cm` | terrain | float | cm | USDA\_SSURGO | Representative depth (cm) to the top of the shallowest root/water-restrictive layer in the dominant SSURGO component (0-200 cm; 200 or null = no restriction found within the described 200 cm profile, right-censored — not a measured 2 m depth). | wind\_siting, data\_center\_siting | | `soil_restrictive_layer_kind` | terrain | string | — | USDA\_SSURGO | Type of the shallowest root/water-restrictive layer in the dominant SSURGO component (e.g. Lithic bedrock, Paralithic bedrock, Densic material, Duripan, Fragipan). | wind\_siting, data\_center\_siting | | `soil_available_water_capacity` | terrain | float | cm/cm | USDA\_SSURGO | Plant-available water capacity of the dominant SSURGO component as a volume fraction (cm water per cm soil, \~0.01-0.30) between field capacity and wilting point — a ratio, not a total-water depth. | solar\_siting | | `soil_erodibility_k_factor` | terrain | float | — | USDA\_SSURGO | USLE/RUSLE whole-soil erodibility factor (Kw) of the dominant SSURGO component — a dimensionless index (\~0.02-0.69, higher = more erodible). | solar\_siting, data\_center\_siting | | `nearest_power_plant_operator` | utilities | string | — | EIA\_ATLAS | Operating utility of the nearest EIA power plant (EIA-860 Utility\_Na, the company 'responsible for day-to-day operations'). | data\_center\_siting, grid\_interconnect | | `nearest_power_plant_technology` | utilities | string | — | EIA\_ATLAS | Generation technology (prime mover + fuel) of the nearest EIA power plant (EIA-860 tech\_desc). | data\_center\_siting, grid\_interconnect | | `free_cooling_hours_per_year_15c` | climate | int | hours/year | NREL\_NSRDB\_GOES\_TMY\_V4 | Count of hours per typical meteorological year (NREL NSRDB GOES-TMY) with dry-bulb air temperature at or below 15 °C — a conservative dry-bulb airside-economizer PROXY (formula v1), NOT an energy model. The companion free\_cooling\_hours\_per\_year\_10c uses a 10 °C conservative band. | data\_center\_siting | | `free_cooling_hours_per_year_10c` | climate | int | hours/year | NREL\_NSRDB\_GOES\_TMY\_V4 | Count of hours per typical meteorological year (NREL NSRDB GOES-TMY) with dry-bulb air temperature at or below 10 °C — a conservative dry-bulb airside-economizer PROXY (formula v1) with extra headroom for fan gain and tighter supply-air setpoints. The companion free\_cooling\_hours\_per\_year\_15c uses a 15 °C band. | data\_center\_siting | | `onsite_solar_potential_mwac_low` | parcels | float | MWac | MIREYE\_DERIVED\_SITING | DERIVED lower bound of nameplate utility-scale PV potential on the GROSS Regrid parcel acreage at NREL land-use density (formula v1: parcel acres / 10 ac/MWac). A sizing prior, NOT a design (ignores setbacks, wetlands, geometry, zoning, interconnection). Rides the metered Regrid parcel root (no extra paid call). Derived; MEDIUM confidence. | site\_selection | | `onsite_solar_potential_mwac_high` | parcels | float | MWac | MIREYE\_DERIVED\_SITING | DERIVED upper bound of nameplate utility-scale PV potential on the GROSS Regrid parcel acreage at NREL land-use density (formula v1: parcel acres / 5.5 ac/MWac). A sizing prior, NOT a design (ignores setbacks, wetlands, geometry, zoning, interconnection). Rides the metered Regrid parcel root (no extra paid call). Derived; MEDIUM confidence. | site\_selection | | `nearest_urban_area_rtt_floor_ms` | utilities | float | milliseconds | MIREYE\_DERIVED\_SITING | DERIVED speed-of-light-in-fiber round-trip LOWER BOUND (formula v1: 2 × straight-line distance to the nearest Census urban-area boundary ÷ (c/1.468)) — a physical floor, NOT an RTT estimate (real routes are 1.5–3× longer and add equipment latency). 0.0 inside an urban area; null beyond the 100 km input bound. Derived; MEDIUM confidence. | site\_selection, data\_center\_siting | | `nearest_proposed_generator_capacity_mw` | utilities | float | megawatts | EIA\_860M | Gross nameplate capacity (MW) of the nearest EIA-860M planned / under-construction generator (EIA-860M Planned tab). | storage\_siting, grid\_interconnect | | `nearest_proposed_generator_status` | utilities | string | — | EIA\_860M | Development status of the nearest EIA-860M planned generator, decoded from the EIA status code (EIA-860M Planned tab). | storage\_siting, grid\_interconnect | | `nearest_restaurant_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open restaurant — any cuisine, incl. fast food, pizza, diner, steakhouse, food court (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_restaurant_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open restaurant (Overture places). | points\_of\_interest | | `nearest_cafe_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open cafe / coffee shop, incl. tea room and coffee roastery (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_cafe_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open cafe / coffee shop (Overture places). | points\_of\_interest | | `nearest_bar_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open bar / pub, incl. brewery, wine / sports / cocktail bar, lounge, nightlife venue (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_bar_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open bar / pub (Overture places). | points\_of\_interest | | `nearest_gas_station_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open gas / fueling station, incl. truck stop and fuel dock (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_gas_station_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open gas station (Overture places). | points\_of\_interest | | `nearest_pharmacy_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open pharmacy / drugstore (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_pharmacy_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open pharmacy / drugstore (Overture places). | points\_of\_interest | | `nearest_bank_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open bank or credit union (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_bank_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open bank or credit union (Overture places). | points\_of\_interest | | `nearest_shopping_center_distance_m` | built\_environment | float | meters | OVERTURE\_PLACES | Geodesic distance to the nearest open shopping center, mall, department store, or outlet store (Overture places; confidence >= 0.5, US only). | points\_of\_interest | | `nearest_shopping_center_name` | built\_environment | string | — | OVERTURE\_PLACES | Name of the nearest open shopping center, mall, department store, or outlet store (Overture places). | points\_of\_interest | | `within_sewer_service_area` | utilities | bool | — | EPA\_SEWERSHEDS | True if the queried point falls inside an EPA Sewersheds v1.1 service-area polygon — the modeled/documented catchment area whose wastewater flows to one specific POTW (sewage treatment plant). | site\_selection, utilities, data\_center\_siting | | `sewer_service_area_provider` | utilities | string | — | EPA\_SEWERSHEDS | CWNS-reported facility (POTW/endpoint) name of the sewershed containing the queried point. | site\_selection, utilities, data\_center\_siting | | `sewer_service_area_provenance` | utilities | string | — | EPA\_SEWERSHEDS | How the containing sewershed boundary was obtained — utility\_sourced (state agency/utility/public GIS) or ml\_modeled (EPA hexagon-classifier estimate). | site\_selection, utilities, data\_center\_siting | | `nearest_sewer_service_area_distance_m` | utilities | float | meters | EPA\_SEWERSHEDS | Geodesic distance to the nearest EPA Sewersheds polygon edge; 0.0 when the point is already within one; null beyond the 50 km search cap. | site\_selection, utilities, data\_center\_siting | | `county_population` | built\_environment | int | people | CENSUS\_PEP | Total resident population of the containing county (Census PEP Vintage 2025 POPESTIMATE2025), keyed by county FIPS. | — | | `county_population_growth_1yr_pct` | built\_environment | float | percent | CENSUS\_PEP | One-year county population change (2025 vs 2024 POPESTIMATE, Census PEP Vintage 2025), as a percentage. | — | | `county_net_domestic_migration` | built\_environment | int | people | CENSUS\_PEP | Net domestic migration for the containing county (Census PEP Vintage 2025 DOMESTICMIG2025), a component of population change. | — | | `county_building_permits_total_annual` | built\_environment | int | units | CENSUS\_BPS | Total residential housing units authorized by building permits in the containing county, latest full year (Census BPS, sum of 1-unit + 2-unit + 3-4 unit + 5+ unit Units). | — | | `county_building_permits_sf_annual` | built\_environment | int | units | CENSUS\_BPS | Single-family (1-unit) housing units authorized by building permits in the containing county, latest full year (Census BPS 1-unit Units). | — | | `county_building_permits_yoy_pct` | built\_environment | float | percent | CENSUS\_BPS | Year-over-year percent change in total permitted housing units for the containing county (latest year vs prior year, Census BPS). | — | | `county_hpi_yoy_pct` | built\_environment | float | percent | FHFA\_HPI | FHFA House Price Index annual percent change for the containing county, latest year (developmental all-transactions county index; the native "Annual Change (%)" column, served verbatim). | — | | `county_employment_total` | built\_environment | int | jobs | BLS\_QCEW | BLS QCEW annual-average covered employment (all ownerships, all industries) for the containing county, latest year. | — | | `county_employment_yoy_pct` | built\_environment | float | percent | BLS\_QCEW | Year-over-year percent change in annual-average covered employment for the containing county (latest year vs prior year, BLS QCEW). | — | | `county_median_household_income` | built\_environment | int | USD | CENSUS\_ACS | ACS 5-year pooled median household income (table B19013 estimate) for the containing county, in USD. | — | ## Gated fields Some recently registered fields (mostly in the `climate`, `hazards`, and the newest `utilities`/`parcels` additions) are catalog-listed but **gated**: their bulk datasets are not yet ingested, so they return honest provenance nulls with a `notes` string explaining the gap instead of fabricated values. They become live per-source as datasets are bootstrapped; nothing about the request shape changes when they do. ## Cache TTLs Each field carries a `ttl_seconds` hint in `/v1/fetch` responses reflecting how often the upstream source changes: | Cadence | `ttl_seconds` | Sources | | --------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | \~1 year | 31,536,000 | BLM\_SOLAR\_PEIS\_2024, CENSUS\_TIGERWEB, CENSUS\_TIGER\_URBAN, EPA\_REPOWERING, NOAA\_ASCE\_WIND\_VECTORS, NOAA\_CUSP, NOAA\_NCEI\_NORMALS\_GRIDDED, NREL\_NSRDB\_GOES\_TMY\_V4, NREL\_PVWATTS\_V8, NREL\_REV\_LANDBASED\_WIND\_SC\_2024, NREL\_SOLAR\_RESOURCE\_V1, NREL\_WIND\_TOOLKIT, NSIDC\_MODIS\_SNOW\_COVER\_DURATION, OVERTURE\_DIVISIONS, USDA\_CDL, USDA\_SSURGO, USDA\_STATSGO, USFS\_LCMS, USFS\_NLCD\_TCC, USFWS\_GOEA\_RND, USFWS\_NWI, USGS\_3DEP, USGS\_DESIGNMAPS\_ASCE7, USGS\_IWAA\_WATER\_BUDGET, USGS\_LANDSLIDE\_SUSCEPTIBILITY, USGS\_NHDPLUS\_HR, USGS\_NSHM, USGS\_THERMOELECTRIC\_WATER\_USE, USGS\_WBD, US\_CENSUS\_GEOCODER | | \~60 days | 5,184,000 | CARB\_AIR\_DISTRICTS | | \~30 days | 2,592,000 | BLM\_SMA, BLS\_QCEW, BTS\_NTAD, BTS\_PORTS, CENSUS\_ACS, CENSUS\_BPS, CENSUS\_PEP, EIA\_860M, EIA\_ELEC\_SALES\_REVENUE\_PRICE, EIA\_GAS\_INFRASTRUCTURE, EIA\_NATURAL\_GAS\_PRICES, EIA\_POWER, EIA\_SHALE\_PLAYS, EPA\_ACRES, EPA\_CLASS\_I\_AREAS, EPA\_CWS\_SERVICE\_AREAS, EPA\_EGRID, EPA\_FRS\_RMP, EPA\_GREEN\_BOOK, EPA\_SEMS, EPA\_SEWERSHEDS, FAA\_NASR, FCC\_BDC\_FIXED, FCC\_BDC\_MOBILE, FEMA\_NFHL, FEMA\_NRI, FHFA\_HPI, FHWA\_NBI, HIFLD\_GAS\_TRANSMISSION\_PIPELINES, HIFLD\_ISO\_RTO, HUD\_OPPORTUNITY\_ZONES, JRC\_GSW, LBNL\_QUEUED\_UP, MIREYE\_DERIVED\_SITING, MIREYE\_MODELED\_ENERGY\_COST, NOAA\_MARINECADASTRE\_SUBMARINE\_CABLE, NOAA\_NCEI\_NCLIMGRID\_DAILY, OVERTURE\_BUILDINGS, OVERTURE\_PLACES, OVERTURE\_TRANSPORTATION, USACE\_NID, USFWS\_CRITHAB, USGS\_PADUS, USGS\_SEDIMENTARY\_BASINS, USPVDB, USWTDB | | \~7 days | 604,800 | FAA\_SUA, FCC\_ASR, SENTINEL2\_NDVI, USDM\_CURRENT | | \~1 day | 86,400 | EIA\_ATLAS, EPA\_SDWIS, REGRID, USGS\_NWIS\_OGC | These are recommendations for downstream caches, not commitments. The underlying values may be updated more or less frequently than the hint suggests — `fetched_at` is the authoritative "as-of" timestamp. ## Data licensing & attribution Most fields derive from US-government public-domain sources. The open-data sources below additionally require attribution, which we pass through here: * **Overture Maps Foundation** (© Overture Maps Foundation) — theme licenses differ, matching each source's declared `spdx`: * `OVERTURE_PLACES` — licensed [CDLA-Permissive-2.0](https://docs.overturemaps.org/attribution/) (permissive). * `OVERTURE_BUILDINGS`, `OVERTURE_TRANSPORTATION`, `OVERTURE_DIVISIONS` — derived from OpenStreetMap (divisions also from geoBoundaries) and licensed under the [Open Database License (ODbL)](https://www.openstreetmap.org/copyright), a **share-alike + attribution** license. Honor attribution and share-alike obligations when redistributing values derived from these themes. * **Foursquare OS Places** — the Overture places theme (POI-context fields such as `nearest_hospital_distance_m` and `poi_count_1km`) includes data from the [Foursquare Open Source Places](https://opensource.foursquare.com/os-places/) dataset, made available by Foursquare Labs, Inc. under the [Apache License, Version 2.0](https://opensource.foursquare.com/places-notice-txt/), alongside Meta and Microsoft place data under CDLA-Permissive-2.0. Each place record's per-source license is carried in Overture's `sources` column. ## Adding fields The catalog lives in `src/mireye_earth/ask/catalog.py`. A new field requires: 1. Append a `FieldSpec` to `FIELDS`. 2. Ensure the `attribute_path` resolves on the relevant layer response and terminates at a `Field_[T]` wrapper. 3. If the field should be planner-discoverable for a common question pattern, add an `interpretation_hints` line. 4. Bump `SCHEMA_VERSION` per the [versioning policy](/api-reference/meta-fields#versioning). Field additions are minor-version bumps (additive, backwards-compatible) and do not require client changes.