Aerial view of precision agriculture fields showing optimized routing patterns

Construye flujos de trabajo agrícolas listos para la autonomía

Obtén una ruta en una sola llamada, o integra en profundidad en toda la plataforma Verge Launch Pad.

Inteligencia upstream para la autonomía

Nuestro enrutamiento está diseñado como una capa de inteligencia upstream para planificadores de misiones y pilas de autonomía.

Intención del agricultor, capturada en el momento de planificación

Capturamos la intención del agricultor antes de que las máquinas se muevan, no solo telemetría después del hecho.

Obtener una Clave de API

  1. 1
    Inicia sesión en Launch Pad: app.vergeag.com
  2. 2
    Navega a Perfil → Gestionar Claves de API
  3. 3
    Crear Clave (guárdala, no se mostrará de nuevo)
  4. 4
    Usa la clave como X-API-KEY en el encabezado de las llamadas a la API

Pruebas y Sandbox: No existe un entorno sandbox dedicado. Para capacidad adicional de pruebas, escribe a [email protected] para solicitar créditos de prueba (sesión de planificación de ruta por uso).

Inicio Rápido

Una llamada, una ruta planificada (sin configuración previa). Ver referencia de la API

Entradas

  • • Polígono del campo (o multi-polígono), ancho de franja, pasadas de cabecera, orientación preferida

Unidades

Unidades métricas (metros, segundos). Soporte a unidades imperiales próximamente.

Salidas

Dos variantes: JSON enriquecido o GeoJSON estándar (pistas, cabeceras, conectores, giros) + métricas (tiempo, distancia, solapamiento).

Ejemplos de Código

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();

Plataforma Completa

Integración profunda mediante entidades y jobs (solo polling). Ver todos los endpoints

Autenticación

Clave de API

E/S de Límites

GeoJSON/WKT/KML

Jobs de Guiado en Lote

Envía y haz polling cada 5 segundos hasta completar

Formatos de Exportación

ISO-XML, Shapefile, John Deere, CNH, Trimble, KML, más envío directo al JD Operations Center y portales CNH

Flujo

Importar límite Crear job Polling (5s) Recuperar resultados Exportar

¿Qué API debo usar?

Inicio Rápido

2 endpoints simples para enrutamiento rápido

Acceso rápido a planes sin inicio de sesión
Interfaz simple en una sola llamada
Solicitudes de enrutamiento sin estado
Prototipado y pruebas rápidas

Ideal para:

POCs, demos, integraciones simples

Plataforma Completa

Suite completa de APIs para integraciones avanzadas

Almacena campos, proyectos y datos de usuarios
Personaliza proyectos y reutiliza rutas
Rastrea telemetría y operaciones
Soporte multiusuario y para organizaciones

Ideal para:

Robótica, plataformas FMIS, herramientas para distribuidores, productos complejos

Capacidades

Cobertura y Generación de Pasadas

Franjas, cabeceras, conectores, AB/A+

Giros y Cinemática

Estrategias, límites de curvatura/jerk, restricciones del vehículo

Obstáculos y Geometría

Zonas de exclusión, corredores no convexos/estrechos, áreas prohibidas

Terreno y Operaciones

Conciencia de pendiente (Beta), entrada/salida/preparación, secuenciación (Beta)

Optimización

Compensaciones tiempo/distancia/combustible, KPIs de solapamiento/salto

E/S de Datos

Formatos/adaptadores, jobs en lote/concurrencia

Docs y Herramientas

Referencia Interactiva de la API

Documentación OpenAPI completa con pruebas de solicitudes en vivo, esquemas y ejemplos

Explorar

Nota: No se requieren SDKs

FAQ

¿Maneja obstáculos?

Sí: zonas de exclusión, buffers, validación de corredores.

¿Puedo usar unidades imperiales?

Las unidades métricas (metros/segundos) son compatibles ahora; soporte a unidades imperiales próximamente.

¿Se admiten webhooks?

No; los jobs usan polling (cada 5s).

¿Cómo comparo planes de ruta?

Usa los KPIs (tiempo, distancia, solapamiento, área no cubierta, giros).

Límites de Tasa y Soporte

Límites de Tasa

HTTP 429 cuando se supera; implementa backoff exponencial.

Soporte

Sin SLAs formales. Revisamos los problemas dentro de 1 día hábil durante el horario laboral de América del Norte y hacemos lo posible por resolverlos.

Correo electrónico: [email protected]

Versionado y Discontinuación

Para cambios que rompan la compatibilidad, enviaremos un correo a los usuarios afectados y publicaremos actualizaciones en vergeag.com/developers.