Navigate withVroom
Add a button to your site or app and riders open your route in Vroom GPS, free motorcycle GPS. A plain link is enough. No contract, no account.
A link,nothing else
Build a URL on vroom-gps.com/go with exactly one source and, if you like, a name, a logo and a reference for counting. On a phone the page opens Vroom (or the store), on a computer it shows a preview.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubSources (pick exactly one)
| Parameter | Meaning | Example |
|---|---|---|
via | Waypoints, 2 to 50 points lat,lng separated by ; (optional name after a comma) | via=45.18,5.72;45.05,6.03,Col |
gpx | Public https URL of a GPX file (5 MB max). Vroom fits the route to the track. | gpx=https://example.com/r.gpx |
to | A single destination lat,lng | to=44.94,6.10 |
q | A place name or address, geocoded | q=Col+du+Galibier |
trip | The id of a Vroom road trip (from its share link) | trip=aB3dE9… |
route | The id of a route hosted by Vroom (developer mode) | route=k7m2p9x4q1z8 |
Options
| Parameter | Meaning | Example |
|---|---|---|
name | Title shown on the page and in the app (80 characters) | name=Col+du+Galibier |
logo | https URL of your logo, shown on the page (256 px, cached) | logo=https://example.com/logo.png |
ref | Free identifier of your site, used only for counting | ref=myclub |
lang | Language of the page (2 letters), browser language by default | lang=fr |
The app never starts navigation by itself: the rider gets a preview and taps Start. Universal links are not used, the page hands the request to the app on the phone.
Developer mode:we host your GPX
With a free API key you push your GPX files to Vroom, get a short link per route with your logo, and see how many riders opened and navigated each one. No contract, you create the key yourself.
- 1
Create a key
Sign in to the Vroom web planner with your Vroom account, open Developers, create a key and set your partner name and logo.
- 2
Push your routes
POST a GPX file or a list of waypoints. The answer carries the link and the badge HTML ready to paste.
- 3
Follow the numbers
Page opens, app opens and navigation starts, per route, with a 30-day chart, in your dashboard or through the 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"Default quotas: 100 routes per day, 1,000 routes, 5 MB per GPX. Write to us if you need more.
The officialbadge
Use the badge as is, light or dark, in your language. Do not alter its colors or proportions.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/en/navigate-with-vroom-light.png" alt="Navigate with Vroom" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/en/navigate-with-vroom-dark.png" alt="Navigate with Vroom" height="60"></a>Buildyour link
Fill in the value to get your link.
Questions?Write to us
We answer integrators within a day: contact@vroom-gps.com