Navegar como Vroom
Adicione um botão ao seu site ou app e os motociclistas abrem o seu percurso no Vroom GPS, o GPS moto gratuito. Basta uma simples ligação. Sem contrato, sem conta.
Uma ligação,nada mais
Construa um URL em vroom-gps.com/go com exatamente uma fonte e, se quiser, um nome, um logótipo e uma referência para a contagem. Num telemóvel a página abre o Vroom (ou a loja), num computador mostra uma pré-visualização.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubFontes (exatamente uma)
| Parâmetro | Significado | Exemplo |
|---|---|---|
via | Pontos de passagem, 2 a 50 pontos lat,lng separados por ; (nome opcional após uma vírgula) | via=45.18,5.72;45.05,6.03,Col |
gpx | URL https público de um ficheiro GPX (máx. 5 MB). O Vroom ajusta o percurso ao trilho. | gpx=https://example.com/r.gpx |
to | Um único destino lat,lng | to=44.94,6.10 |
q | Um nome de local ou uma morada, geocodificado | q=Col+du+Galibier |
trip | O id de um road trip Vroom (na sua ligação de partilha) | trip=aB3dE9… |
route | O id de um percurso alojado pelo Vroom (modo programador) | route=k7m2p9x4q1z8 |
Opções
| Parâmetro | Significado | Exemplo |
|---|---|---|
name | Título mostrado na página e na app (80 caracteres) | name=Col+du+Galibier |
logo | URL https do seu logótipo, mostrado na página (256 px, em cache) | logo=https://example.com/logo.png |
ref | Identificador livre do seu site, apenas para a contagem | ref=meuclube |
lang | Idioma da página (2 letras), o do navegador por predefinição | lang=pt |
A app nunca inicia a navegação sozinha: o motociclista vê uma pré-visualização e toca em Iniciar. Sem universal links: a página entrega o pedido à app no telemóvel.
Modo programador:alojamos os seus GPX
Com uma chave API gratuita envia os seus GPX para o Vroom, obtém uma ligação curta por percurso com o seu logótipo e vê quantos motociclistas abriram e percorreram cada um. Sem contrato, a chave é criada por si.
- 1
Crie uma chave
Inicie sessão no planeador web com a sua conta Vroom, abra Programadores, crie uma chave e indique o nome de parceiro e o logótipo.
- 2
Envie os seus percursos
POST de um ficheiro GPX ou de uma lista de pontos. A resposta inclui a ligação e o HTML do badge pronto a colar.
- 3
Acompanhe os números
Aberturas da página, da app e navegações iniciadas, por percurso, com gráfico de 30 dias, no seu painel ou pela 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"Quotas por predefinição: 100 percursos por dia, 1 000 percursos, 5 MB por GPX. Escreva-nos se precisar de mais.
O badgeoficial
Use o badge tal como está, claro ou escuro, no seu idioma. Não altere as cores nem as proporções.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/pt/navigate-with-vroom-light.png" alt="Navegar com o Vroom" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/pt/navigate-with-vroom-dark.png" alt="Navegar com o Vroom" height="60"></a>Construaa sua ligação
Preencha o valor para obter a sua ligação.
Dúvidas?Escreva-nos
Respondemos aos integradores num dia: contact@vroom-gps.com