Навигирай сVroom
Добави бутон в сайта или приложението си и мотористите отварят маршрута ти във Vroom GPS, безплатния GPS за мотор. Достатъчна е обикновена връзка. Без договор, без профил.
Една връзка,нищо повече
Създай URL на vroom-gps.com/go с точно един източник и, ако искаш, име, лого и референция за отчитане. На телефон страницата отваря Vroom (или магазина), на компютър показва преглед.
https://vroom-gps.com/go?gpx=https://example.com/galibier.gpx&name=Col+du+Galibier&ref=myclubИзточници (избери точно един)
| Параметър | Значение | Пример |
|---|---|---|
via | Междинни точки, от 2 до 50 точки lat,lng, разделени с ; (по избор име след запетая) | via=45.18,5.72;45.05,6.03,Col |
gpx | Публичен https URL на GPX файл (макс. 5 MB). Vroom напасва маршрута към трака. | gpx=https://example.com/r.gpx |
to | Една дестинация lat,lng | to=44.94,6.10 |
q | Име на място или адрес, геокодиран | q=Col+du+Galibier |
trip | Id на мотопътешествие във Vroom (от връзката му за споделяне) | trip=aB3dE9… |
route | Id на маршрут, хостван от Vroom (режим за разработчици) | route=k7m2p9x4q1z8 |
Опции
| Параметър | Значение | Пример |
|---|---|---|
name | Заглавие, показано на страницата и в приложението (80 знака) | name=Col+du+Galibier |
logo | https URL на логото ти, показано на страницата (256 px, кеширано) | logo=https://example.com/logo.png |
ref | Свободен идентификатор на сайта ти, използван само за отчитане | ref=myclub |
lang | Език на страницата (2 букви), по подразбиране езикът на браузъра | lang=fr |
Приложението никога не стартира навигацията само: мотористът вижда преглед и докосва „Старт“. Universal links не се използват, страницата предава заявката на приложението на телефона.
Режим за разработчици:хостваме твоите GPX
С безплатен API ключ качваш GPX файловете си във Vroom, получаваш кратка връзка за всеки маршрут с твоето лого и виждаш колко мотористи са отворили и карали всеки от тях. Без договор, сам създаваш ключа.
- 1
Създай ключ
Влез в уеб планировчика на Vroom с профила си във Vroom, отвори „Разработчици“, създай ключ и задай името и логото си на партньор.
- 2
Качи маршрутите си
Изпрати с POST GPX файл или списък с междинни точки. Отговорът съдържа връзката и HTML кода на значката, готов за поставяне.
- 3
Следи числата
Отваряния на страницата, отваряния на приложението и стартирани навигации, по маршрут, с графика за 30 дни, в таблото ти или чрез 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"
Квоти по подразбиране: 100 маршрута на ден, 1000 маршрута, 5 MB на GPX. Пиши ни, ако ти трябват повече.
Официалнатазначка
Използвай значката такава, каквато е, светла или тъмна, на твоя език. Не променяй цветовете или пропорциите ѝ.
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/bg/navigate-with-vroom-light.png" alt="Навигирай с Vroom" height="60"></a>
<a href="https://vroom-gps.com/go?route=YOUR_ROUTE_ID"><img src="https://vroom-gps.com/images/badges/bg/navigate-with-vroom-dark.png" alt="Навигирай с Vroom" height="60"></a>
Създайсвоята връзка
Попълни стойността, за да получиш връзката си.
Въпроси?Пиши ни
Отговаряме на интеграторите до един ден: contact@vroom-gps.com