The School District Locator is a Python tool designed to map any given street address in the United States to its corresponding school district. Utilizing the U.S. Census Bureau Geocoding Services API for address geocoding and GeoPandas for spatial analysis with school district shapefiles, this tool provides a quick and accurate lookup for determining the school district of a particular address.
- Address to school district mapping
- Utilizes U.S. Census Bureau Geocoding Services for precise address location
- Spatial analysis with GeoPandas for accurate district identification
- Supports Shapefile boundary file format
Ensure you have Python 3.6+ installed on your system.
Clone the repository to your local machine:
git clone https://github.com/steelcityamir/school-district-locator.gitNavigate to the cloned directory:
cd school-district-locatorInstall the required libraries using pip:
pip install -r requirements.txt- Go to https://data-nces.opendata.arcgis.com/datasets/nces::school-district-boundaries-current/about
- Click Download button to view file formats
- Look for the Shapefile and click Download
- This will download a zip file containing the shapefile and associated files
- Unzip the files into the repo directory
- Rename the files to:
school_district_boundaries.cpgschool_district_boundaries.dbfschool_district_boundaries.prjschool_district_boundaries.shpschool_district_boundaries.shxschool_district_boundaries.xml
Run the script from your command line:
python3 locator.pyFollow the on-screen prompts to input the street address, city, state, and ZIP code for the location you're interested in.
This project is licensed under the MIT License - see the LICENSE file for details.
- U.S. Census Bureau for providing the Geocoding Services API.
- National Center for Education Statistics (NECS) for providing school district data.
- The GeoPandas team for their excellent work on the geospatial analysis library.
For support, please open an issue in the GitHub issue tracker for this project.