Options: Waypoints


example of a waypoint with activated popup:


1. Show waypoints

If there are waypoints ("<wpt>" tags) in the track file, the plugin will show them on the track if you turn on this option.

parameter: wpshow 

values: 0 (off) or 1 (on)

Note: if you have Waypoint Popups enabled (see below), this setting will be ignored and waypoints will always be shown. 


2. Waypoint color

Color of the waypoint dots on the map

parameter: wpcolor

values: any valid HTML color value or constant (like #FFFFFF or white)


3. Waypoint size

Radius of the waypoint dots on the map

parameter: wpradius

values: any integer value in pixels, something between 2 and 5 makes most sense


4. Waypoint popups

If enabled, popups with information about the waypoints will be shown on the map if you hover over or click on a waypoint. (also see the note on Show Waypoints above.)

parameter: wppopups

values: 0 (off), 1 (show on hover) or 2 (show on click)


5. Show WPT altitude

If the waypoint contains altitude information ("<ele>" tag), it can be displayed in the popup. 

parameter: wppopupele

values: 0 (don't show), m (show in meters), ft (show in feet)


6. WPT timestamp format

 If the waypoint contains a timestamp, the popup can show it, formatted with this setting.

parameter: wppopuptimefmt

value: 0 (don't show timestamps) or a valid argument for the PHP strftime() function

Note: displaying these timestamps only makes sense when you have marked the waypoints with your GPS while you recorded the track. If you have added them afterwards with e.g. Garmin's BaseCamp, it will contain the timestamp when you added it, so it's of little use in the context of the track map display.


7. Show WPT description

If the waypoint contains an additional description ("<desc>" tag), its text content can be displayed in the popup. 

parameter: wppopupdesc

values: 0 (don't show), 1 (show)

Note: With e.g. BaseCamp you can edit the description of waypoints after you recorded the track, to put in some extra information (in text form) about the waypoint. Double-click the waypoint in BaseCamp to edit the description.


Some tools -like, again, BaseCamp- allow you to add web links to a waypoint. They don't go into the description text, however, but are stored separately (as "<link>" tags in the waypoint).

parameter: wppopuplinkfmt

values: either 0 (don't show links) or a text like "link #%N%"

Note: if you have stored two links in a waypoint, and set this parameter to "link #%N%", you will see an output like "link #1  link #2" in the popup. The "%N%" placeholder in the format parameter will be replaced by the running number of the link (in THIS waypoint), so you can reference them in the description.

Sadly, you can not (easily and safely) include links in the description of the waypoint. One way around this is to write something like "... (see link #1)" into the description and use the above format.


9. CSS styling of data in the popups

To allow custom styling of the data in the popups, each part has it's own CSS class. In detail, those are:

  • <span class="gpxwptname"> - for the waypoint name
  • <span class="gpxwptele"> - for the waypoint altitude (or elevation)
  • <span class="gpxwpttime"> - for the waypoint timestamp
  • <span class="gpxwptdesc"> - for the waypoint description
  • <span class="gpxwptlinks"> - for the waypoint links

This allows you to customize the appearance like i did in the example above by adding the following code to my template.css file:

.gpxwptele {
font-style: italic;
color: red;

 Note: it is also possible to style the appearance of the popup itself, but that's a part for the Openlayers API. The plugin uses the OpenLayers.Popup.FramedCloud class.