Создавайте агрономические рабочие процессы, готовые к автономной работе
Получите маршрут за один вызов или глубоко интегрируйтесь в платформу Verge Launch Pad.
Интеллект верхнего уровня для автономной работы
Наша маршрутизация разработана как слой интеллекта верхнего уровня для планировщиков миссий и стеков автономии.
Намерение агронома, зафиксированное на этапе планирования
Мы фиксируем намерение агронома до того, как машины начнут движение, а не только телеметрию по факту.
Получение ключа API
-
1
Войдите в Launch Pad: app.vergeag.com
-
2
Перейдите в Профиль → Управление ключами API
-
3
Создайте ключ (сохраните его, он больше не будет показан)
-
4
Используйте ключ как заголовок
X-API-KEYв вызовах API
Тестирование и Sandbox: Выделенной среды sandbox нет. Для дополнительной тестовой мощности напишите на [email protected] с просьбой предоставить тестовые кредиты (сессия планирования маршрута с оплатой по использованию).
Быстрый Старт
Один вызов — один спланированный маршрут (без предварительной настройки). Справочник API
Входные данные
- • Полигон поля (или мультиполигон), ширина захвата, проходы по поворотной полосе, предпочтительный азимут
Единицы измерения
Метрические единицы (метры, секунды). Поддержка имперских единиц появится позже.
Выходные данные
Два варианта: расширенный JSON или стандартный GeoJSON (проходы, поворотные полосы, коннекторы, повороты) + метрики (время, расстояние, перекрытие).
Примеры кода
Bash
curl -X POST https://app.vergeag.com/api/path-plans/direct \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "field": { "type":"Polygon","coordinates":[[[lon,lat],[...],[lon,lat]]] },
"machine": { "widthMeters": 12 },
"headland": { "passes": 2 },
"tracks": { "preferredDirectionDegrees": 90 } }'
JavaScript
const res = await fetch("https://app.vergeag.com/api/path-plans/direct", {
method: "POST",
headers: {
"X-API-KEY": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
field: { type: "Polygon", coordinates: [[[lon,lat], ...]] },
machine: { widthMeters: 12 },
headland: { passes: 2 },
tracks: { preferredDirectionDegrees: 90 }
})
});
const plan = await res.json();
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-KEY", "YOUR_API_KEY");
var content = new StringContent(payloadJson, Encoding.UTF8, "application/json");
var res = await client.PostAsync("https://app.vergeag.com/api/path-plans/direct", content);
var json = await res.Content.ReadAsStringAsync();
Полная Платформа
Глубокая интеграция через сущности и jobs (только polling). Все endpoints
Аутентификация
Ключ API
Ввод/вывод границ
GeoJSON/WKT/KML
Пакетные задания навигации
Отправить и выполнять polling каждые 5 секунд до завершения
Форматы экспорта
ISO-XML, Shapefile, John Deere, CNH, Trimble, KML, а также прямая отправка в JD Operations Center и порталы CNH
Поток
Какой API использовать?
Быстрый Старт
2 простых endpoint для быстрой маршрутизации
Подходит для:
POC, демонстраций, простых интеграций
Полная Платформа
Полный набор API для продвинутых интеграций
Подходит для:
Робототехники, платформ FMIS, инструментов дилеров, сложных продуктов
Возможности
Покрытие и генерация проходов
Проходы, поворотные полосы, коннекторы, AB/A+
Повороты и кинематика
Стратегии, ограничения кривизны/jerk, ограничения транспортного средства
Препятствия и геометрия
Зоны исключения, невыпуклые/узкие коридоры, запретные зоны
Рельеф и операции
Учёт уклона (Beta), въезд/выезд/постановка, последовательность (Beta)
Оптимизация
Компромисс время/расстояние/топливо, KPIs перекрытие/пропуск
Ввод/вывод данных
Форматы/адаптеры, пакетные задания/параллелизм
Docs & Инструменты
Интерактивный справочник API
Полная документация OpenAPI с живым тестированием запросов, схемами и примерами
Примечание: SDK не требуются
FAQ
Поддерживаются ли препятствия?
Да: зоны исключения, буферы, валидация коридоров.
Можно ли использовать имперские единицы?
Метрические единицы (метры/секунды) поддерживаются сейчас; поддержка имперских единиц появится позже.
Поддерживаются ли вебхуки?
Нет; задания используют polling (каждые 5s).
Как сравнивать планы маршрутов?
Используйте KPIs (время, расстояние, перекрытие, непокрытое, повороты).
Лимиты запросов & Поддержка
Лимиты запросов
HTTP 429 при превышении; реализуйте экспоненциальную задержку.
Поддержка
Без формальных SLA. Мы рассматриваем проблемы в течение 1 рабочего дня в рабочее время Северной Америки и стараемся их решить.
E-mail: [email protected]
Версионирование и устаревание
При критических изменениях мы отправим письмо затронутым пользователям и опубликуем обновления на vergeag.com/developers.