# US Census 2023 Cartographic Boundaries: Counties, Places and County Subdivisions with 2023 Population Estimates (GeoParquet, PMTiles)

## Facts

- Provider: US Census Bureau; GeoParquet conversion by nthh
- License: CC0-1.0 (https://www.census.gov/data.json)
- Format: JSON (in sampled files)
- Stored at: Amazon S3, s3://us-west-2.opendata.source.coop/nthh/us-census-places (us-west-2)
- Access: public, readable without an account
- Category: Demographics & Economics
- Source: https://www.census.gov/geographies/mapping-files/time-series/geo/cartographic-boundary.html
- Page: https://scigantic.com/archive/76aeae16-51db-5b7d-b97f-d3c63489bb06
- Keywords: Demographics & Economics, JSON, AWS Open Data

## About

Shore-clipped outlines of US counties, incorporated places and census designated places, and county subdivisions (minor civil divisions such as towns and townships) from the Census Bureau's 2023 cartographic boundary files, generalized for mapping at 1:500,000 and current as of 1 January 2023 (not legal boundaries). Three GeoParquet files keep every source row, field and geometry in NAD83 (EPSG:4269), sorted on a Hilbert curve, and add source_row, gaz_funcstat (functional status from the 2023 gazetteer), popest_2023 (the 1 July 2023 population estimate) and a bbox column. A display package adds PMTiles outline tiles and a names index for picking places on a web map, and field dictionaries describe every column. Release cb2023-r1 lives under releases/cb2023-r1/ with assets/, display/, licenses/ and metadata/ folders. Read with geopandas, DuckDB spatial or GDAL. Census Bureau data are public domain (the Bureau's data catalog marks them CC0); cite the US Census Bureau as the source.

## Load the data

```python
import boto3
from botocore import UNSIGNED
from botocore.client import Config
s3 = boto3.client('s3', region_name='us-west-2', config=Config(signature_version=UNSIGNED))
s3.list_objects_v2(Bucket='us-west-2.opendata.source.coop', Prefix='nthh/us-census-places/', Delimiter='/')
```

Lists the files with anonymous access. Runs on any machine, with no cloud account.

## Data structure

File types in sampled files: JSON

Example file: `nthh/us-census-places/display/cb2023-display-r3/README.md`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/76aeae16-51db-5b7d-b97f-d3c63489bb06
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/76aeae16-51db-5b7d-b97f-d3c63489bb06
- Over MCP: `get_schema_card` with id `76aeae16-51db-5b7d-b97f-d3c63489bb06` at https://api.scigantic.com/mcp

## Related topics

- [JSON datasets](https://scigantic.com/topics/json)
- [Demographics & Economics datasets](https://scigantic.com/topics/demographics-and-economics)
