# USFWS proposed critical habitat

U.S. Fish and Wildlife Service proposed Endangered Species Act critical habitat features (70; one feature per listed entity, `entity_id`). The GIS files are not the legal source for the boundaries (the Federal Register is); many unit attributes read 'Please check current species specific shapefile'. Mostly terrestrial and freshwater; kept whole because the layer is the first-15 list's FWS critical habitat entry.

- **Collection**: `fws_critical_habitat_proposed` v1.0.3, 70 features, GeoParquet 1.1 (`places.parquet`) and PMTiles (`places.pmtiles`, layer `fws_critical_habitat_proposed`)
- **Licence**: CC-PDDC - U.S. federal government work (USFWS). The item states: None. The GIS files are not the legal source for determining critical habitat boundaries; the Service gives no warranty on accuracy, reliability or completeness. https://www.copyright.gov/title17/92chap1.html#105
- **Attribution**: U.S. Fish and Wildlife Service (USFWS), via MarineCadastre.gov. Public domain; not the legal source for critical habitat boundaries. Processed by Ocean Metrics.
- **Refresh**: monthly, by `.github/workflows/sync.yml` (re-fetched only when the source's `editingInfo.dataLastEditDate` or record count changed)

## Sources and provenance

| Component | Source | Item | Data last edit | Retrieved | Records | Checksum (sha-256 of payload) |
|---|---|---|---|---|---|---|
| - | https://services.arcgis.com/QVENGdaPbd4LUkLV/arcgis/rest/services/USFWS_Critical_Habitat/FeatureServer/2 | 794de45b9d774d21aed3bf9b5313ee24 | 2026-08-31T16:08:20Z | 2026-10-16T17:37:03Z | 70 | `3a4942374639c0b5...` |

Machine-readable copy: [`provenance.json`](./provenance.json) (also in `collection.json` and the Parquet footer).

## Schema

| Column | Type | Description |
|---|---|---|
| place_id | string | prefixed, unique id (e.g. BOEM:OCS-P 0561, BOEM:PA:SOC, AOA:N1-A) |
| authority | string | organisation that publishes the boundary (BOEM, AOA = NOAA Aquaculture Opportunity Areas) |
| source_id | string | the source layer's own identifier for the feature (lease number, planning-area code, OBJECTID, AOA code) |
| name | string | human-readable name |
| place_type | string | kind of place: lease, planning_area or aoa |
| geom_type | string | geometry type (MultiPolygon) |
| status | string | lifecycle status (e.g. active, cancelled, relinquished, settlement_pending, rescinded, draft_proposed, identified) |
| status_source | string | URL that documents the status |
| status_date | string | ISO date (or year) the status took effect or was last confirmed; may be empty |
| status_upstream | string | the source's own status code, verbatim (e.g. BOEM LEASE_STATUS_CD, AREA_STATUS); null when the source has none. may disagree with `status` |
| status_history | string | JSON array of dated status events [{date, value, source, note}], ascending; null when none is logged |
| source_url | string | the service endpoint or download the boundary was fetched from |
| source_date | date32[day] | date of the source's last data edit (retrieval date when the source serves none) |
| retrieved | timestamp[ms, tz=UTC] | UTC time the boundary was fetched |
| version | string | collection release version this row was built for |
| license | string | SPDX identifier of the licence (CC-PDDC = public-domain U.S. government work) |
| attribution | string | credit line to show with the data |
| OBJECTID | int64 | native attribute of the source layer (OBJECTID) |
| singlmulti | string | native attribute of the source layer (singlmulti) |
| comname | string | native attribute of the source layer (comname) |
| sciname | string | native attribute of the source layer (sciname) |
| spcode | string | native attribute of the source layer (spcode) |
| vipcode | string | native attribute of the source layer (vipcode) |
| unit | string | native attribute of the source layer (unit) |
| subunit | string | native attribute of the source layer (subunit) |
| unitname | string | native attribute of the source layer (unitname) |
| status_src | string | native attribute of the source layer (status_src) |
| leadoffice | int64 | native attribute of the source layer (leadoffice) |
| coopoffice | string | native attribute of the source layer (coopoffice) |
| coopofmore | string | native attribute of the source layer (coopofmore) |
| fedreg | string | native attribute of the source layer (fedreg) |
| pubdate | string | native attribute of the source layer (pubdate) |
| effectdate | string | native attribute of the source layer (effectdate) |
| vacatedate | string | native attribute of the source layer (vacatedate) |
| accuracy | string | native attribute of the source layer (accuracy) |
| source_id_src | int64 | native attribute of the source layer (source_id_src) |
| entity_id | int64 | native attribute of the source layer (entity_id) |
| subunitname | string | native attribute of the source layer (subunitname) |
| objectid_1 | int64 | native attribute of the source layer (objectid_1) |
| listing_status | string | native attribute of the source layer (listing_status) |
| GlobalID | string | native attribute of the source layer (GlobalID) |
| Shape__Area | double | native attribute of the source layer (Shape__Area) |
| Shape__Length | double | native attribute of the source layer (Shape__Length) |
| bbox | struct<xmin: double, ymin: double, xmax: double, ymax: double> | GeoParquet bbox-covering column (xmin, ymin, xmax, ymax) |
| geometry | binary | MULTIPOLYGON, EPSG:4326, split at +/-180 antimeridian |

Native attributes keep the source layer's names; a native name equal to a gazetteer column ignoring case
(`NAME` vs `name`) is suffixed `_src`.

## Files

| File | Size | Checksum |
|---|---|---|
| places | 72.3 MB | `122066992c518f08...` |
| places-tiles | 18.5 MB | `122022223b4afc35...` |
| styles/default | 1 kB | `12209274fbede98a...` |
| provenance | 2 kB | `122088f3731091cd...` |
| documentation | 0 kB | `1220e3b0c44298fc...` |

## Quick start

```sql
SELECT place_id, name, status, status_date
FROM read_parquet('https://storage.oceanmetrics.io/gazetteer/fws_critical_habitat_proposed/places.parquet')
ORDER BY place_id;
```

## Changes

- **1.0.3**: first release.