Skip to content

Functionality Overview

Jump to bottom Edit New page
Steven Ottens edited this page May 20, 2016 · 55 revisions

User Management

Three levels of users exist.

User: Users can view data within the Open Traffic UI, save and share routes, and export non-sensitive data via CSV.

Admin: Admins have all the rights of Users, however Admins can also view sensitive data via the CSV export. Specifically, Admins have the ability to view vehicle count data.

Super Admin: Super admins have all the rights of Admins, however, Super Admins can also add/edit/delete users.

To edit or delete users, login as a super admin and go to "View Users" from the Welcome menu.

To create new users, login as a supser admin and got o "Create Users" from the Welcome menu.

Login and Select your Country

The landing page for Open Traffic will prompt for a Username, Password, and City.

Select the specific city that you are studying will preload the map and traffic data for that city.

Planning a Route

After logging in, you are brought to the Routing tab.

To plot a route,

  1. Click once on the map to select an origin.

  2. Click a second time on the map to select a destination.

OpenTripPlanner is used determine the fastest route between these two points.

  1. Optional: Each additional click on the map will add an additional point to the end of the route.

After each point is placed the route is updated with the average speed for each segment and the traffic data for the additional segments are added to the bar chart.

Removing a point To remove a point, click it again. To remove the most recent point, click the undo arrow in the top-right of the map.

Reseting a route Click 'Reset Route' to erase all points and start planning a new route.

Planning a Route by Time of Day

By default, the route selected by OpenTripPlanner between two points uses traffic data from all available weeks along that segment.

However, it it may be useful to view routes for a specific day and hour.

To do this:

  1. Select 'Show Fastest Route by Day and Hour'

  2. On the Day and Hour picker, choose the day of the week and the specific hour that you wish to study.

After selecting the day and hour, you will be returned to the map and the route will be updated so that the route taken will use traffic data from the specific day and hour chosen.

The route chosen represents the fastest route between the selected points for a specific day and hour, however, you are still able to view traffic data for the segments along the route for all days and times.

Saving and Sharing Routes

Saving a Route

Once a route has been created, it is useful to be able to save this route for later study.

To save a route:

  1. Click 'Save Route'

  2. In the resulting pop-up, give the route a name.

To view saved routes:

  1. Click the User menu in the top-right of page.

  2. Select 'Saved Routes'

  3. Click any route in the list to reload it.

Delete a Route To delete a route, click the red trash symbol

Sharing a Route

Once a route has been created, it may be useful to share the route for others to study. Each route is represented by a URL. Anyone with the URL for a route can view it.

To find the URL for a route.

  1. Click 'Share Route'

  2. Copy the URL for your route from the pop-up.

  3. Email/text this url to anyone with a valid Open Traffic login.

Viewing Network Statistics

To view traffic statistics for an entire neighborhood, district, city, or region, use the Network tab.

On the network tab, traffic speeds are shown for all streets in the view window.

For large map areas, only major streets will be shown. For more detail on traffic statistics for smaller streets, zoom into a specific area.

Instructions for comparing times and filtering by hour, day, and week are shown below.

Comparision

In addition to viewing statistics for individual weeks, traffic statistics can be compared between multiple weeks.

To compare weeks.

  1. Create a new route on the Routing tab OR open the Network tab.

  2. Click the 'Compare' checkbox.

  3. Select the week or weeks to serve as the baseline.

  4. Select the week or weeks to serve as the comparison.

Now instead of showing traffic statistics, the graphs will show the change is speed for each day of the week or each hour of the day. For instance, if Monday has an average speed of 6kph for the baseline and an average speed of 7kph for the comparison week, Monday will show a 16.7% increase between the baseline and comparison weeks.

Confidence Interval The confidence interval tool is used to adjust the t-test. Statics for individuals segments are only compared if the data between the baseline and comparison weeks for that week pass a 2-sample t-test. Increasing the confidence interval increases the rigor of the test.

Normalize Time versus Normalize Vehicles Normalizing by vehicle will give more weight to a segment/hour that has more vehicles. Normalizing by time will weight each hour the same regardless of vehicle count.

Filtering Days and Weeks

For both the Routing and Network tabs, the data displayed can be filtered by day of week and hour of day.

  1. To enable filter, select "Enable Chart Filters"

  2. Click on hold your cursor on either the 'Speed by day of week' or 'Speed by hour of day' charts.

  3. Drag your cursor to display the chart filters and select the days and hours you wish to study.

Data Export

Data can be exported from either the Routing tab or the Network tab.

From the Routing tab:

  1. Create a route.

  2. Click the 'Export Data' button.

  3. A pop-up will prompt you to save a zip file. Name and and save the zip file.

The saved zip file will contain a shape file and a comma-separated data file. This shape file and data file contain traffic data for the the segment routed in step 1. Filters applied to the day or hour are taken into account. The first column of the data file contain a list of segment ids. Each of these ids corresponds to a segment in the shape file.

From the Network Tab

  1. Click the 'Export Data' button.

  2. A pop-up will prompt you to save a zip file. Name and and save the zip file.

The saved zip file will contain a shape file and a comma-separated data file. This shape file and data file contain traffic data for all road segments visible in the view window. Filters applied to the day or hour are taken into account. The first column of the data file contain a list of segment ids. Each of these ids corresponds to a segment in the shape file.

Comparison Mode: When in comparison mode the data file will include comparison statistics in addition to the individual traffic statistics for each time period being compared.

Internationalization

The content displayed in the right column can be displayed in a variety of languages. Use the date picker in the bottom right to select your language.

To add additional languages or update existing translations, make edits to the locale files found here.

New languages need to be added to the index.json

Branding

The logos for Grab, World Bank Group, and Korea Green Growth Partnership are stored in the source code here.

API Calls

Get Route Statistics

POST: http://BASE_URL/route

Payload (JSON):

Name Type Description
hour string used for routing at a specific time
day string used for routing at a specific time
confidenceInterval string sets t-test confidence interval
normalizeByTime boolean Normalize by time if true. Vehicle cont if false
compare boolean Is this a comparison request?
routePoints array Array of route points in the format [{"lat":LAT_1, "lng":LNG_1},{"lat":LAT_2, "lng":LNG_2}, ... , {"lat":LAT_N, "lng":LNG_N}]
w1 string Comma separated string array of week ids
w2 string Comma separated string array of week ids. w2 is only used for comparison calls
Response:
Name Type Description
pathEdges Array of JSON Path Edges Each edge includes: geometry hash, color, length, speed, stdDev, inferred.
weeklyStats 168 length Array. 1 entry for each hour in the week Each entry includes: index, speed, stdDeviation.

Get List of Weeks

GET: http://BASE_URL/weeks

Payload: none

Response:

Name Type Description
weekStartTime int Unix time of start of week.
weekId int week id

Get Network Tab Status

GET: http://BASE_URL/weeklyStats

Name Type Description
confidenceInterval string sets t-test confidence interval
normalizeByTime boolean Normalize by time if true. Vehicle cont if false
x1 float minimum longitude bounding box
x2 float maximum longitude bounding box
y1 float minimum latitude bounding box
y2 float maximum latitude bounding box
w1 string Comma separated string array of week ids
w2 string Comma separated string array of week ids. w2 is only used for comparison calls

example:

http://BASE_URL/weeklyStats?x1=106.805844&x2=106.8139986&y1=-6.1437399&y2=-6.1420598&confidenceInterval=95&normalizeByTime=false

Response:

Name Type Description
weeklyStats 168 length Array. 1 entry for each hour in the week Each entry includes: index, speed, stdDeviation.
Add a custom footer
Add a custom sidebar

Clone this wiki locally