seattlepark

Finding parking in the Seattle area can sometimes be an arduous task. Free street parking is difficult to find, can be on narrow streets, and time-limited in residential zones often to 2 hours. Paid street parking is often just as difficult to find.

Our solution is an interactive API using the Seattle Annual Parking Study, which records street parking usage at various times of day on streets throughout the city to create a suggestion for most-likely-available streets to park in based on a user’s inputted destination.

License

The MIT License is a permissive free software license originating at the Massachusetts Institute of Technology (MIT). As a permissive license, it puts only very limited restriction on reuse and has therefore an excellent license compatibility. For more info please see: MIT license.

Project Organization

The project structure is as follows:

.
├── ./LICENSE
├── ./README.md
├── ./requirements.txt
├── ./seattlepark
│   ├── ./seattlepark/__init__.py
│   ├── ./seattlepark/src
│   │   ├── ./seattlepark/src/__init__.py
│   │   ├── ./seattlepark/src/coordinates_util.py
│   │   ├── ./seattlepark/src/parking_app.py
│   │   ├── ./seattlepark/src/parking_recommender.py
│   │   ├── ./seattlepark/src/parking_spot.py
│   │   └── ./seattlepark/src/resources
│   │       ├── ./seattlepark/src/resources/Annual_Parking_Study_Data_Cleaned2.csv
│   │       ├── ./seattlepark/src/resources/Midpoints_and_LineCoords.json
│   │       ├── ./seattlepark/src/resources/google_map_api.key
│   │       └── ./seattlepark/src/resources/mapbox_token
│   └── ./seattlepark/tests
│       ├── ./seattlepark/tests/__init__.py
│       ├── ./seattlepark/tests/data
│       │   ├── ./seattlepark/tests/data/Annual_Parking_Study_Data_Cleaned2.csv
│       │   └── ./seattlepark/tests/data/test_key.key
│       ├── ./seattlepark/tests/test_coordinates_util.py
│       ├── ./seattlepark/tests/test_parking_app.py
│       ├── ./seattlepark/tests/test_parking_recommender.py
│       └── ./seattlepark/tests/test_parking_spot.py
└── ./setup.py

Installation

To install seattlepark package, open terminal/command prompt and cd into local git repo and clone the package to your computer using the following command:

git clone https://github.com/anushnap/seattlepark

Next, install the package using the following command:

cd seattlepark/
python setup.py install

Then set up your development environment using the following command:

pip install -r requirements.txt

Note for users after March 21, 2021

The API key that is currently encoded in this repository will be deactivated after March 21, 2021. New users will need to create their own API key, encode it, and paste it in to ./seattlepark/src/resources/google_maps_api.key .

Once all dependencies are installed, open and run the python file "parking_app.py" in the src directory:

python seattlepark/src/parking_app.py

You should get output that looks similar to this:

 * Debug mode: off
 * Running on http://127.0.0.1:8050/ (Press CTRL+C to quit)

Copy and paste the link into your browser to interact with the API.

Using the seattlepark app

Once you have the app set up and running, you're ready to take advantage of its functions.

• Enter a Seattle street address and enter the distance you're willing to walk from your parking location to your destination.
  • Ex: 400 Broad St, Seattle, WA 98109 (Space Needle), or 4000 15th Ave NE, Seattle, WA 98195 (Suzzallo Library)
• The map will update with a dot to indicate the destination along with lines to indicate potential streets to park.
• Hover over the lines to see the average available parking spaces on that street around the time that you are accessing the API. Happy parking!

Try out the Web Application @ https://seattleparkingapp.herokuapp.com/ !