Skip to main content

Easily download U.S. census maps

Project description

Easily download U.S. census maps


$ pipenv install census-map-downloader

Command line usage

Usage: censusmapdownloader [OPTIONS] COMMAND [ARGS]...

  Easily download U.S. census maps

  --data-dir TEXT  The folder where you want to download the data
  --year INTEGER   The vintage of data to download. By default it gets the
                   latest year. Not all data are available for every year.

  --help           Show this message and exit.

  blocks                   Download blocks
  congress-carto           Download cartographic congressional districts
  counties                 Download counties
  counties-carto           Download cartographic counties
  countysubdivision        Download cartographic county subdivisions
  legislative-lower-carto  Download cartographic state legislative...
  legislative-upper-carto  Download cartographic state legislative...
  places                   Download places
  states-carto             Download cartographic states
  tracts                   Download tracts
  zctas                    Download ZCTAs


Here’s an example of downloading all counties

$ censusmapdownloader counties

You can specify the download directory with –data-dir

$ censusmapdownloader --data-dir ./my-special-folder/ counties


Install dependencies for development

$ pipenv install --dev

Run tests

$ make test

Ship new version to PyPI

$ make ship

Adding additional years to a dataset

Downloader classes for different geography types are defined in modules of census_map_downloader.geotypes. For example, the downloader for counties is census_map_downloader.geotypes.counties.CountiesDownloader.

If the URL and fields in a shapefile are the same as those for years that are already supported, you can just add the year to the YEAR_LIST attribute.

If the fields are the same, but the URL changes between groups of years, add logic to the url property method of the downloader classes to alter the URL based on self.year.

If the fields and URL change from year to year, consider creating classes for each year and delegating to census_map_downloader.geotypes.tracts.TractsDownloader is an example of a class that uses this approach.

Developing the CLI

The command-line interface is implemented using Click and setuptools. To install it locally for development inside your virtual environment, run the following installation command, as prescribed by the Click documentation.

$ pip install --editable .

Project details

Download files

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

Source Distribution

census-map-downloader-0.1.0.tar.gz (10.5 kB view hashes)

Uploaded Source

Built Distribution

census_map_downloader-0.1.0-py2.py3-none-any.whl (17.1 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page