Utility library for performing reverse geocoding of states in the United States of America
Project description
these-united-states
A Python library for performing reverse geocoding of the United States of America.
Overview
These-united-states provides a simple, class-based interface to shapefiles from the United States Census Bureau defining boundaries of U.S. states and territories. States may be queried via full state name, abbreviation, or by coordinates (latitude/longitude pairs). State objects contain some metadata, including the bounding box, area, and polygons defining the state's boundaries.
Example
>>> import united_states
>>> us = united_states.UnitedStates()
>>> us.from_coords(29.881888, -82.726846)
[State(abbr='FL', name='Florida', bbox=BBox(left=-87.634896, bottom=24.396307999999998, right=-79.974306, top=31.000968))]
>>> us.by_abbr['WA']
State(abbr='WA', name='Washington', bbox=BBox(left=-124.848974, bottom=45.543541, right=-116.916071, top=49.002435999999996))
>>> us.by_name['Alaska']
State(abbr='AK', name='Alaska', bbox=BBox(left=-179.231086, bottom=51.175092, right=179.859681, top=71.439786))
Command-line interface
These-united-states is also usable from the command-line, with the appropriate extras installed.
$ pip install "these-united-states[cli,plot]"
$ python -m united_states 29.881888,-82.726846
(29.881888, -82.726846) Florida
$ python -m united_states --help
Usage: united_states [OPTIONS] [POINT]...
Lookup U.S. states by coordinate (reverse geocoding).
Options:
-b, --bbox / --no-bbox Print state bounding boxes in listing
(implies -l/--list).
-d, --dc / --no-dc Include the District of Columbia.
-x, --exclude TEXT Exclude states by abbreviation or name.
-h, --help Show this message and exit.
-i, --include TEXT Include states by abbreviation or name.
-l, --list / --no-list List included states.
-o, --oconus / --no-oconus Include states outside the continental U.S.
-p, --plot / --no-plot Plot the results (requires matplotlib).
-s, --seed FLOAT Seed random number generator for color plot
selection.
-t, --territories / --no-territories
Include U.S. territories.
Options may be given multiple times. Options taking arguments are
additive. Multiple abbreviations or names may be provided in a single
option using a comma-separated list.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for these-united-states-1.0.0.19.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d6ad7c254b580ce079531e2d729d87dbe5f4643716efe687bf6fb4b1d3a361b2 |
|
MD5 | 24f7329cb732082e67652b6268c9f4dd |
|
BLAKE2b-256 | 388e95d92286c384d6e50436852734d04199d36fa05ed1d6ec84053a01a70e8b |
Hashes for these_united_states-1.0.0.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ee01b04d29bfd2f8210b6bb86496f2894ac31dd92f7d089bc064301ff953ca8 |
|
MD5 | ccb4c44ed8df505382c90531a8e14712 |
|
BLAKE2b-256 | eab9452c3b6866819dd6fadea124aa1b4174e1621e8c856d8ab7ff85fb9e7c9a |