SharedStreets (Python)

Python implementation of SharedStreets Reference System.

Install

Install from PyPI with Pip.
```
pip install sharedstreets
```

Try downloading a single tile to GeoJSON.

sharedstreets-get-tile 16 10509 25324 > 16-10509-25324.geojson

Use

Retrieve a tile and convert to GeoJSON in Python.

import sharedstreets.tile
tile = sharedstreets.tile.get_tile(16, 10508, 25324)
geojson = sharedstreets.tile.make_geojson(tile)

Install optional webserver to serve GeoJSON tiles.
```
pip install 'sharedstreets[webserver]'
```
Run a debug webserver and request a tile at /tile/16/10508/25324.geojson.
```
sharedstreets-debug-webapp
```
Run a production webserver under Gunicorn.
```
gunicorn sharedstreets.webapp:app
```
Install optional Geopandas to use read tabular excerpts of SharedStreets data.
```
pip install 'sharedstreets[dataframe]'
```

Read a small area of SharedStreets data into a pair of Geopandas dataframes.

import sharedstreets.dataframe
frames = sharedstreets.dataframe.get_bbox(-122.2820, 37.7946, -122.2480, 37.8133)
geometries, intersections = frames.geometries, frames.intersections

Develop

Install for local development.

Clone the SharedStreets-Python git repository and prepare a Python virtual environment running Python 3.
Install the sharedstreets module, keeping it editable, and run test suite.
```
pip install --editable .
python setup.py test
```

Protobufs

Current .proto files can can be found at sharedstreets/sharedstreets-ref-system.

Install protoc and follow Python directions to regenerate sharedstreets/sharedstreets_pb2.py if necessary:

protoc -I=sharedstreets-ref-system/proto/ \
    --python_out=sharedstreets/ \
    sharedstreets-ref-system/proto/sharedstreets.proto

sharedstreets/sharedstreets-python

SharedStreets (Python)

Install

Use

Develop

Protobufs