Aerial view of precision agriculture fields showing optimized routing patterns

Créez des flux de travail agricoles prêts pour l'autonomie

Obtenez un itinéraire en un seul appel, ou intégrez en profondeur dans la plateforme Verge Launch Pad.

Intelligence en amont pour l'autonomie

Notre routage est conçu comme une couche d'intelligence en amont pour les planificateurs de missions et les piles d'autonomie.

L'intention de l'agriculteur, capturée au moment de la planification

Nous capturons l'intention de l'agriculteur avant que les machines ne bougent, pas seulement la télémétrie après coup.

Obtenir une Clé API

1
Connectez-vous à Launch Pad : app.vergeag.com
2
Accédez à Profil → Gérer les clés API
3
Créer la clé (sauvegardez-la, elle ne sera plus affichée)
4
Utilisez la clé comme en-tête X-API-KEY dans les appels API

Tests et Sandbox : Pas d'environnement sandbox dédié. Pour une capacité de test supplémentaire, envoyez un e-mail à [email protected] pour demander des crédits de test (session de planification de route à l'usage).

Démarrage Rapide

Un appel, un itinéraire planifié (sans configuration requise). Voir la référence API

Entrées

• Polygone de parcelle (ou multi-polygone), largeur de passage, passes de tournière, cap préférentiel

Unités

Unités métriques (mètres, secondes). Support des unités impériales à venir.

Sorties

Deux variantes : JSON enrichi ou GeoJSON standard (pistes, tournières, connecteurs, virages) + métriques (temps, distance, chevauchement).

Exemples de Code

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

Plateforme Complète

Intégration approfondie via entités et jobs (polling uniquement). Parcourir tous les endpoints

Authentification

Clé API

E/S de Délimitations

GeoJSON/WKT/KML

Jobs de Guidage en Lot

Soumettre et faire du polling toutes les 5 secondes jusqu'à la fin

Formats d'Export

ISO-XML, Shapefile, John Deere, CNH, Trimble, KML, plus envoi direct vers JD Operations Center et les portails CNH

Flux

Importer la délimitation Créer un job Polling (5s) Récupérer les résultats Exporter

Quelle API dois-je utiliser ?

Démarrage Rapide

2 endpoints simples pour un routage rapide

Accès rapide aux plans sans connexion

Interface simple en un seul appel

Requêtes de routage sans état

Prototypage et tests rapides

Idéal pour :

POCs, démonstrations, intégrations simples

Plateforme Complète

Suite API complète pour les intégrations avancées

Stocker les parcelles, projets et données utilisateurs

Personnaliser les projets et réutiliser les itinéraires

Suivre la télémétrie et les opérations

Support multi-utilisateurs et organisations

Idéal pour :

Robotique, plateformes FMIS, outils revendeurs, produits complexes

Fonctionnalités

Couverture et Génération de Passages

Pistes, tournières, connecteurs, AB/A+

Virages et Cinématique

Stratégies, limites de courbure/jerk, contraintes du véhicule

Obstacles et Géométrie

Zones d'exclusion, corridors non convexes/étroits, zones interdites

Terrain et Opérations

Conscience de la pente (Beta), entrée/sortie/mise en place, séquençage (Beta)

Optimisation

Compromis temps/distance/carburant, KPIs chevauchement/saut

E/S de Données

Formats/adaptateurs, jobs en lot/concurrence

Docs & Outils

Référence API Interactive

Documentation OpenAPI complète avec tests de requêtes en direct, schémas et exemples

Explorer

Remarque : Aucun SDK requis

FAQ

Gère-t-il les obstacles ?

Oui : zones d'exclusion, tampons, validation de corridors.

Puis-je utiliser les unités impériales ?

Les unités métriques (mètres/secondes) sont supportées maintenant ; support des unités impériales à venir.

Les webhooks sont-ils supportés ?

Non ; les jobs utilisent le polling (toutes les 5s).

Comment comparer des plans de route ?

Utilisez les KPIs (temps, distance, chevauchement, non couvert, virages).

Limites de Taux & Support

Limites de Taux

HTTP 429 en cas de dépassement ; implémenter un backoff exponentiel.

Support

Pas de SLA formels. Nous examinons les problèmes sous 1 jour ouvré pendant les heures ouvrables nord-américaines et faisons de notre mieux pour les résoudre.

E-mail : [email protected]

Versionnement et Dépréciation

Pour les changements cassants, nous enverrons un e-mail aux utilisateurs concernés et publierons les mises à jour sur vergeag.com/developers.