GPX Viewer

Beschreibung

Das Script liest eine oder mehrer GPX-Dateien, wertet sie aus und zeichnet Tracks, Routen und Wegpunkte in eine Google Maps-Karte ein. Befinden sich in der GPX-Datei mehrere Tracks oder Routen, so werden sie als getrennte Linien in verschiedenen Farben gezeigt. Die Namen der Tracks bzw. Routen erscheinen dann in einer Legende. Der Kartenausschnitt wird so gewählt, dass alle Tracks, Routen und Wegpunkte sichtbar sind. Der Kartenausschnitt kann nachträglich verändert werden.

Der Inhalt der GPX-Datei wird folgendermaßen behandelt:

• Wegpunkte
  • Normaler Wegpunkt
    • Wegpunkte werden als Nadel angezeigt.
    • Befindet sich der Mauszeiger über dem Wegpunkt, wird der Name des Wegpunktes angezeigt.
    • Bei Klick auf den Wegpunkt wird
      • der Inhalt des LINK-Feldes ausgewertet und eine Popup-Fenster mit der entsprechenden Seite geöffnet,
      • der Inhalt des NAME-Feldes und des CMT-Feldes (Kommentar) angezeigt, wenn das LINK-Feld leer ist. Auf Wunsch kann auch der Inhalt des DESC-Feldes (Description) angezeigt werden.
    • Wegpunktsymbole können frei definiert werden. Dazu muss das Wegpunktsymbol den gleichen Namen haben, wie in der Script-Definition. Hierzu sind allerdings Kenntnisse in Javascript notwendig.
  • Bildwegpunkt
    • Wird der Name eines Wegpunktes als Name eines Bildes erkannt, also wenn er auf ".jpg", ".jpeg", ".gif" oder ".png" endet, wird ein Bildwegpunkt angezeigt.
    • Befindet sich der Mauszeiger über dem Wegpunkt, wird ein kleines Vorschaubild angezeigt.
    • Bei Klick auf den Wegpunkt wird das Bild in Originalgröße angezeigt. Unter dem Bild wird der Inhalt des CMT-Feldes und auf Wunsch der Inhalt des DESC-Feldes angezeigt.
• Tracks
  • Tracks auf der Karte
    • Tracks werden als farbige Linien angezeigt. Tracksegmente werden nicht unterschieden.
    • Sind mehrere Tracks vorhanden, werden sie in unterschiedlichen Farben (bis zu 10) angezeigt.
    • Es können auch die Farbangaben aus der GPX-Datei verwendet werden. Dieses wird über die Steuervariable "Displaycolor" eingestellt.
    • Befindet sich die Maus über dem Track, ändert sich seine Farbe und es werden Trackinformationen angezeigt.
    • Bei Klick auf den Track
      • wird der Inhalt des LINK-Feldes ausgewertet und ein Popup-Fenster mit der entsprechenden Seite geöffnet,
      • oder es werden Trackinformationen angezeigt, wenn das LINK-Feld leer ist.
  • Tracks als Profil
    • Je nach Inhalt der GPX-Datei können Höhe, Steigung und Geschwindigkeit gegen die zurückgelegte Strecke oder gegen die verstrichene Zeit grafisch dargestellt werden. Auch ein Weg-Zeit-Diagramm ist möglich.
    • Die Steigung wird durch Differenzieren der Höhenwerte nach dem Weg gewonnen. Die Stärke der Glättung kann eingestellt werden.
    • Bei Vorliegen des SPEED-Feldes wird dieses für den Geschwindigkeitsplot genommen, sonst werden die Werte durch Differenzieren des Weges nach der Zeit ermittelt. Die Stärke der Glättung kann eingestellt werden.
    • Die Farben der Linien in den Plots sind identisch mit denen der Tracks in der Karte.
    • Befinden sich mehrere Tracks in der Datei, kann mit der Steuervariablen "Tracks_verbinden" eingestellt werden, ob die Tracks in den Profilen mit fortlaufender Weg- bzw. Zeitachse dargestellt werden, oder ob für jeden Track die Zeit und der Weg bei Null beginnen.
    • Wenn nur ein Track gefunden wurde oder wenn die Steuervariable "Tracks_verbinden" den Wert "true" hat, kann man mit der Maus in den Profilgrafiken den Track abfahren und man sieht auf der Karte den zu den Profilwerten gehörenden Ort. Zusätzlich werden einige Infos eingeblendet.
• Routen
  • Routen werden als farbige Linien angezeigt. Die Routen werden als Verbindung der Zwischenziele dargestellt. Liegen die Routen im Garminformat vor, werden sie straßengenau gezeichnet.
  • Sind mehrere Routen vorhanden, werden sie in unterschiedlichen Farben (bis zu 10) angezeigt.
  • Es können auch die Farbangaben aus der GPX-Datei verwendet werden. Dieses wird über die Steuervariable "Displaycolor" eingestellt.
  • Befindet sich die Maus über der Route, ändert sich ihre Farbe und es werden Routeninformationen angezeigt.
  • Bei Klick auf die Route
    • wird der Inhalt des LINK-Feldes ausgewertet und ein Popup-Fenster mit der entsprechenden Seite geöffnet,
    • oder es werden Routeninformationen angezeigt, wenn das LINK-Feld leer ist.

Einbinden des Scriptes

Damit Routen und Tracks in die Karte eingezeichnet werden können, sollte die Seite den Dokumententyp "HTML 5" haben und UTF-8 kodiert sein:

<!DOCTYPE html>
 <html>
  <head>
   <meta charset="utf-8"> 
         ...

Das Script muss dann folgendermaßen eingebunden werden:

<script type="text/javascript" src="GM_Utils/GPX2GM.js"></script>

Wenn das Script in einem anderen Ordner liegt, muss der Pfad zum Script noch angepasst werden.

Einfache Variante

Um nur Tracks, Routen oder Wegpunkte aus einer GPX-Datei auf ihrer Seite anzuzeigen, fügen sie folgenden HTML-Code auf Ihrer Seite da ein, wo die Karte erscheinen soll:

<div class="gpxview:Name_der_GPX-Datei.gpx" style="width:500px;height:300px">
 <noscript><p>Zum Anzeigen der Karte wird Javascript benötigt.</p></noscript>
</div>

"Name_der_GPX-Datei.gpx" ersetzen sie einfach durch den Namen Ihrer GPX-Datei. Möchten sie Inhalte aus mehreren Datein darstellen, müssen die Dateinamen durch ein Komma getrennt werden:

<div class="gpxview:GPX-Datei_1.gpx,GPX-Datei_2.gpx" style="width:500px;height:300px">
 <noscript><p>Zum Anzeigen der Karte wird Javascript benötigt.</p></noscript>
</div>

Die Höhen- und Breitenangaben können Sie natürlich an Ihr Layout anpassen.

Sie können hinter den Dateinamen noch einen weiteren Steuerparameter angeben. Dabei bedeutet:

Siehe hierzu die Beispielseite 1.

Anmerkung

Ich empfehle, HTML-Seite, GPX-Datei und eventuelle Fotos im selben Ordner abzulegen.

Voraussetzungen

• Eine GPX-Datei mit den Tracks, den Routen und bzw. oder den Wegpunkten.
• Die Scripte, die Bilder für die Icons und den Marker sowie die Beispiele als ZIP-Archiv GPXViewer57.zip. Die Scripte und die CSS-Datei müssen im gleichen Ordner (z.B. GM_Utils) abgelegt werden, die Bilder für die Icons im Unterordner Icons (z.B. GM_Utils/Icons).

Zusätzliche Einflussnamen auf die Karten

Durch das Platzieren von Buttons mit entsprechendem Klassennamen kann man die Karten neu skalieren, so dass der ganze Track wieder sichtbar ist, und man kann neue Routen / Tracks / Wegpunkte mit entsprechendem Kartenausschnitt in das Kartenfenster laden:

<button type="button" class="gpxview:map:skaliere">Alles anzeigen</button>
<button type="button" class="gpxview:map:lade:Beispiel1.gpx:Hybrid">1. Karte laden</button>
<button type="button" class="gpxview:map:lade:Beispiel2.gpx:Karte">2. Karte laden</button>
<div id="map" class="gpxview:Beispiel1.gpx:Satellit" style="width:500px;height:300px">
 <noscript><p>Zum Anzeigen der Karte wird Javascript benötigt.</p></noscript>
</div>

Die Befehle sind folgendermaßen aufgebaut:

      gpxview:id_der_Karte:Befehl:optionale_Parameter

Dem div, in dem die Karte angezeigt werden soll, muss eine id gegeben werden.
Siehe hierzu die Beispielseite 2.

Ebenso können neue Routen / Tracks / Wegpunkte mit entsprechendem Kartenausschnitt in das Kartenfenster über ein Auswahlmenü geladen werden (Beispielseite 2b):

<select class="gpxview">
 <option value="map:Beispiel1.gpx:Hybrid" selected="selected">Beispiel1.gpx</option>
 <option value="map:Beispiel2.gpx:Karte">Beispiel2.gpx</option>
</select>
<div id="map" class="gpxview:Beispiel1.gpx:Satellit" style="width:500px;height:300px">
 <noscript><p>Zum Anzeigen der Karte wird Javascript benötigt.</p></noscript>
</div>

Außerdem können auch mehrere Karten auf einer Seite angezeigt werden. Siehe hierzu die Beispielseite 3 und die Beispielseite 3b.

Profile

Zusätzlich zur Darstellung auf der Karte oder dem Satellitenbild können je nach Inhalt der GPX-Datei auch Höhen-, Steigungs- und Geschwindigkeitsprofile sowie ein Weg-Zeit-Diagramm angezeigt werden. Dabei ist die Darstellung gegen den zurückgelegten Weg oder gegen die verstrichene Zeit möglich. Da die Zuordnung zwischen Karte und Profilgrafik über die ID erfolgt, muss das Karten-DIV eine ID haben, z.B. "map". Die DIVs für die Profile benötigen dann eine ID, die sich wie folgt zusamensetzt:

Um z.B. alle Profile anzeigen zu können, muss der HTML-Code folgendermaßen aussehen:

<div id="map" class="gpxview:Name_der_GPX-Datei.gpx" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen der Karte wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_hp" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Höhenprofils gegen den Weg wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_hpt" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Höhenprofils gegen die Zeit wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_sp" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Steigungsprofils gegen den Weg wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_spt" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Steigungsprofils gegen die Zeit wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_vp" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Geschwindigkeitsprofils gegen den Weg wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_vpt" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Geschwindigkeitsprofils gegen die Zeit wird Javascript benötigt.</p>
 </noscript>
</div>
<!-- ... -->
<div id="map_wp" style="width:500px;height:300px">
 <noscript>
  <p>Zum Anzeigen des Weg-Zeit-Diagramms wird Javascript benötigt.</p>
 </noscript>
</div>

Die Karte und die Profile können sich an beliebigen Stellen der Seite befinden. Siehe hierzu auch die Beispielseite 4 mit Profilen gegen den Weg und die Beispielseite 5 mit Profilen gegen die Zeit.

Weitere Steuermöglichkeiten

Am Anfang des Scriptes befinden sich einige Steuervariablen, mit denen das Aussehen der Karte und das Verhalten des Scripts weiter beeinflusst werden kann, indem man ihre Werte auf true oder false setzt. Man kann u. A. zwischen großem und kleinem Zoomregler wählen, die Übersichtskarte einschalten, die Legende über der Karte abschalten, einstellen, welche Elemente beim Start gezeigt werden und mehrere Tracks in einer Datei im Höhenprofile aneinander ketten. Darüber hinaus kann auch das Aussehen von Tracks und Routen verändert werden.

Die Werte der Steuervariablen können im Script angepasst werden, so dass die Änderung auf allen Seiten wirkt. Ein Setzen der Variablen in der Datei "GPX2GM_Defs.js" ist ebenfalls möglich. Man kann die Variablen aber auch nur im Scriptbereich der Seiten einfügen, deren Darstellung verändert werden soll.

Über die Variable "JB.Scaling" kann die Skalierung der Profildiagramme beeinflusst werden. Normalerweise ermittelt das Script automatisch die Min- und Maxwerte. Werden die Werte für min und max beide gesetzt, nimmt das Script diese für die Skalierung. Dazu können Sie die normalerweise auskommentierte Definition am Anfang des Scripts aktivieren und anpassen oder die Zeilen in einen Scriptbereich vor der Einbindung des Scriptes setzen.

Liste der Steuervariablen

Beispiele

• Beispiel 1
  Nur eine Karte.
• Beispiel 2
  Weitere Karten mit Button anzeigen.
• Beispiel 2b
  Weitere Karten mit Auswahlmenü anzeigen.
• Beispiel 3
  Wie 2, mit mehreren Karten.
• Beispiel 3b
  Wie 2b, mit mehreren Karten.
• Beispiel 4
  Karte und Profile gegen Weg.
• Beispiel 5
  Karte und Profile gegen Zeit.
• Beispiel 6
  Wie 4, mit mehreren GPX-Dateien.
• Beispiel 7
  Drei kleine Karten.
• Und was sonst noch möglich ist, hier sind aber Javascriptkenntnisse notwendig:
  • Verschiedene Möglichkeiten, Bilder zu zeigen: Foto 1, Foto 2, Foto 3, Foto 4, Foto 5.
  • Nachträgliches Setzen von Wegpunkten: Beispiel 8

Links

• Google Maps
• Google Maps API
• Wikipediaartikel über das GPS Exchange Format - GPX
• GPS-Track-Analyse.NET
  Programm zum Nachbearbeiten von Tracks. Ich benutze es u. A., um Fotos in Wegpunkte umzuwandeln und um Höhenprofile zu glätten.

Versionen

Vor der Veröffentlichung des Scriptes unterziehe ich es umfangreichen Tests mit diversen GPX-Dateien in den gängigen Browsern. Sollten Sie trotzdem einen Fehler finden, würde ich mich über eine Mitteilung, evtl. mit der den Fehler verursachenden GPX-Datei, freuen. An dieser Stelle möchte ich mich für die Meldungen von Usern und für deren Dateien, die mir bei meinen Tests eine große Hilfe sind, ganz herzlich bedanken.

Update von einer älteren Version des Scriptes auf die Version 5 oder höher

Die Google Maps API V3 verlangt keinen Schlüssel mehr. Daher kann die Zeile "var key=..." entfernt werden, muss aber nicht. Ich empfehle den Documententyp "HTML 5", "XHTML 1.0" funktioniert aber auch. Daher müssen Sie auch hier nichts ändern. Die Datei "GPX2GM_Defs.js" muss ebenfalls ausgetauscht werden. Sollten Sie in dieser Datei eigene Definitionen haben, müssen Sie diese übertragen. Achtung: das Iconformat wurde geändert.

Die Version 5 ist bis auf das andere Aussehen der V3-Map kompatibel zu älteren Versionen. Sollte ich bei der Umstellung etwas übersehen haben, würde ich mich über eine kurze Info freuen.

Infos über Updates auf Twitter @JBerkemeier.

• Version 5.7
  • Die Fläche unter den Profilkurven kann in Linienfarbe eingefärbt werden. Die neue Steuervariable Profilfillopac gibt die Sättigung an.
  • Mit der neuen Steuervariable Groesseminibild kann die Größe des Vorschaubildes bei Bildwegpunkten verändert werden.
  • Der Bereich für Mausklick auf und Überfahren von Tracks und Routen wurde vergrößert.
  • Die beim Wechsel auf die Version 5 vergessene Auswertung des Linktags bei Tracks und Routen wurde wieder eingebaut.
  • Verbesserung der Speicherverwaltung.
  • Korrektur einiger kleiner Fehler.
• Version 5.6.1
  • Korrektur eines Fehlers in Verbindung mit Tracks, die nur aus einem Punkt bestehen.
• Version 5.6
  • Neue Steuervariablen: Tracks_dateiuebergreifend_verbinden, Plotframecol, Plotgridcol und Plotlabelcol.
  • Zum Schließen des Infofensters kann man "irgendwo" in die Map klicken.
  • Einbau einer Callback-Funktion, die bei Klick auf einen Wegpunkt aufgerufen wird. Siehe hierzu die Fotobeispiele.
  • Das Tag speed wird auch als gpxx:speed gelesen.
  • Korrekturen kleiner Fehler.
• Version 5.5
  • Neue Steuervariable, um bei Wegpunkten die Anzeige des Namens zu steuern (Shwpname).
  • Neue Steuervariable, um im Infofenster die absolute Zeit anzuzeigen (Shtrtabs).
  • Bei kleinen Karten werden keine Kontrollelemente für Zoom oder Kartenwahl gezeigt.
  • Positionierung des Infofensters (Maus über Profilgrafik) verbessert.
  • Formatanweisungen in CSS-Datei GPX2GM.css ausgelagert.
  • Korrekturen kleiner Fehler.
• Version 5.4
  • Neue Steuervariable um auf Wunsch die Skalierung der Karte über die Werte im Bounds-Tag zu steuern (Usegpxbounds).
  • Korrekturen in den Beispieldateien.
• Version 5.3
  • Weitere Steuervariable: Eichfaktor für die Werte des Speed-Tags (Speedfaktor).
  • Fehlerkorrektur: Beim Aus- und Einschalten von Tracks, Routen und Wegpunkten wird der Kartentyp nicht mehr auf den Defaulttyp zurückgesetzt.
• Version 5.2
  • Auf Wunsch Wegpunkt bei Start und Ziel, Steuervariablen: Shtrstart, Shtrziel, Shrtstart, Shrtziel.
  • Copyrighteinblendung bei OSM und Cycle Map.
  • Beim Aus- und Einschalten von Tracks, Routen und Wegpunkten wird die Karte nicht neu ausgerichtet.
  • Die OSM-Karte T & H wird nicht mehr angeboten und wurde daher aus der Auswahl entfernt.
• Version 5.1
  • Karte wird nach Schließen des Infofensters wieder zurückgeschwenkt.
  • Korrektur eines Fehlers bei nicht automatischer Skalierung der Profilgrafiken.
  • Diverse kleine Korrekturen und Optimierungen.
  • Hilfsscripte werden erst bei Bedarf nachgeladen.
  • Das Script belegt nur noch den globalen Namen "JB". Daher müssen bei diesem Update noch einmal alle Scripte ausgetauscht werden.
• Version 5
  • Umstellung auf die Google Maps API V3.
  • Neue Steuervariable Scrollwheelzoom.
• Version 4.9.1
  • Letzte Version, die auf der Google Maps API V2 basiert.
• Alle Versionen

Rechtliches

Die Verwendung des Scriptes auf nicht kommerziellen Seiten ist frei. Die Verwendung auf kommerziellen Seiten bedarf meiner Zustimmung. Das Script darf verändert werden, wenn meine Copyrightvermerke nicht entfernt werden und wenn diese Änderungen kenntlich gemacht werden. Über eine Nennung meines Namens oder einen Link auf diese Seite würde ich mich freuen.

Das Script greift auf die Google Maps API zu. Seine Funktion hängt damit von der Bereitstellung dieses Dienstes durch Google ab. Die rechtlichen Bestimmungen von Google müssen eingehalten werden.