Skip to content

GTFS Shape Editor Django app, draw and manage shapes using this app in your website.

License

Notifications You must be signed in to change notification settings

jeancahu/GTFS_shapes_editor_JS

Repository files navigation

GTFS Shape Editor Django-App

Webapp which uses Vue, OpenLayers/OpenStreetMap, sweetalert2 and Bootstrap. Editor shows a map where you can draw and route shapes, place stops and edit the properties in the tables just below.

Install

pip install shapeeditor

Add the app 'shapeeditor' in your Django project settings file

INSTALLED_APPS = [
    ...
    'shapeeditor',
    ...
]

Shapeeditor needs authentication to push data to database, define the LOGIN_URL variable to know where redirect visitor when they are not logged.

LOGIN_URL='/admin/login/'

# First point map extent area [longitude, latitude]
#       +++++++++
#       +       +
#       +  Map  +
#       +       +
# --->  @++++++++

# Second point map extent area [longitude, latitude]
# ++++++++@ <---
# +       +
# +  Map  +
# +       +
# +++++++++

SHAPEEDITOR_MAP_EXTENT_AREA = [
    [-84.43669241118701, 9.726525930153954],
    [-83.72894500499169, 9.99625455768836]]

# Center by default on load [longitude, latitude]
SHAPEEDITOR_MAP_CENTER = [-84.1027104, 9.865107]

# Router service for shape generation request (This one is a free demo)
SHAPEEDITOR_ROUTING_MACHINE_URL = "http://router.project-osrm.org/route/v1/driving/"

Include Shapeeditor urls in urls.py, then we can open the editor from the site, draw the shape and download as a shapes.txt or import it to the database.

urlpatterns = [
    path('shapeeditor/', include('shapeeditor.urls')),
]

Just to be sure database is ok run the next commands.

./manage.py makemigrations
./manage.py migrate

Usage

./manage.py runserver localhost:8080

## Open the editor in your favorite browser
firefox localhost:8080/shapeeditor

Map interface allows the user to draw a shape, cut links and delete links and nodes, to create a shape you need to define two endpoints then put waypoints between the begin and end, more waypoints means better aproximation.

Most of the features are already implemented in JS but there is not a GUI equivalent to call for methods yet.

Shapes are made with nodes, nodes have a type, it could be endpoint for start or end of shapes, stops, these can be part of the shape too, fork are the nodes where are more than two links, waypoint are the common nodes. To create a Shape first draw paths clicking on map with the interaction add_node, when you already have a connection between two endpoints through multiple nodes and links add a Shape in the section below, once added the shape pick the waypoints with select_node + Shift, when you pick a waypoint and it is in a shape segment, the whole segment is selected, pick only waypoints their segments are in the shape.

Pick waypoints from the start node to the final node, keep the waypoints in order to avoid backward motion, when you pick a waypoint the section>accordion for the shape we are adding the waypoints will show the waypoints list, when the the waypoints are enough click on save button to write the shape, then push it to database.

Hide and show elements on map

hide_show_nodes_links.mp4

Add and delete nodes

add_delete_nodes.mp4

Remove and split links

remove_split_links.mp4

Uninstall

Just delete all the mentions in settings.py and remove the package from your Python libs

pip uninstall shapeeditor

How to contribute

PR are welcome.

Here some screenshots: