GPX Viewer

Popis

(Deutsche Übersetzung siehe unten)

Displays a GPX track with way points and its elevation profile. Open street map (OSM) is used as background.
The view can be changed to full screen mode. Moving the cursor over the elevation profile the corresponding point on the path is marked interactively.

GPX tracks uploaded in advance to the server are stored into separate repositories that are ordered according to the categories setup in wordpress.
This way different collections of tracks can be handled and the tracks choosen from.

During upload a GPX track can be smoothed and/or its elevation data replaced by MapQuest Service data.
The latter is provided because many elevation data tracked by mobiles are unusable.

Features

  • Admin page GPX Files for uploading tracks
    – Selecting category for repository
    – Replacing the description of the track (tag <name> in the GPX file)
    – Smoothing tracks during upload, thus reducing track points
    – Replacing elevation data of track points using MapQuest Service during upload (key necessary)
  • Display of a specific, uploaded GPX track
    – called by a PHP-function for inserting the view into a page
    – Selecting full screen mode and map size
  • Displaying a collection of GPX files (category) from which a track can be selected
    – Shortcode for inserting the list into a page
    – Setting width and color of the path
  • Elevation profile
    – Interactive path marker
    – Name of the track
    – Distance of the track
    – Maximum/minimum elevation
    – Elevation loss/gain
    – Trail duration
    _
    _
    _
    (German)

Der GPX-Viewer stellt einen GPX Track mit Wegepunkten und seinem Höhenprofil dar. Als Hintergrundkarte wird Open Street Map (OSM) verwendet.
Die Ansicht kann auf den vollen Bildschirm vergrößert werden. Bewegt man den Cursor über dem Höhenprofil, wird der entsprechende Punkt auf dem Pfad interaktiv markiert.

GPX Tracks, die zunächst zum Server hochgeladen werden, werden in getrennten Ablagen gespeichert. Diese Ablagen sind nach den Kategorien geordnet, die in WordPress eingerichtet sind.
Auf diese Weise können verschiedene Sammlungen von Tracks verwaltet und genutzt werden.

Während des Hochladens kann ein GPX Track geglättet werden bzw. seine Höhenangaben mit Hilfe des MapQuest Services ersetzt werden.
Letzteres ist vorgesehen, weil viele von mobilesn Geräten aufgezeichnete Höhendaten unbrauchbar sind.

Merkmale

  • Verwaltungsseite GPX-Dateien zum Hochladen von Tracks
    – Auswahl der Ablagekategorie
    – Ersetzung Track-Bezeichnung (Etiketts <name> in der GPX-Datei)
    – Glättung des Tracks während des Hochladens, um Trackpunkte zu reduzieren
    – Ersetzung der Höhendaten in den Trackpunkten mit Hilfe des MapQuest Services (key erforderlich) während des Hochladens
  • Anzeige eines bestimmten, hochgeladenen Tracks
    – aufgerufen über PHP-Funktion zum Einbetten der Ansicht in eine Web-Seite
    – Auswahl des Vollbildschirm-Modus und des Maßstabs
  • Anzeige einer Sammlung (Kategorie) von GPX-Dateien, aus der ein Track ausgewählt werden kann
    – Shortcode zum Einbetten der Liste in eine WordPress-Seite
    – Setzen von Farbe und Breite des Pfades
  • Höhenprofil
    – Interaktive Pfadmarkierung
    – Name des Tracks
    – Entfernung des Tracks
    – Maximale/minimale Höhe
    – Höhengewinn/-verlust
    – Dauer

Snímky obrazovky

  • Track selected from a file list

Instalace

(Deutsche Übersetzung siehe unten)

Installation and Settings:

  1. Upload the plugin files to the /wp-content/plugins/<my-plugin-name> directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the Plugins screen in WordPress
  3. Use the Settings->GPX Viewer screen to configure the plugin (MapQuest Key, Measure Units)

Uploading GPX files:

  • Goto GPX Files in the admin menu
  • Choose category for repository: Uploaded file will be stored in directory ~/wp-content/uploads/gpx/<mycategory>/.
  • Choose GPX file to upload
  • Optionally replace description of track (tag <name> in the GPX file)
  • Optionally smooth track during upload, i.e. reducing track points and smoothing elevation data
  • Optionally replace elevation data using MapQuest Service

Basic usage:

  • Calling the viewer for a specific GPX track:

    <?php 
        echo gpx_view(array('src'  => $filepath                $filepath = <absolute path>/wp-content/uploads/gpx/<mycategory>/<file>.gpx 
                        [, 'title' => $track_name]
                        [, 'color' => $track_color]
                        [, 'width' => $track_width] ));
    ?>
    
  • Shortcode to include the list of the GPX files for a given category into a WordPress-page. From this list a track can be selected and displayed.

    [gpx-view category="<mycategory>"]
    

    _
    _
    _
    (German)

Installation und Einstellungen:

  1. Entpackte Plugin-Datei in das Verzeichnis /wp-content/plugins/<my-plugin-name> hochladen oder direkt über die WordPress Plugins-Seite installieren
  2. Plugin über die Plugins-Seite in WordPress aktivieren
  3. In Einstellungen->GPX Viewer Plugin konfigurieren (MapQuest Key, Maßeinheiten)

Hochladen von GPX Dateien:

  • Im Verwaltungsmenu GPX Files aufrufen
  • Kategorie für die Ablage auswählen: Hochgeladene Datei wird im Verzeichnis ~/wp-content/uploads/gpx/<mycategory>/ abgelegt.
  • Hochzuladende GPX-Datei auswählen
  • Optional Beschreibung des Tracks ersetzen (Etikett <name> in der GPX-Datei)
  • Optional Track während des Hochladens glätten, d.h. Trackpunkte reduzieren und Höhendaten glätten
  • Optional Höhendaten mit Hilfe des MapQuest Service’s ersetzen

Anwendung:

  • Aufruf der Ansicht für einen bestimmten GPX-Track:

    <?php 
        echo gpx_view(array('src'  => $filepath                 <absolute path>/wp-content/uploads/gpx/<mycategory>/<track>.gpx
                        [, 'title' => $track_name]
                        [, 'color' => $track_color]
                        [, 'width' => $track_width] ));
    ?>
    
  • Shortcode zum Einbetten der GPX-Dateiliste einer bestimmten Kategorie in eine WordPress-Seite. Aus dieser Liste kann ein Track selektiert und angezeigt werden.

    [gpx-view category="<mycategory>"]
    

Autoři

GPX Viewer je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.

Spolupracovníci

Přeložte “GPX Viewer” do svého jazyka.

Zajímá vás vývoj?

Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.

Přehled změn

1.0.1

  • Added: Scrollbar for gpx file list

1.0.2

  • Handling of missing fields improved

1.0.3

  • Update problem solved

1.0.4

  • MapQuest API has changed
  • File names URL-encoded in http requests