Navigeren metVroom
Voeg een knop toe aan je site of app en rijders openen je route in Vroom GPS, de gratis motor-gps. Een gewone link volstaat. Geen contract, geen account.
Een link,meer niet
Bouw een URL op vroom-gps.com/go met precies één bron en, als je wilt, een naam, een logo en een referentie voor het tellen. Op een telefoon opent de pagina Vroom (of de store), op een computer toont ze een voorbeeld.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubBronnen (precies één)
| Parameter | Betekenis | Voorbeeld |
|---|---|---|
via | Waypoints, 2 tot 50 punten lat,lng gescheiden door ; (optionele naam na een komma) | via=45.18,5.72;45.05,6.03,Col |
gpx | Publieke https-URL van een GPX-bestand (max. 5 MB). Vroom past de route aan de track aan. | gpx=https://example.com/r.gpx |
to | Eén bestemming lat,lng | to=44.94,6.10 |
q | Een plaatsnaam of adres, gegeocodeerd | q=Col+du+Galibier |
trip | Het id van een Vroom-roadtrip (uit de deellink) | trip=aB3dE9… |
route | Het id van een door Vroom gehoste route (ontwikkelaarsmodus) | route=k7m2p9x4q1z8 |
Opties
| Parameter | Betekenis | Voorbeeld |
|---|---|---|
name | Titel op de pagina en in de app (80 tekens) | name=Col+du+Galibier |
logo | https-URL van je logo, getoond op de pagina (256 px, gecachet) | logo=https://example.com/logo.png |
ref | Vrije identificatie van je site, alleen voor het tellen | ref=mijnclub |
lang | Taal van de pagina (2 letters), standaard die van de browser | lang=nl |
De app start de navigatie nooit uit zichzelf: de rijder ziet een voorbeeld en tikt op Start. Geen universal links: de pagina geeft het verzoek op de telefoon door aan de app.
Ontwikkelaarsmodus:wij hosten je GPX
Met een gratis API-sleutel stuur je je GPX-bestanden naar Vroom, krijg je per route een korte link met je logo en zie je hoeveel rijders elke route hebben geopend en genavigeerd. Geen contract, je maakt de sleutel zelf aan.
- 1
Maak een sleutel
Log in op de webplanner met je Vroom-account, open Ontwikkelaars, maak een sleutel en vul je partnernaam en logo in.
- 2
Stuur je routes
POST een GPX-bestand of een lijst met punten. Het antwoord bevat de link en de badge-HTML, klaar om te plakken.
- 3
Volg de cijfers
Pagina-opens, app-opens en gestarte navigaties, per route, met een grafiek van 30 dagen, in je dashboard of via de 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"Standaardquota: 100 routes per dag, 1 000 routes, 5 MB per GPX. Schrijf ons als je meer nodig hebt.
De officiëlebadge
Gebruik de badge zoals hij is, licht of donker, in jouw taal. Wijzig de kleuren of verhoudingen niet.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/nl/navigate-with-vroom-light.png" alt="Navigeren met Vroom" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/nl/navigate-with-vroom-dark.png" alt="Navigeren met Vroom" height="60"></a>Bouwje link
Vul de waarde in om je link te krijgen.
Vragen?Schrijf ons
We antwoorden integrators binnen een dag: contact@vroom-gps.com