SYSTEM MANUAL

Chicago Run 3611 N. Kedzie Chicago, IL 60618 info@chicagorun.org

Chicago Run Virtual Marathon System Manual

TABLE OF CONTENTS
SECTION
About Virtual Maps Landmark Management Adding a Landmark Editing a Landmark Removing a Landmark Route Management Creating a New Route Uploading a New Route Changing Default Route Order Incentive Management Adding a Landmark Editing a Landmark Removing a Landmark

PAGE
1 2 3
5 6 7

8
9 15 17

19
21 22 22

Chicago Run Virtual Marathon System Manual

Chicago Run Virtual Marathon System Manual

About:
The Chicago run Virtual Marathon uses the existing Chicago Run system as its basis. The existing system is located at http://database.chicagorun.org The Virtual Marathon uses an updated version of this system to function. Any details related to the original system, as well as changes not covered in this document, can be found at http://code.google.com/p/chicagorun/

Chicago Run Virtual Marathon System Manual

Page 1

Chicago Run Virtual Marathon System Manual

VIRTUAL MAPS:
The Virtual Marathon system uses the Google Maps API to create a virtual map that displays runner locations. The location of the runner is based on how many miles they have run and is taken from the database. The map also displays Landmarks, Incentives, and one of four initial routes.

Details on the program functionality of the Google Maps API can be found at http://code.google.com/apis/maps/.

The maps displayed by the Virtual Run program can be viewed two ways: Group Map: o Displays all runners, Incentives, Landmarks, and the route that belongs to the runner group. Individual Runner Map: o Displays one runner, his or her route, nearby Landmarks, and Incentives.

For more information on the maps, please refer to the Student User Manual.

Chicago Run Virtual Marathon System Manual

Page 2

Chicago Run Virtual Marathon System Manual

LANDMARK MANAGEMENT:
Landmarks used in the Virtual Run program are stored in the database. The Virtual Marathon System has a user interface that allows easy adding, changing, or removal of landmarks. 1. Login to the Virtual Marathon System as an Administrator 2. Click Landmarks in the menu bar.

Chicago Run Virtual Marathon System Manual

Page 3

Chicago Run Virtual Marathon System Manual

3. The landmarks stored in the database will be displayed.

4. Click on the icon to display details about the landmark.

Chicago Run Virtual Marathon System Manual

Page 4

Chicago Run Virtual Marathon System Manual ADDING A LANDMARK:

1. Click Add New in the upper right of the Landmarks page

2. Enter Name and Description 3. Move the map marker to the desired location 4. Click Browse and select the landmark picture. 5. Click Save changes

Chicago Run Virtual Marathon System Manual

Page 5

Chicago Run Virtual Marathon System Manual EDITING A LANDMARK:

1. Select the landmark you would like to edit

2. Click Edit in the pop-up window 3. Edit information as described in ADDING A LANDMARK

Chicago Run Virtual Marathon System Manual

Page 6

Chicago Run Virtual Marathon System Manual REMOVING A LANDMARK:

1. Select the landmark you would like to remove

2. Click Delete in the pop-up window 3. Click Ok in the confirmation pop-up window

Chicago Run Virtual Marathon System Manual

Page 7

Chicago Run Virtual Marathon System Manual

ROUTE MANAGEMENT:
Routes used in the Virtual Run program are displayed by .kml files. These .kml files are created using Google Earth. The important information contained in a .kml file can be viewed in a text editor (Notepad, WordPad, or Microsoft Office). The information for the Virtual Marathon program is a sequence of latitude and longitude coordinates located near the bottom of the file. If the .kml file does not contain the proper format of these coordinates, then it will not be compatible with the Virtual Run program. Each pair of coordinates is one point on the route, and the entire route consists of lines drawn from one point to the next.

Chicago Run Virtual Marathon System Manual

Page 8

Chicago Run Virtual Marathon System Manual CREATING A NEW ROUTE:

Creating a new route requires Google Earth. The program can be downloaded at http://earth.google.com/ 1. Center the map in the general area where you would like to draw your route. 2. Click Add Path at the top of the screen.

Chicago Run Virtual Marathon System Manual

Page 9

Chicago Run Virtual Marathon System Manual

3. The Properties page for the new route will be displayed.

4. Enter the Name and Description of the new route. Do not close this window until you have completed the route.

Chicago Run Virtual Marathon System Manual

Page 10

Chicago Run Virtual Marathon System Manual

5. Move the Properties window off of the map, but do not close it.

6. Move your mouse onto the map.

7. Left-click on the map to create a point on the route.

8. When you create a point, it will be displayed as a small, colored box on the map.

9. Once you add a second point, a line will be drawn connecting the two points.

10.Create points so that the line shows the path of your route.

11.To remove a point, left-click on the point box to select it; then rightclick the mouse once.

12.To reposition a point, simply left-click on the point box, hold the button down, and drag it around the map.

Chicago Run Virtual Marathon System Manual

Page 11

Chicago Run Virtual Marathon System Manual

13.This map shows the route in white.

Chicago Run Virtual Marathon System Manual

Page 12

Chicago Run Virtual Marathon System Manual

14.When you have finished your route, return to the Properties window 15.Click the Ok button at the bottom and the route will be saved as a Google Earth Path. 16.The path will appear in My Places on the left.

Chicago Run Virtual Marathon System Manual

Page 13

Chicago Run Virtual Marathon System Manual

1. Right-click on the name of your path and click Save Place As...

18.Select .kml from the Save as type menu.

19.Enter the route name and click Save

Chicago Run Virtual Marathon System Manual Page 14

Chicago Run Virtual Marathon System Manual UPLOADING A NEW ROUTE:

1. Login to the Virtual Marathon System as an Administrator 2. Click Routes in the menu bar.

3. Click Add New Route

Chicago Run Virtual Marathon System Manual Page 15

Chicago Run Virtual Marathon System Manual

4. Enter Name and Description 5. Click Browse and select the .kml file you created. 6. Click Create

Chicago Run Virtual Marathon System Manual

Page 16

Chicago Run Virtual Marathon System Manual CHANGING THE DEFAULT ROUTE ORDER:
1. Login to the Virtual Marathon System as an Administrator 2. Click Routes in the menu bar.

3. Click Change Default Route Order

Chicago Run Virtual Marathon System Manual

Page 17

Chicago Run Virtual Marathon System Manual

4. Left-click on a route and drag it up or down to change the default order. This will change the route order for ALL Chicago Run users. 5. Click Save Order

Chicago Run Virtual Marathon System Manual

Page 18

Chicago Run Virtual Marathon System Manual

INCENTIVE MANAGEMENT:
Incentives used in the Virtual Run program are stored in the database. The Virtual Marathon System has a user interface that allows easy adding, changing, or removal of incentives. 1. Login to the Virtual Marathon System as an Administrator 2. Click Incentives in the menu bar.

Chicago Run Virtual Marathon System Manual

Page 19

Chicago Run Virtual Marathon System Manual

3. The incentives stored in the database will be displayed.

Chicago Run Virtual Marathon System Manual

Page 20

Chicago Run Virtual Marathon System Manual ADDING AN INCENTIVE:

1. Click Add new incentive in the bottom of the Incentives page

2. 3. 4. 5. 6.

Select Basic Package from the Package menu Enter Goal in miles Enter a description in Reward Click Browse and select the incentive picture. Click Create

Chicago Run Virtual Marathon System Manual

Page 21

Chicago Run Virtual Marathon System Manual EDITING AN INCENTIVE:

1. Click the pencil next to the incentive you would like to edit

2. Edit information 3. Click Update

REMOVING AN INCENTIVE:
1. Click the red X next to the incentive you would like to remove 2. Click Ok
Chicago Run Virtual Marathon System Manual Page 22