Naviga conVroom
Aggiungi un pulsante al tuo sito o alla tua app e i motociclisti aprono il tuo itinerario in Vroom GPS, il GPS moto gratuito. Basta un semplice link. Nessun contratto, nessun account.
Un link,nient’altro
Costruisci un URL su vroom-gps.com/go con esattamente una sorgente e, se vuoi, un nome, un logo e un riferimento per il conteggio. Su un telefono la pagina apre Vroom (o lo store), su un computer mostra un’anteprima.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubSorgenti (esattamente una)
| Parametro | Significato | Esempio |
|---|---|---|
via | Punti di passaggio, da 2 a 50 punti lat,lng separati da ; (nome facoltativo dopo una virgola) | via=45.18,5.72;45.05,6.03,Col |
gpx | URL https pubblico di un file GPX (max 5 MB). Vroom adatta l’itinerario alla traccia. | gpx=https://example.com/r.gpx |
to | Una sola destinazione lat,lng | to=44.94,6.10 |
q | Un nome di luogo o un indirizzo, geocodificato | q=Col+du+Galibier |
trip | L’id di un road trip Vroom (nel suo link di condivisione) | trip=aB3dE9… |
route | L’id di un itinerario ospitato da Vroom (modalità sviluppatore) | route=k7m2p9x4q1z8 |
Opzioni
| Parametro | Significato | Esempio |
|---|---|---|
name | Titolo mostrato nella pagina e nell’app (80 caratteri) | name=Col+du+Galibier |
logo | URL https del tuo logo, mostrato nella pagina (256 px, in cache) | logo=https://example.com/logo.png |
ref | Identificativo libero del tuo sito, solo per il conteggio | ref=mioclub |
lang | Lingua della pagina (2 lettere), quella del browser per impostazione predefinita | lang=it |
L’app non avvia mai la navigazione da sola: il motociclista vede un’anteprima e tocca Avvia. Niente universal link: la pagina passa la richiesta all’app sul telefono.
Modalità sviluppatore:ospitiamo i tuoi GPX
Con una chiave API gratuita invii i tuoi GPX a Vroom, ottieni un link breve per itinerario con il tuo logo e vedi quanti motociclisti hanno aperto e percorso ciascuno. Nessun contratto, la chiave la crei tu.
- 1
Crea una chiave
Accedi al pianificatore web con il tuo account Vroom, apri Sviluppatori, crea una chiave e inserisci nome partner e logo.
- 2
Invia i tuoi itinerari
POST di un file GPX o di una lista di punti. La risposta contiene il link e l’HTML del badge pronto da incollare.
- 3
Segui i numeri
Aperture della pagina, dell’app e navigazioni avviate, per itinerario, con un grafico a 30 giorni, nella dashboard o tramite API.
API REST
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"Quote predefinite: 100 itinerari al giorno, 1 000 itinerari, 5 MB per GPX. Scrivici se te ne servono di più.
Il badgeufficiale
Usa il badge così com’è, chiaro o scuro, nella tua lingua. Non modificarne colori né proporzioni.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/it/navigate-with-vroom-light.png" alt="Naviga con Vroom" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/it/navigate-with-vroom-dark.png" alt="Naviga con Vroom" height="60"></a>Costruisciil tuo link
Inserisci il valore per ottenere il tuo link.
Domande?Scrivici
Rispondiamo agli integratori entro un giorno: contact@vroom-gps.com