Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

civic-data-boundaries-us-cd118

PyPI Python versions License: MIT CI Status Docs

U.S. Civic Boundary Data for Civic Interconnect, including boundaries for the 118th U.S. Congressional Districts.

This package provides and hosts standardized U.S. boundary GeoJSON and shapefile-derived layers from TIGER/Line shapefiles, including:

  • Boundaries for the 118th Congressional Districts (CD118)
  • Support for OCD IDs and simplified formats
  • GeoJSON files and manifest indexes for civic data pipelines

GeoJSON files and indexes are generated for use in civic data pipelines.

For state and county boundaries, see civic-data-boundaries-us.


Installation

uv add civic-data-boundaries-us-cd118
#or
pip install civic-data-boundaries-us-cd118

Or add to pyproject.toml dependencies: "civic-data-boundaries-us-cd118"


Data

This repository hosts pre-generated GeoJSON output in data-out/ for direct use in apps, agents, and public mapping tools.

File Description
index.json List of all available GeoJSON files with bbox & feature counts
manifest.json Dataset metadata (source, license, timestamps, totals)
states/<state>/<file>.geojson Per-state boundary files
national/cd118_us.geojson Entire U.S. (all congressional districts)

Example: Load from Python

import requests
import geopandas as gpd

URL = "https://raw.githubusercontent.com/civic-interconnect/civic-data-boundaries-us-cd118/refs/heads/main/data-out/states/minnesota/cd118_minnesota.geojson"

gdf = gpd.read_file(URL)
print(gdf.head())

Example: Load in JavaScript (Leaflet / MapLibre)

const url = "https://raw.githubusercontent.com/civic-interconnect/civic-data-boundaries-us-cd118/refs/heads/main/data-out/national/cd118_us.geojson";

fetch(url)
  .then(r => r.json())
  .then(data => {
    L.geoJSON(data).addTo(map);
  });

Development

See DEVELOPER.md

Pipeline

Fetch

  • Downloads TIGER zip files
  • Skips files already present

Extract

  • Unzips shapefiles into folders
  • Skips folders already extracted

Export

  • Reads shapefiles
  • Writes chunked GeoJSON files suitable for GH hosting

Cleanup

  • Removes original .zip files and extracted shapefiles once chunked GeoJSONs are complete

References

Direct URLs for the TIGER/Line shapefiles (2022):

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

civic_data_boundaries_us_cd118-0.0.4.dev0.tar.gz (153.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file civic_data_boundaries_us_cd118-0.0.4.dev0.tar.gz.

File metadata

File hashes

Hashes for civic_data_boundaries_us_cd118-0.0.4.dev0.tar.gz
Algorithm Hash digest
SHA256 5f08d94881e886c11e61c65870fd5e5171ec3bbff8bfcc3768afe4487ad4a9de
MD5 68633f1b8ad01187bc37bc528124846a
BLAKE2b-256 68e881c7203c95e2cfdc8606eb507478d60d6cfc280ddc30c6c2431211a14b83

See more details on using hashes here.

Provenance

The following attestation bundles were made for civic_data_boundaries_us_cd118-0.0.4.dev0.tar.gz:

Publisher: release.yml on civic-interconnect/civic-data-boundaries-us-cd118

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file civic_data_boundaries_us_cd118-0.0.4.dev0-py3-none-any.whl.

File metadata

File hashes

Hashes for civic_data_boundaries_us_cd118-0.0.4.dev0-py3-none-any.whl
Algorithm Hash digest
SHA256 9dffe71c81df0a7f956942d27786ff0833f3a26dc0b447c6c87292f4ab943e8a
MD5 422eb255e59fd55d897bcfe282a47a5b
BLAKE2b-256 17ce8d55e434772f8a321a9aded67c43d0e9b997ec4b7b29ddfbe7fce21a475c

See more details on using hashes here.

Provenance

The following attestation bundles were made for civic_data_boundaries_us_cd118-0.0.4.dev0-py3-none-any.whl:

Publisher: release.yml on civic-interconnect/civic-data-boundaries-us-cd118

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.0.4.dev0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page