Aerial view of precision agriculture fields showing optimized routing patterns

Crie fluxos de trabalho agrícolas prontos para autonomia

Obtenha uma rota em uma única chamada ou integre de forma profunda na plataforma Verge Launch Pad.

Inteligência upstream para autonomia

Nosso roteamento é projetado como uma camada de inteligência upstream para planejadores de missão e pilhas de autonomia.

Intenção do agricultor, capturada no momento do planejamento

Capturamos a intenção do agricultor antes que as máquinas se movam, não apenas telemetria após o fato.

Obter uma Chave de API

  1. 1
    Acesse o Launch Pad: app.vergeag.com
  2. 2
    Acesse Perfil → Gerenciar Chaves de API
  3. 3
    Criar Chave (salve-a, pois não será exibida novamente)
  4. 4
    Use a chave como X-API-KEY no cabeçalho das chamadas à API

Testes e Sandbox: Não há ambiente sandbox dedicado. Para capacidade adicional de testes, envie um e-mail para [email protected] para solicitar créditos de teste (sessão de planejamento de rota por uso).

Início Rápido

Uma chamada, uma rota planejada (sem configuração necessária). Ver referência da API

Entradas

  • • Polígono do talhão (ou multi-polígono), largura de faixa, passadas de cabeceira, direção preferida

Unidades

Unidades métricas (metros, segundos). Suporte a unidades imperiais em breve.

Saídas

Duas variantes: JSON enriquecido ou GeoJSON padrão (trilhas, cabeceiras, conectores, curvas) + métricas (tempo, distância, sobreposição).

Exemplos 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

Integração profunda via entidades e jobs (somente polling). Ver todos os endpoints

Autenticação

Chave de API

E/S de Limites

GeoJSON/WKT/KML

Jobs de Guiagem em Lote

Envie e faça polling a cada 5 segundos até concluir

Formatos de Exportação

ISO-XML, Shapefile, John Deere, CNH, Trimble, KML, além de envio direto para o JD Operations Center e portais CNH

Fluxo

Importar limite Criar job Polling (5s) Recuperar resultados Exportar

Qual API devo usar?

Início Rápido

2 endpoints simples para roteamento rápido

Acesso rápido aos planos sem login
Interface simples em uma única chamada
Requisições de roteamento sem estado
Prototipagem e testes rápidos

Ideal para:

POCs, demonstrações, integrações simples

Plataforma Completa

Suite completa de APIs para integrações avançadas

Armazene talhões, projetos e dados de usuários
Personalize projetos e reutilize rotas
Rastreie telemetria e operações
Suporte a múltiplos usuários e organizações

Ideal para:

Robótica, plataformas FMIS, ferramentas de revendedores, produtos complexos

Funcionalidades

Cobertura e Geração de Passadas

Faixas, cabeceiras, conectores, AB/A+

Curvas e Cinemática

Estratégias, limites de curvatura/jerk, restrições do veículo

Obstáculos e Geometria

Zonas de exclusão, corredores não convexos/estreitos, áreas proibidas

Terreno e Operações

Consciência de declive (Beta), entrada/saída/preparação, sequenciamento (Beta)

Otimização

Trade-offs de tempo/distância/combustível, KPIs de sobreposição/salto

E/S de Dados

Formatos/adaptadores, jobs em lote/concorrência

Docs & Ferramentas

Referência Interativa da API

Documentação OpenAPI completa com testes de requisições ao vivo, schemas e exemplos

Explorar

Nota: Nenhum SDK necessário

FAQ

Há suporte a obstáculos?

Sim: zonas de exclusão, buffers, validação de corredores.

Posso usar unidades imperiais?

Unidades métricas (metros/segundos) são suportadas agora; suporte a unidades imperiais em breve.

Webhooks são suportados?

Não; os jobs usam polling (a cada 5s).

Como comparar planos de rota?

Use os KPIs (tempo, distância, sobreposição, área não coberta, curvas).

Limites de Taxa & Suporte

Limites de Taxa

HTTP 429 quando excedido; implemente backoff exponencial.

Suporte

Sem SLAs formais. Analisamos problemas dentro de 1 dia útil durante o horário comercial norte-americano e fazemos o possível para resolver.

E-mail: [email protected]

Versionamento e Descontinuação

Para mudanças que quebrem compatibilidade, enviaremos e-mail aos usuários afetados e publicaremos atualizações em vergeag.com/developers.