Digitales Roadbook vs. PDF oder Papier: OpenRally-Roadbook-Dateien erklärt

Ein Papier-Roadbook ist eine bedruckte Rolle, ein PDF-Roadbook ist ein Bild dieser Rolle auf einem Bildschirm. Ein digitales Roadbook im OpenRally-Format ist anders: Die Datei selbst teilt dem Gerät die Distanz jeder Box, den CAP, die Wegpunkte mit ihren Validierungsradien und die Geschwindigkeitszonen mit, inklusive der eingebetteten Tulpen- und Notizzeichnungen. Genau deshalb kann ein digitales Roadbook Ihren Kilometerzähler abgleichen, Wegpunkte validieren und Sie in Geschwindigkeitszonen warnen.

Digitales Roadbook vs. PDF vs. Papier: Was ist der Unterschied?

Papier- und PDF-Roadbooks zeigen die Strecke als Bilder, die der Fahrer interpretieren muss. Ein digitales Roadbook im OpenRally-Format speichert dieselbe Strecke als Daten: Jede Box enthält ihre Distanz, den CAP sowie Wegpunkt- und Geschwindigkeitszonen-Informationen, mit eingebetteten Zeichnungen. Mit diesen Daten kann das Gerät Ihren Kilometerzähler abgleichen, Wegpunkte validieren und Sie in Geschwindigkeitszonen warnen.

Warum ein PDF im Sinne der Navigation nicht „digital“ ist

Auf einem Bildschirm sieht ein PDF-Roadbook genauso aus wie Papier, doch das Gerät kann aus einem Bild keine Distanzen, keinen CAP und keine Wegpunkte lesen. Es kann die Seite anzeigen. Es kann keinen Wegpunkt validieren, den Kilometerzähler nicht an eine Box angleichen und Sie nicht in einer Geschwindigkeitszone warnen.

Papier, kurz gesagt

Rallye-Roadbooks wurden traditionell auf eine Papierrolle gedruckt und Box für Box weitergedreht. Das Format stammt vom Papier: dieselben Boxen, Tulpen und Notizen, die ein digitales Roadbook heute anzeigt. Der Unterschied: Auf Papier muss der Fahrer jede Zahl selbst ablesen und abgleichen.

Was ist OpenRally?

OpenRally ist ein offener Community-Standard für den elektronischen Austausch von Rallye-Roadbook-Daten. Er erweitert GPX, das gängigste GPS-Dateiformat, um rallyespezifische Tags (Distanzen, CAP, Wegpunkttypen und -radien, Geschwindigkeitszonen, Kontrollen) und bettet die Tulpen- und Notizzeichnungen als PNG oder SVG ein, sodass eine einzige Datei das komplette Roadbook enthält.

Wer OpenRally geschaffen hat

OpenRally wurde von ICO Racing und F2R mitbegründet, die die ursprüngliche Nomenklatur und Struktur festlegten. Dave Peckham von Rally Navigator schrieb den Code der Spezifikation. Heute ist es ein Community-Standard, der von den Unternehmen gepflegt wird, die ihn nutzen, darunter Hersteller von Roadbook-Software, Veranstalter und Gerätehersteller.

Warum GPX?

Die OpenRally-README nennt drei Gründe: GPX ist das gängigste Geodaten-Dateiformat, es gibt viele Konvertierungswerkzeuge dafür, und es wurde für Erweiterungen konzipiert. OpenRally ist ein Austauschformat, daher kann jede App die Daten intern speichern, wie sie möchte.

Versionen

Die Release Notes umfassen v1.0.0, die Cross-Country-Tags von Straßenrallye-Tags trennte, doppelte Tags entfernte, Standardwerte nach FIM oder aktuellen Reglements festlegte und Tulpen- und Notizzeichnungen als Base64-PNG oder SVG ergänzte, sowie v1.0.2, die den Marker show_coordinates hinzufügte. Das aktuelle Schema verwendet den Namespace v1.0.3 (letztes getaggtes Release: v1.0.2). OpenRally 1.x deckt Cross-Country-Rallyes ab; die Straßenrallye liegt in einem separaten Branch, v0.3-DRAFT.

Was eine OpenRally-Datei enthält – und was nicht

Eine OpenRally-Datei enthält die Roadbook-Boxen der Strecke als GPX-Wegpunkte. Jede hat ihre Distanz und kann zusätzlich den CAP, eine Gefahrenstufe, einen Wegpunkttyp mit seinen Radien, Geschwindigkeitszonen- und Kontrollmarker sowie die Tulpen- und Notizzeichnungen enthalten. Nicht enthalten sind Zugriffskontrolle, Strafen oder Wertungsregeln, Karten und das Reglement der Veranstaltung.

Was sie enthält (laut offiziellem Schema und Beispieldatei)

• Kopfbereich: die Einheiten (metrisch oder imperial, „statute“) und die Gesamtdistanz der Strecke, in den extensions der Metadaten.
• Jede Box: ein GPX-Wegpunkt, dessen extensions seine Distanz enthalten – das einzige Element, das jede Box haben muss.
• Kurs und Gefahr: cap und danger, mit Gefahrenstufen von 1 bis 3.
• Wegpunkte: Wegpunkttypen mit einem Öffnungsradius (open), einem Validierungsradius (clear) und einem Namen.
• Wertungsprüfung: Start- und Zielmarker (dss und ass).
• Geschwindigkeitszonen: Beginn der Zone, Geschwindigkeitslimit und Ende der Zone (dz, speed und fz).
• Verbindungsetappen: Beginn und Ende einer Verbindungsetappe (dt und ft).
• Kontrollen und Marker: Stopp, Neutralisation und ihr Ende (neutralization und fn), Zeitkontrolle mit den erlaubten Minuten bis zur nächsten (timecontrol), Checkpoint, Tanken und Rücksetzen des Kilometerzählers.
• Sicherheitskräfte und der Marker show_coordinates.
• Zeichnungen: die Bilder tulip und notes.

Auch die Standard-GPX-Elemente gelten, etwa Breiten- und Längengrad jedes Wegpunkts. Ob eine Datei zusätzlich den vollständigen Track enthält, hängt von den Exporteinstellungen des Editors ab.

Was sie nicht enthält (das v1.x-Schema hat kein Element für)

• Wer die Datei öffnen darf und wie lange. Die Zugriffskontrolle übernehmen Verteilplattformen (RDS bietet zum Beispiel nicht teilbare Roadbooks und zeitlich begrenzten Zugriff).
• Strafen, Wertungsregeln oder das Reglement der Veranstaltung. Das einzige Zeitelement ist timecontrol allowed, die Minuten bis zur nächsten Kontrolle.
• Das Symbollexikon von FIM oder FIA. Die Zeichnungen sind eingebettete Bilder, keine Symbolcodes.
• Karten oder Kartenkacheln.
• Notizen als durchsuchbaren Text. Notizen sind Zeichnungen, auch wenn eine SVG-Zeichnung Text enthalten kann.
• Eine digitale Signatur oder Integritätsprüfung.
• Regeln dafür, wie sich ein Gerät verhalten soll. Das Schema speichert Radien und Marker; jedes Gerät entscheidet selbst, wie es sie anzeigt und daran validiert.

OpenRally-Tags und -Attribute (Referenz)

OpenRally-Tags stehen im standardmäßigen GPX-Block extensions jedes Wegpunkts (wpt), im Namespace http://www.openrally.org/xmlschemas/GpxExtensions/v1.0.3, meist mit dem Präfix openrally.

• Schreibweise der Einheiten: Der Schema-Kommentar schreibt „statute“, die Liste der erlaubten Werte aber „statue“. Akzeptieren Sie beim Lesen von Dateien beide Schreibweisen.
• Ältere Namen: Einige ältere Tag-Namen wurden in v1.0 ersetzt und sind im Schema auskommentiert. Behandeln Sie sie nicht als aktuell.
• Herstellerspezifische Zusätze: Manche Editoren fügen der Spezifikation nicht standardisierte Attribute oder Modi hinzu. Reader sollten unbekannte Tags und Attribute ignorieren.

So erhalten Sie eine OpenRally-Roadbook-Datei

Eine OpenRally-Datei erhalten Sie auf drei Wegen: Der Veranstalter schickt sie (als Download oder per E-Mail oder über eine Verteilplattform wie RDS Ihrem Gerät zugewiesen), Sie laden eine aus einer Roadbook-Bibliothek herunter, oder Sie erstellen Ihre eigene in einem Roadbook-Editor mit OpenRally-GPX-Export.

Vom Veranstalter

Manche Veranstalter schicken die Datei direkt. Andere verteilen sie über eine Plattform. Mit RDS (Roadbook Delivery System, entwickelt und betrieben von TerraPirata) importieren Veranstalter Roadbooks, etwa aus Rally Navigator, oder OpenRally-Dateien (GPX), weisen sie den Fahrern per Device ID oder E-Mail zu und können Zeitfenster, Geschwindigkeitszonen, Live-Tracking und Wertung festlegen. Wettbewerbs-Roadbooks sind oft bewusst zeitlich begrenzt oder nicht teilbar.

Aus einer Bibliothek

TerraPirata bietet RDS-Nutzern eine kostenlose Bibliothek mit Partner-Roadbooks. In der F2R Roadbook App erscheinen sie unter „Public“.

Selbst erstellen

Diese Roadbook-Editoren haben einen geprüften OpenRally-Export:

• Rally Navigator: File > Export > OpenRally GPX. Rally Navigator veröffentlicht außerdem OpenRally-GPX-Beispieldateien.
• RiverNotes 2: führt OpenRally unter seinen Exportformaten.
• Tulip: exportiert OpenRally v1.0.2, mit einem Strict-Modus und einem Undocumented-Modus.

Kann ich ein PDF in OpenRally umwandeln?

Für Entwickler: ein Tool oder einen Viewer bauen, der OpenRally liest

Für Entwickler

Eine OpenRally-Datei ist GPX-1.1-XML. Parsen Sie jeden Wegpunkt, lesen Sie die OpenRally-Elemente in seinen extensions, behalten Sie die Boxen in Dateireihenfolge bei, berechnen Sie die Teildistanz zwischen den Boxen und stellen Sie die Tulpen- und Notizbilder neben Distanzen, CAP und Markern dar.

Schritte

1. Prüfen Sie die Version des OpenRally-Namespace im Wurzelelement der Datei und parsen Sie entsprechend. Die README verlangt das, und das Projekt nutzt semantische Versionierung.
2. Lesen Sie die Einheiten und die Gesamtdistanz aus den extensions der Metadaten.
3. Lesen Sie für jeden Wegpunkt (wpt) Breiten- und Längengrad, die Gesamtdistanz und die Teildistanz (diese Box minus die vorherige, unter Berücksichtigung eines eventuellen reset) sowie cap, danger und die Wegpunkt-, Zonen- und Kontrollmarker mit ihren Attributen open, clear und name.
4. Stellen Sie die Zeichnungen dar. Der Inhalt ist entweder eine Base64-PNG-Data-URL oder Inline-SVG, normalerweise in CDATA. Laden Sie nie externe Referenzen nach: Die Datei ist für den Offline-Betrieb ausgelegt.
5. Validieren Sie während der Entwicklung mit dem Skript validate.sh des Repositorys, das xmllint gegen test_wrapper.xsd ausführt (dieses importiert openrally.xsd und gpx-strict.xsd).
6. Seien Sie tolerant: Überspringen Sie XML-Kommentare und Erweiterungen anderer Hersteller, ignorieren Sie unbekannte Tags und akzeptieren Sie sowohl „statute“ als auch „statue“.
7. Halten Sie die Navigationslogik in der App, nicht in der Datei: Kilometerzähler per GPS, Abgleich mit der Box-Distanz, Öffnen eines Wegpunkts innerhalb seines open-Radius und Validieren innerhalb seines clear-Radius sowie Geschwindigkeitszonen-Warnungen zwischen dz und fz.

Beispiel: die Boxen mit der Python-Standardbibliothek lesen

import xml.etree.ElementTree as ET
GPX = "{http://www.topografix.com/GPX/1/1}"

def read_openrally(path):
    root = ET.parse(path).getroot()
    boxes, prev = [], 0.0
    for wpt in root.findall(GPX + "wpt"):
        ext = wpt.find(GPX + "extensions")
        if ext is None:
            continue
        box = {"lat": float(wpt.get("lat")), "lon": float(wpt.get("lon"))}
        for el in ext:
            if not isinstance(el.tag, str) or "openrally" not in el.tag:
                continue  # skip comments and other vendors' extensions
            tag = el.tag.split("}")[1]          # e.g. "distance", "wpm", "tulip"
            box[tag] = dict(el.attrib) if el.attrib else (el.text or "").strip()
        total = float(box.get("distance", prev))  # total distance from start
        box["partial"] = round(total - prev, 2)   # distance since previous box
        prev = total
        boxes.append(box)
    return boxes

Die offizielle example.gpx ist ein Tag-Schaufenster, keine echte Strecke, daher ergeben ihre Distanzen keine echte Abfolge. Testen Sie mit einem echten Export, etwa einer der OpenRally-GPX-Beispieldateien von Rally Navigator. Im Browser kann ein Viewer dasselbe mit DOMParser und getElementsByTagNameNS tun und PNG-Tulpen in einem img-Element mit einer Data-URL anzeigen.

Ressourcen

• OpenRally-Repository (README, Release Notes und Mailingliste)
• Cross-Country-XSD
• example.gpx
• validate.sh
• Entwurf für Straßenrallyes (v0.3-DRAFT)
• GPX-1.1-Schema (Topografix)
• Cross-Country-Leitfaden von Rally Navigator
• Hinweise von Tulip zum OpenRally-Export

Eine OpenRally-Datei auf das F2R Y1000 laden (F2R Roadbook App)

Die F2R Roadbook App auf dem Y1000 liest OpenRally-.GPX-Dateien und unterstützt alle OpenRally-Tags. Importieren Sie eine Datei aus dem lokalen Speicher oder empfangen Sie sie über RDS, Ihrer Device ID oder Ihrem Konto zugewiesen. Die App liefert dann Kilometerzähler, CAP, Geschwindigkeitszonen-Warnungen und Wegpunkt-Validierung aus den Daten der Datei selbst.

Aus einer lokalen Datei

1. Tippen Sie in der F2R Roadbook App auf ADD.
2. Wählen Sie die .GPX-Datei aus Downloads, Dateien, E-Mail, Google Drive, Dropbox oder einem anderen Ordner.
3. Das Roadbook erscheint unter „My Roadbooks“. Lokal geladene Roadbooks können Sie in der App löschen.

Über RDS

1. Erstellen Sie ein Konto oder melden Sie sich an unter rds.terrapirata.com.
2. Verknüpfen Sie das Y1000 über seine Device ID, die in der MyGamma-App angezeigt wird, oder über die E-Mail-Adresse des Google-Kontos auf dem Gerät.
3. Der Veranstalter oder Sie selbst weisen Roadbooks zu. Sie erscheinen unter „Events“ für den vom Eigentümer festgelegten Zeitraum oder unter „Public“.

Nur der Eigentümer kann RDS-Roadbooks verwalten, und zwar in RDS. Für eine Device ID freigegebene Roadbooks erscheinen nur auf diesem Gerät; die Device ID ist fest, die E-Mail-Adresse lässt sich ändern.

Was die App mit den Daten macht

• Haupt- und Zweitkilometerzähler, einstellbar per langem Tippen, per langem Tippen auf die Distanz einer Notiz oder mit den Fernbedienungen DR001 (Motorrad) und DRA01 (Auto). Das Y1000 hat virtuelle Tripmaster integriert.
• CAP-Kursanzeige.
• Ein Wegpunkt-Pfeil, der sich innerhalb des Öffnungsradius des Wegpunkts öffnet und schließt, wenn der Wegpunkt validiert ist oder Sie den Radius verlassen.
• Distanz zum Wegpunkt und Name des nächsten Wegpunkts, der während der Validierung grün blinkt.
• Eine Wegpunkttabelle mit dem Status validiert oder verpasst, inklusive Uhrzeiten.
• Tachofarben in Geschwindigkeitszonen: innerhalb des Limits, nahe am Limit oder darüber.
• Etappenzeit von der Validierung des DSS bis zu der des ASS.
• Das FIM-Lexikon per langem Tippen.
• „Go to note“ in einer GPS-App, wenn das Roadbook Koordinaten enthält.

• Benutzerhandbuch der F2R Roadbook App (PDF)
• F2R Roadbook App
• Fernbedienungen

Und PDFs?

Das Y1000 ist ein vollwertiges Android-Gerät, daher lässt sich ein PDF-Roadbook mit einer kompatiblen Drittanbieter-App aus Google Play lesen; das Y1000 User Guide nennt als Beispiel Rally Roadbook Reader von Rally Navigator. Die oben genannten Navigationsfunktionen benötigen eine OpenRally-Datei.

FAQ