Field catalog - Mireye Earth

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; 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/ 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.5rhov^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 (permissive).
- OVERTURE_BUILDINGS, OVERTURE_TRANSPORTATION, OVERTURE_DIVISIONS — derived from OpenStreetMap (divisions also from geoBoundaries) and licensed under the Open Database License (ODbL), 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 dataset, made available by Foursquare Labs, Inc. under the Apache License, Version 2.0, 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:

Append a FieldSpec to FIELDS.
Ensure the attribute_path resolves on the relevant layer response and terminates at a Field_[T] wrapper.
If the field should be planner-discoverable for a common question pattern, add an interpretation_hints line.
Bump SCHEMA_VERSION per the versioning policy.

Field additions are minor-version bumps (additive, backwards-compatible) and do not require client changes.

​How to read this table

​All fields

​Gated fields

​Cache TTLs

​Data licensing & attribution

​Adding fields