Rasta (rāstā) is a Python based library specifically design to handle geospatial data especially in the context of navigation. Currently, one can use rasta to parse/process/visualize GPX, GTFS, GEOJSON data. In addition, there are modules to use REST API from HERE and OpenTripPlanner for the navigation.

• Parse gpx file and convert them to pandas dataframe in a single line of code. Finally able to visualize the tracks with kepler.gl based interactive map.
• Parse GTFS feed and visualize the network.
• Navigate with HERE Maps or OpenTripPlanned by using their respective REST APIs.

Directly install from PyPI:

pip install rasta

As a forked version of a dependecy is being used, please install it separately as follow:

pip install git+https://github.com/ikespand/keplergl_cli

Alternatively, clone this repo and install:

git clone https://github.com/ikespand/rasta.git
cd rasta
python setup.py install
pip install git+https://github.com/ikespand/keplergl_cli

To visualize data with the kepler.gl, user needs to have Mapbox API key which provides the tiles. Go to Mapbox.com to get an API key.

There are many examples available in the example folder. Additionally, code is documented with docstrings.

gpx_bicycle_tracks.py and gpx_dmrc_yellow_line.py show the usage of rasta.gpx for parsing gpx file along with some data processing. For any generic GPX file:

from rasta.gpx import GpxParser
# Load the gpx file (if timestamp is available then also calculate speed)
gpx_instance = GpxParser("../tracks/BicyleRoute.gpx", calculate_distance=True)
# Extract our data in a dataframe
df = gpx_instance.data
# Visaulize the tracks (You will need Mapbox API key for this step)
html_path, vis = gpx_instance.visualize_route(MAPBOX_API_KEY=MAPBOX_API_KEY,open_browser=True)

gtfs_sample_london.py is to have the visalization of GTFS feed from a given zip file. For a generic GTFS feed:

from rasta.gtfs import Gtfs
# Parse our GTFS feed
my_gtfs = Gtfs("../tracks/gtfs_london.zip")
# Visaulize the routes (You will need Mapbox API key for this step)
my_gtfs.visualize_route(MAPBOX_API_KEY, "london_")

otp_visualize_from_rest.py is for OpenTripPlanner's REST api. Let's say OTP server is ruuning then one could use:

from navigate_with_otp import GetOtpRoute
import pandas as pd
import numpy as np
# Pass arguments for our query along with parameters for visulization
my_otp_nav = GetOtpRoute(start_coord="28.658420, 77.230757", end_coord="28.544442, 77.206334", MAPBOX_API_KEY=MAPBOX_API_KEY, output_map_path="temporary_map_", viz=False)
my_otp_nav.address
gdf, html_path = my_otp_nav.extract_itinerary()

• With keplergl v0.2.1 auto-centering for map data is not working. Therefore, if you face this issue then consider to downgrade to v0.2.0.
• Sometime, the issue of geopandas, fiona and GDAL appears due to some inter-dependencies. To mitigate it, simply uninstall all 3 and use conda forge to install geopandas.
• Here, we use a custom version of kepler_cli than that available via pip. The setup.py file is already configured for that. In any case, if you have any error due to keplergl_cli then please consider reinstalling as:

pip install git+https://github.com/ikespand/keplergl_cli

• If you are new to OTP, then try using docker solution which is documented here.

• Support for OpenStreetMap data coming from overpy
• GTFS validator
• More tests
• Extend documentation

Developed at: