Mit Vroomnavigieren
Füge deiner Website oder App einen Button hinzu, und Fahrer öffnen deine Route in Vroom GPS, dem kostenlosen Motorrad-GPS. Ein einfacher Link genügt. Kein Vertrag, kein Konto.
Ein Link,sonst nichts
Baue eine URL auf vroom-gps.com/go mit genau einer Quelle und optional einem Namen, einem Logo und einer Referenz für die Zählung. Auf dem Smartphone öffnet die Seite Vroom (oder den Store), am Computer zeigt sie eine Vorschau.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubQuellen (genau eine)
| Parameter | Bedeutung | Beispiel |
|---|---|---|
via | Wegpunkte, 2 bis 50 Punkte lat,lng getrennt durch ; (optionaler Name nach einem Komma) | via=45.18,5.72;45.05,6.03,Col |
gpx | Öffentliche https-URL einer GPX-Datei (max. 5 MB). Vroom passt die Route an den Track an. | gpx=https://example.com/r.gpx |
to | Ein einzelnes Ziel lat,lng | to=44.94,6.10 |
q | Ein Ortsname oder eine Adresse, geokodiert | q=Col+du+Galibier |
trip | Die ID eines Vroom-Roadtrips (aus seinem Teilen-Link) | trip=aB3dE9… |
route | Die ID einer von Vroom gehosteten Route (Entwicklermodus) | route=k7m2p9x4q1z8 |
Optionen
| Parameter | Bedeutung | Beispiel |
|---|---|---|
name | Titel auf der Seite und in der App (80 Zeichen) | name=Col+du+Galibier |
logo | https-URL deines Logos, auf der Seite angezeigt (256 px, gecacht) | logo=https://example.com/logo.png |
ref | Freie Kennung deiner Website, nur für die Zählung | ref=meinclub |
lang | Sprache der Seite (2 Buchstaben), standardmäßig die des Browsers | lang=de |
Die App startet die Navigation nie von selbst: Der Fahrer sieht eine Vorschau und tippt auf Start. Keine Universal Links: Die Seite übergibt die Anfrage auf dem Smartphone an die App.
Entwicklermodus:wir hosten deine GPX
Mit einem kostenlosen API-Schlüssel lädst du deine GPX-Dateien zu Vroom hoch, erhältst pro Route einen kurzen Link mit deinem Logo und siehst, wie viele Fahrer jede Route geöffnet und navigiert haben. Kein Vertrag, du erstellst den Schlüssel selbst.
- 1
Schlüssel erstellen
Melde dich mit deinem Vroom-Konto im Web-Planer an, öffne Entwickler, erstelle einen Schlüssel und hinterlege Partnernamen und Logo.
- 2
Routen hochladen
POST einer GPX-Datei oder einer Liste von Punkten. Die Antwort enthält den Link und das Badge-HTML zum Einfügen.
- 3
Zahlen verfolgen
Seitenaufrufe, App-Öffnungen und gestartete Navigationen pro Route, mit 30-Tage-Diagramm, im Dashboard oder über die API.
REST-API
curl -X POST https://vroom-gps.com/api/v1/routes \
-H "Authorization: Bearer vgo_live_XXXXXXXX" \
-F "name=Col du Galibier" \
-F "externalId=route-123" \
-F "gpx=@galibier.gpx"
curl -X POST https://vroom-gps.com/api/v1/routes \
-H "Authorization: Bearer vgo_live_XXXXXXXX" \
-H "Content-Type: application/json" \
-d '{"name":"Col du Galibier","via":[{"lat":45.18,"lng":5.72},{"lat":45.06,"lng":6.40,"name":"Galibier"}]}'
{
"id": "k7m2p9x4q1z8",
"url": "https://vroom-gps.com/go?route=k7m2p9x4q1z8",
"name": "Col du Galibier",
"summary": { "distanceKm": 87.4, "pointCount": 1240 },
"badge": {
"lang": "en",
"light": { "img": "https://vroom-gps.com/images/badges/en/navigate-with-vroom-light.png", "html": "<a href=…><img …></a>" },
"dark": { "img": "https://vroom-gps.com/images/badges/en/navigate-with-vroom-dark.png", "html": "<a href=…><img …></a>" }
}
}
curl https://vroom-gps.com/api/v1/routes \
-H "Authorization: Bearer vgo_live_XXXXXXXX"
curl -X DELETE https://vroom-gps.com/api/v1/routes/k7m2p9x4q1z8 \
-H "Authorization: Bearer vgo_live_XXXXXXXX"
Standardkontingente: 100 Routen pro Tag, 1 000 Routen, 5 MB pro GPX. Schreib uns, wenn du mehr brauchst.
Das offizielleBadge
Verwende das Badge unverändert, hell oder dunkel, in deiner Sprache. Ändere weder Farben noch Proportionen.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/de/navigate-with-vroom-light.png" alt="Mit Vroom navigieren" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/de/navigate-with-vroom-dark.png" alt="Mit Vroom navigieren" height="60"></a>
Erstelledeinen Link
Gib den Wert ein, um deinen Link zu erhalten.
Fragen?Schreib uns
Wir antworten Integratoren innerhalb eines Tages: contact@vroom-gps.com