RouteReel – Ausführliche Anleitung Single-File HTML Mapbox GL JS Turf.js Export: WebM (VP9)

RouteReel – Travel Animator

Diese Anleitung erklärt Schritt für Schritt die Bedienung aller Funktionen: Route-Video (2D/3D), Heatmap-Video, Zoom-/Kamerafahrten mit Keyframes sowie Export/Tipps.

1 Voraussetzungen

Du brauchst
  • einen aktuellen Browser (Chrome/Edge empfohlen)
  • einen Mapbox Access Token (beginnt mit pk...)
  • optional: Google Takeout Standortverlauf (JSON) oder geplante Route
Wichtige Hinweise
  • Export: WebM (VP9). Für MP4 später z.B. HandBrake nutzen.
  • Performance: große Strecken + hoher Zoom = mehr Render-Last.
  • Alles läuft lokal im Browser; Kartendaten kommen von Mapbox.

2 Start: Token, Karte, Check

  1. Datei öffnen: RouteReel.html lokal per Doppelklick im Browser öffnen.
  2. Token einfügen: oben in das Token-Feld deinen Mapbox Token eintragen.
  3. CHECK klicken: die Karte initialisiert sich sofort, wenn alles passt.
Typische Fehlerquelle: Wenn die Karte nach CHECK nicht reagiert, ist meist der Token ungültig oder durch Referrer/Domain eingeschränkt.

3 ROUTE: Fahrt als 2D/3D-Video

A) Datei laden (Google Takeout JSON)

  1. Tab ROUTEDATEI LADEN
  2. JSON auswählen
  3. Zeitraum einstellen:
    • Startzeit
    • Endzeit

Danach erscheint die Route als Linie, und die Karte zoomt auf den Bereich.

Dauer & Zoom
  • Dauer: 30s / 1 Min / 5 Min / 20 Min / Echtzeit
  • Zoom: Nah / Mittel / Fern / Weit / Welt
2D Stil

Wähle den Stil für die 2D-Aufnahme (z.B. Light, Dark, Straßen, Satellit).

B) Route planen (ohne Datei)

  1. Tab ROUTEROUTE PLANEN
  2. Auf die Karte klicken: Startpunkt → Zielpunkt (optional Zwischenpunkte)
  3. BERECHNEN (Mapbox Directions API)

C) Info im Film: Uhrzeit / Fahrzeit / km

Unter INFO IM FILM kannst du per Häkchen auswählen, was angezeigt wird:

  • Uhrzeit
  • Fahrzeit (Tour-Zeit, nicht Videolänge)
  • km seit Start

Die Werte laufen schnell, bleiben aber gut lesbar (typisch ~2 Updates/Sek.).

D) Aufnahme starten

REC 3D
  • 3D-Look (Pitch/Bearing)
  • Satellit/3D-Ansicht
  • ideal für „cinematische“ Shots
REC 2D
  • Top-down (Pitch 0°)
  • stabil für Streckenfilme
  • ideal für lange Fahrten
Während der Aufnahme: UI blendet aus, REC-Punkt erscheint, Info-Box wird in den Film eingebrannt. Am Ende startet automatisch ein Download (WebM).

4 ZOOM: Kamerafahrt mit Keyframes

Der Zoom-Modus ist für „Map-Cinematics“: Du definierst Kamerastände (Position, Zoom, Bearing, Pitch), und RouteReel fährt sie als Video ab.

Keyframes setzen

  1. Tab ZOOM öffnen
  2. Die Karte in die gewünschte Ansicht bringen:
    • Position (Center)
    • Zoom
    • optional: Bearing (drehen) und Pitch (kippen)
  3. Buttons:
    • START: setzt Keyframe 1
    • + PUNKT: fügt Zwischen-Keyframe ein (max. 10)
    • ZIEL: setzt letzten Keyframe

Keyframe-Liste

In der Liste kannst du:

  • GO (zur Ansicht springen)
  • ▲ / ▼ (umsortieren)
  • ✖ (löschen)

Dauer & Ease

  • DAUER (s): Gesamtlänge der Kamerafahrt
  • EASE: Smooth oder Linear
Wichtig: Für lange Distanzen wirken 4–7 Keyframes oft deutlich besser als nur Start/Ziel, weil Bewegung und Zoom gleichmäßiger verteilt werden können.

Vorschau & Aufnahme

  • VORSCHAU: spielt die Kamerafahrt ohne Aufzeichnung
  • REC FILM: zeichnet die Kamerafahrt als WebM auf

5 HEAT: Heatmap-Video

  1. Tab HEAT öffnen
  2. Daten laden (nutzt die geladenen Punkte aus dem Datei-Modus)
  3. Radius und Intensität einstellen
  4. Modus wählen:
    • Orbit (Kamera dreht)
    • Statisch
  5. REC Heatmap starten

6 Marker mit Text

Im ZOOM-Tab kannst du Marker setzen, die beim Zoomen sinnvoll mitskalieren.

  1. MARKER SETZEN aktivieren
  2. in die Karte klicken
  3. Text eingeben

Mit MARKER LÖSCHEN entfernst du die Marker wieder.

7 Export & Weiterverarbeitung

Format: WebM (VP9). Sehr gute Qualität, aber manchmal nicht „out of the box“ in allen Programmen.

WebM → MP4 (empfohlen)

  1. HandBrake öffnen
  2. WebM reinziehen
  3. Preset z.B. „Fast 1080p30“ wählen
  4. als MP4 exportieren

8 Tipps für schöne Ergebnisse

  • Weit/Welt: lieber längere Dauer → ruhigeres Bild.
  • 2D für Streckenfilme, 3D für Show-Shots.
  • Keyframes: bei großen Distanzen 4–7 Punkte statt nur 2.
  • Bei langen Zooms wirkt es natürlich, wenn am Anfang die Kamera „weiter“ ist und am Ende „näher“.
Mini-Checkliste vor REC:
Token OK Route sichtbar Dauer gesetzt Zoom gewählt Info-Häkchen gesetzt