Totos GPX viewer

Konfigurationsmöglichkeiten des GPX-Viewers

Konfiguration in GPXviewerConf.js

Der GPXviewer stellt ohne weiteres (bzw. wenig) Zutun des Seitenerstellers eine GPX-Datei auf einer Karte mit den Standardeinstellungen dar. Der Seitenerstellers kann diese Darstellung an zahlreichen Punkten beeinflussen. Dazu dient in erster Linie die Konfigurationsdatei GPXviewerConf.js.

Mit Änderungen in dieser Datei wird eine einheitliche Darstellung für alle Karten erzielt.

Konfiguration über Parameter in der HTML-Datei

Soll die Darstellung einzelner Karten von der generellen Darstellung abweichen, kann dieses mit der Übergabe von Parametern in der HTML-Datei geschehen.

In der HTML-Datei abgegebene Parameter überschreiben die in der Konfigurationsdatei GPXviewerConf.js angegebenen Werte. Diese Möglichkeit besteht für fast alle Parameter im Bereich Anzeigeoptionen.

Schreibweise der Parameter

Parameter werden beim Laden des Scriptes in der HTML-Datei übergeben, in der Regel im body-tag:

<body onload="showTrack('basemap=cycleMap','showDownloadLink=0')">

Dabei gilt: Die einzelnen Parameter

Nicht auf jede Konfigurationsmöglichkeit in GPXviewerConf.js kann über einen entsprechenden Parameter, über die HTLM-Datei zugeriffen werden.

Liste der vorhandenen Konfigurationsmöglichkeiten

In der linken Spalte stehen die Schlüsselwörter, wie sie in der Datei GPXviewerConf.js verwendet werden; ist ein Pendant vorhanden, welches als Aufrufparameter in der HTML-Datei verwendet werden kann, so wird dieses direkt darunter – kursiv gesetzt – aufgeführt. Nicht für jedes Schlüsselwort in GPXviewerConf.js ist ein entsprechender Parameter verfügbar.

Anzeigeoptionen

in GPXviewerConf.js
als Parameter 		Typ/Wert Beschreibung
showDownloadLink
showDownloadLink		 bool

Bestimmt, ob im Service-Bereich der Karte ein direkter Link zur GPX-Datei angezeigt wird.

showMapOnlyLink
showMapOnlyLink		 bool

Bestimmt, ob im Service-Bereich der Karte ein Link zur Kartenseite angezeigt wird (beispielsweise, wenn die Karte standardhalber in einem iframe angezeigt wird).

showHelpPageLink
showHelpPageLink		 bool

Bestimmt, ob im Service-Bereich der Karte ein Link zur Hilfeseite angezeigt wird.

defaultTrackStyle
trackStyle		 string

Bestimmt den Stil, in denen die Tracks dargestellt werden. Es wird hier eine Grundfarbe angegeben, die im Array trackStyle in »GPXviewerConf.js« definiert sein muss. Sind mehrere Tracks in der GPX-Datei vorhanden, werden diese in unterschiedlichen Schattierungen der Grundfarbe angezeigt

Das Script versteht zusätzlich die Angabe gpx. Ist dieser Wert angegeben, wird versucht, die Farben der Tracks aus den Angaben in der GPX-Datei zu ermitteln.

fallbackGPXtrackStyle
string

Mit diesem Parameter wird der Trackstyle bestimmt, auf den zurückgegriffen wird, wenn der unter defaultTrackStyle angegebene nicht existiert (wenn dieser beispielsweise auf gpx gesetzt ist, aber in der GPX-Datei keine Farben angegeben sind). Es wird hier eine Grundfarbe angegeben, die im Array trackStyle in »GPXviewerConf.js« definiert sein muss.

defaultMarkerStyle
string

Legt die Form fest, in welcher die Wegpunkte markiert werden. Bisher ist lediglich disk vorhanden. Weiter können angelegt werden.

showGPXsymbols
showGPXsymbols		 bool

Bestimmt, ob in den Wegpunkten die Symbole angezeigt werden sollen, die dem Wegpunkt in der GPX-Datei zugewiesen sind. Achtung: evetuell sind nicht für alle Symbole die entsprechenden Grafiken vorhanden!

defaultBaseMap
baseMap		 string

Wählt die Hintergrundkarte aus. Der Parameter muss mit einem Schlüssel des Arrays baseMap aus »GPXviewerConf.js« übereinstimmen.

alternativeGpxBaseMap
alternativeGpxBaseMap		 string

Bestimmt die Hintergrundkarte für den Fall, dass die passende GPX-Datei nicht geladen werden konnte und die alternative GPX-Datei angezeigt wird. Der Parameter muss mit einem Schlüssel des Arrays baseMap aus »GPXviewerConf.js« übereinstimmen.

globalGpxBaseMap
globalGpxBaseMap		 string

Bestimmt die Hintergrundkarte für den Fall, dass weder die passende, noch die alternative GPX-Datei geladen werden konnte. Der Parameter muss mit einem Schlüssel des Arrays baseMap aus »GPXviewerConf.js« übereinstimmen.

showShadingLayer
showShadingLayer		 bool

Bestimmt, ob der Höhenlayer angezeigt werden soll.

defaultUIlanguage
UIlanguage		 string

Bestimmt die Sprache der Textteile der Benutzerschnittstelle

Dateien und Verzeichnisse

in GPXviewerConf.js Typ/Wert Beschreibung
alternativeGPXfilePostfix string

Der GPX-Viewer sucht im unter gpxPath angegebenen Verzeichnis nach einer GPX-Datei mit demselben Namen wie die HTML-Datei, in welcher die Karte angezeigt wird. Ist die entsprechende GPX-Datei nicht vorhanden, wird nach einer alternativen Karte gesucht, deren Namensteil (also noch vor der Dateierweiterung) ein entsprechendes Anhängsel hat. Es ist damit möglich, eine Datei als Platzhalter anzulegen.

fallbackGPXfile string

Falls weder die zur HTML-Datei gehörende noch die alternative GPX-Datei gefunden werden können, sucht der GPX-Viewer nach einer allgemeinen GPX-Datei.

gpxPath string

Hier wird das Verzeichnis bestimmt, aus welchem die GPX-Dateien geladen werden.

docPath string

In diesem Verzeichnis befinden sich die Hilfe-Dateien, die über den Link auf der linken Seite aufgerufen werden können.

markerPath string

In diesem Verzeichnis befinden sich alle Grafiken, die für die Darstellung der Wegpunkte benötigt werden.

uiPicuresPath string

Hier liegen die Grafiken, die der GPX-Viewer für die Benutzerschnittstelle benötigt.

Trackstyles

Das Aussehen des Tracks auf der Karte, wird nicht nur von der Farbe bestimmt, sondern auch von der Breite, der Opazität und dem Muster der Linie.

Eine GPX-Datei kann mehrere Tracks enthalten – damit einzelne Tracks auch als solche zu erkennen sind, werden bei der Darstellung vier unterschiedliche Schattierungen einer Farbe benutzt.♠

Die Karte wurde nicht geladen!

Der Code für die Erzeugung der Trackstile steckt deshalb in einer Funktion♣:

function buildTrackStyle() { trackStyle[buildTrackStyle.arguments[0]] = []; for (var i = 1; i < buildTrackStyle.arguments.length; i++) { trackStyle[buildTrackStyle.arguments[0]].push ({'strokeColor':buildTrackStyle.arguments[i], 'strokeOpacity':0.88, 'strokeWidth':3, 'strokeDashstyle':'longdash' })}}

Diese Funktion wird mit den vier Farbschattierungen als Argumente aufgerufen:

buildTrackStyle('grey','#aaaaaa','#000000','#ffffff','#555555'); buildTrackStyle('red','#ff0000','#a60000','#ff5757','#d20000'); buildTrackStyle('green','#00ff00','#00c000','#91ff91','#00e000'); buildTrackStyle('blue','#0000ff','#00009a','#5757ff','#0000cc'); buildTrackStyle('cyan','#00ffff','#00cacc','#bdfeff','#00e3e6'); buildTrackStyle('pink','#ff00ff','#b200b0','#ff7ffd','#d800d5'); buildTrackStyle('yellow','#ffff00','#bec000','#feff9d','#e3e600'); buildTrackStyle('orange','#ffbb00','#ba8800','#ffd257','#e0a300');

Da diese alles innerhalb GPXviewerConf.js passiert, können individuelle Anpassungen dort oder – besser noch – in einer eigenen Konfigurationsdatei♠ vorgenommen werden. Ein Beispiel hierfür findet sich bei den Tipps und Tricks.

Anmerkungen

♠ Zur besseren Sichtbarkeit wurde für dieses Beispiel eine eigene Konfigurationsdatei benutzt. Der Code für die Darstellung des Tracks lautet:

defaultTrackStyle = 'pink'; // make strokestyle solid for better visibility for (var styleName in trackStyle) { for (var count in trackStyle[styleName]) { trackStyle[styleName][count].strokeOpacity = 1; trackStyle[styleName][count].strokeWidth = 12; trackStyle[styleName][count].strokeDashstyle = 'solid'}}

Ebenfalls des Aussehens wegen habe ich alle Controls von der Karte entfernt. Dazu habe ich den mapSetupHook genutzt. Sieht so aus:

mapSetupHook = function(){ map.removeControl(mapControl['scaleLine']); map.removeControl(mapControl['layerSwitcher']); map.removeControl(mapControl['zoomPanel']); map.removeControl(mapControl['attribution']);}

♣ Alle Syntax-Hervorhebungen in diesem Abschnitt durch Highlight.

Zurück zur Übersichtsseite Dokumentation
letzte Änderung: 10.07.2015