Itineraries

Itineraries provide the ability to record information about a specific trip, together with useful waypoints and routes. You may also wish to show and share previous track logs that relate to the trip or add track logs after the trip for future reference.

Additionally you can create and modify routes and waypoints. You can also modify track logs.

Although routes and tracks are quite similar in that they both can denote a path, they are treated a little differently by the system.

  • Routes are intended to be something that is planned. Therefore new ones can be created and points can be added to existing ones. Two or more routes can also be joined.

  • Tracks are intended to relate to points that have been visited. Each point must have a time related to it. Additionally, tracks can be split into multiple segments. Each segment represents a logical break in a track, which might be due to stopping and restarting a track or losing the GPS signal for a while. New points cannot be added to a track. However, points can be removed, tracks and their segments can be split and joined.

Itineraries are listed in descending start date order. Itineraries with no dates are listed in alphabetical order prior to those with dates.

You can only edit itineraries that you created yourself. You cannot edit itineraries shared with you by others.

Itinerary Notes

To create a new itinerary, select Itineraries from the main menu and click the New button.

When you first create an itinerary, you must give it a title and can optionally enter start and end dates together with some descriptive text.

The text is interpreted following the syntax of Markdown as created by John Gruber. Markdown is a wonderful way of being able to write markup in a format that is very presentable in its original text form and also efficiently displayed as formatted HTML on the web. As you enter the Markdown text, the HTML representation is shown below the editable text area.

Click the question mark icon at the top right hand side of the edit area for help on the Markdown syntax. Clicking on the other edit area icons provide shortcuts for common formatting syntax. Unfortunately the Markdown editor used by the application is not a perfect implementation of the Markdown standards but is usefully close.

Live Map

One or more live tracks can be viewed on an itinerary map. From the itinerary page, optionally select any routes, waypoints and tracks and click the Show map button.

To position the map based on the current location as reported by your browser, optionally select Request high accuracy location, then click the My position button. Click the Drop marker button to drop a marker on the map centre. The marker is added to the list of itinerary waypoints.

To see live track logs on the map, select the Enable live map option displayed underneath the map. A list of users who are sharing their tracks with you are displayed, including yourself. You can modify the start range date and time for displaying locations and also filter the reported locations to only include those less than a maximum HDOP value. Click the Apply live map settings to put your choices into effect.

Any track points meeting your selection criteria are displayed on the map. When new track points are received meeting the HDOP criteria, the map is updated. Click the Auto-centre on live update checkbox to have the map centre on new updates.

Sharing

Sharing of itineraries is treated quite separately to that of sharing tracks, although when viewing an itinerary map you can choose to see the track points shared by others even if you haven’t shared the itinerary with them. In fact this is the only place where you can view and monitor the progress of multiple users.

To access itinerary sharing, click the Sharing button beneath the itinerary’s details and description.

If you have not already shared the itinerary with anyone, you are prompted to enter the nickname of someone to share with. Enter their nickname, optionally choose to make the share active then click Save.

The list of shares is displayed. You can choose one or more of the shares and click Activate or Deactivate buttons to change their activation status. You can also choose to delete the share, although this has the same effect as simply deactivating the share, but additionally removes the nickname from the list.

GPX Upload

You can import waypoints, tracks and routes from a standard GPX file. Not all the possible attributes within the GPX file are supported, so keep the original if the contents might be important.

Importing GPX Files

Some sources of GPX files create waypoints for every point on a route which can make a mess of an existing itinerary resulting in a laborious cleanup operation. If you do not fully know the contents of a GPX file you wish to import, create a new itinerary for temporary purposes and import the file into the temporary itinerary. Check the contents and delete any elements from the itinerary that are not required. You can then use the copy-and-paste functionality to copy the desired contents to the ultimately intended itinerary.

Processing Delays

Uploading files into an itinerary happens as a background server operation. This can take some time, depending on the number of attributes being imported. Often, the itinerary page is displayed before the import has completed. Click the Refresh button to refresh the contents of the page until you are satisified the file upload and import has fully completed.

GPX and KML Downloads

Select one or more routes, tracks and waypoints, then click the GPX download or KML download buttons at the bottom of the itinerary page to download the chosen items in GPX or KML files respectively.

The GPX file format can be imported into many Geographic Information System (GIS) based applications. The KML file format is recognised by some GIS based applications, in particular Google Earth.

Download Full Itinerary

The full details of the itinerary, including the dates, text, sharing, routes, waypoints and tracks can be downloaded by selecting the Download Full Itinerary option from the Transfer menu of the Features tab on the Itinerary page. The downloaded file is in the YAML format, a text file format that can be readily understood by humans.

The YAML file can either be saved and used as a long-term backup or be imported into another instance of a TripServer application. The itinerary can be imported by clicking on the Import button on the itineraries page.

If you are creating a backup, it is a good idea to also select all the GIS attributes (routes, waypoints and tracks) and export them in the GPX format, as this is a common format that can be imported into many other applications.

Add Waypoint

Click the Add waypoint button at the bottom of the itinerary page to add a new waypoint to the route.

You must give the waypoint a name and position/location.

A variety of common formats are recognised when entering a position.

Position Recognition

To be sure that the intended format has been recognised correctly, it is recommended you select the appropriate source position from the Display position format selection list and check the output matches the expected values.

Tip

If you are having difficulty persuading the system to recognise a particular format, enter a simple comma separated latitude and longitude value appropriate for the region, then select the Display position format you wish to use. The formatting output below the select list will indicate a format you can enter values in. Values are case-significant.

Creating a New Route

Optionally select one or more waypoints, routes or tracks in the itinerary that will help to zoom the map into the intended area.

Click the Show map button at the bottom of the itinerary page. Pan and zoom to the desired area.

To start creating a new route, click on the new route icon at the top right of the page. The icon depicts two connected nodes.

Click on each position you want the route to follow. When you have finished entering all the points for the route, either click the Finish button adjacent to the new route icon of click on the last point of the route.

Touch Screen Devices

When creating routes with touch screen devices, after placing a point, the system often sees the click as also finishing the route, which normally happens when you click the last point of a new route. A new route is created, perhaps with only two points. In this event, select the option to edit the route (see below) and continue by moving the last point to the ultimate destination and filling in the intervening points by creating new points in between the existing ones.

Additionally, the buttons adjacent to the new route icon are not recognised whilst creating a new route. In this event, click on the last placed route point to terminate creating a new route.

When you view the itinerary page all the new routes are at at the end of the list of routes and are unnamed having only an ID. To edit the route’s attributes, select the route in the itinerary page and click the Edit attributes button.

Creating Waypoints using the Map

In addition to being able to create routes on the itinerary map, you can add waypoints by clicking the new waypoint icon at the top right of the page. The icon looks like a place-marker, a circle with a point underneath. Click on the map at the location you wish to create a waypoint. A new anonymous waypoint is created.

When you view the itinerary page all the new waypoints are at at the end of the list of waypoints and are unnamed having only an ID. To edit the waypoint’s attributes, select the waypoint in the itinerary page and click the Edit attributes button.

Amending Routes

To amend a route, select it in the itinerary page then click Show map at the bottom of the itinerary page. To commence editing the routes on the itinerary map, click the edit icon at the top right hand side of the map. The icon represents a pencil inside a square.

Existing points can be dragged to a new location. A feint square is displayed between each existing route point. To create a new point in between the existing points, drag the feint square to a new position.

Click the Save button adjacent to the edit icon at the top right hand side of the map.

Copying and Renaming Routes and Tracks

Route and track names and colours can be amended by selecting the route or track in the itinerary page and clicking the Edit attributes button at the bottom of the itinerary page.

To create a copy of a route, click the Save as copy checkbox. Optionally select the Reverse route checkbox which will create a copy of the route in its reverse direction.

Copying Tracks

Tracks cannot be copied with this option, but another way to make copies of waypoints, tracks and routes is to select them in the itinerary list, click the Copy button, then click the Paste button.

Copying and Pasting between Itineraries

Select the waypoint, routes and tracks in the itinerary list to be copied, click the Copy button at the bottom of the itinerary page. Navigate to the target itinerary, then click the Paste button.

Copy and Paste

The copy and paste operations must be performed in the same browser window.

The copy operation does not copy the entire detail of the items being copied, instead just copying a reference to them together with any criteria used to select them. Should the results change in between the copy and paste operation, different values may be pasted from those displayed at the time the copy was initiated.

Moving Waypoints

To move a waypoint to a different position, select it in the itinerary page then click Show map at the bottom of the itinerary page. To commence editing the routes on the itinerary map, click the edit icon at the top right hand side of the map. The icon represents a pencil inside a square.

All waypoints on the map are depicted with a surrounding red dotted square. Drag the waypoint to the new location and click the Save button adjacent to the edit icon at the top right hand side of the map.

Tip

Multiple routes and waypoints can be selected for editing on the map in a single session.

You can also select tracks to be displayed on the map whilst editing routes and waypoints, but you cannot modify the tracks interactively on the map.

Joining Routes and Tracks

Two different itinerary routes or itinerary tracks can be joined together to create a single route or track. Tracks cannot be joined to routes and vice versa. To simply the instructions, both routes and tracks are referred to as paths in these instructions.

Select all the paths to be joined and click the Join paths button at the bottom of the itinerary page.

Tip

To make it easier to visualise the different paths, give them each a different colour before attempting to join them.

A map is displayed showing each of the paths in their individual colours.

Use the Up and Down buttons to reorder the paths into the desired order.

To help visualise how the paths will be joined, click the Show joined routes button below the map.

Once satisfied with your choices, optionally edit the new path name and select a colour. Then click the Save button to make a copy of the combined paths.

Editing Tracks

Tracks can be edited by;

  • splitting track segments
  • splitting the track between segments to form two tracks
  • deleting individual points

Select the track to be edited by clicking the Edit path button at the bottom of the itinerary page.

Split Track

If a track has multiple segments, selecting a segment and clicking the Split track button splits the existing track into two. The selected and following segments are moved from the current track to a new one.

Split Segment

Click on the segment ID to display the track segment points.

Clicking on the checkbox in the table header above the list of segments, selects all segments and displays them on the map below.

If there are more than 10 track segment points, you can page forwards and backwards through them.

Tip

Whether the checkbox in the table header was selected when you navigate to a new page is remembered. Therefore, selecting the checkbox and navigating through the pages allows you to quickly review a track segment.

To split a segment into two, select a single track segment checkbox and click the Split segment button. The selected track segment point and all subsequent ones in the same segment are moved from the current segment into a new following segment.

Tip

To split a track at a particular track segment point, split the track in two operations. Firstly split the track segment at that track segment point, then secondly split the track at the new track segment.

Editing Route Points

In addition to being able to edit routes on the itinerary map, you can perform some operations using the Edit path button at the bottom of the itinerary page which cannot be easily accomplished on the map. E.g. Splitting the route. Sometimes it can also be difficult to select and delete points on the map when they are very close together, so navigating through the points in the Edit path mode provides another method to identify and delete them.

Editing routes is very similar to editing tracks as described above.

Duplicating the itinerary

The Create duplicate itinerary option on the Edit menu of the Features tab of the Itinerary page creates a duplicate of the current itinerary. The new itinerary is displayed once it has been created.

Assigning Colours to Routes and Tracks

This option is intended to make it easy to quickly give routes and tracks different colours, to more easily identify them on the map.

Select select the routes and tracks you wish to convert and choose the Assign colours to routes and tracks from the Edit menu of the Features tab. After confirmation each colour defined on the system is assigned to each route then each track in sequence. If there are more tracks and routes selected than there are colours, the colours are repeated from the beginning again.

Convert Tracks to Routes

To create routes from tracks, select the tracks you wish to convert and choose the Convert tracks to routes from the Edit menu of the Features tab. After confirmation, a copy of each track is created and will be shown under the Routes section after a short delay, depending on the number of points in the tracks.

There is not an option to convert routes to tracks. Tracks are a reflection of an actual journey, with timestamps for each point, so it is not envisaged that there would be a need for this functionality. However, feedback is welcome, should you do find a need for it.

Simplify Track

Sometimes, a track log has a high frequency of points. You might wish to reduce the number of points, (simplifying the path), perhaps before converting it to a route, or just make it smaller to fit the maximum point constraint of some software.

Trip uses the simplify-js library by Vladimir Agafonkin which uses a combination of the Ramer–Douglas–Peucker and Radial Distance algorithms.

Select a single track, then choose the Simplify track option from the Edit menu of the Features tab.

The selected track is displayed on a map. A slider control is used to change the tolerance value. The higher the tolerance value is, the more likely points are reduced.

The display shows the total number of points originally in the track together with the total number of points that remain, after applying the tolerance factor. The original track is shown translucent, in the same colour, so that you can judge the impact of the simplification.

The High quality option excludes the distance-based preprocessing step which provides a higher quality simplification. If the track has a considerable number of points, turning this option off should speed up the re-drawing of the path.

Where a track has multiple segments, there is a Show joined track segments option to choose whether to show the segments individually, or as one continuous track.

The first and last point of each segment are always retained. If that behaviour is undesired, consider joining the segments before-hand, as described in the ‘Joining Routes and Tracks’ section above.

Selecting the Save button saves a copy of the track, appending (simplified) to the track name.

Miscellaneous

Route and Track Direction

The direction of routes and tracks is not shown on the map. As a workaround, use the Edit path option and the Select all checkbox on the first page to see where the route starts. Paging through the route remembers that Select all was chosen and you can quickly navigate the route to determine its direction.