v2025.03 — Baseado em documentacao oficial
API Mapping
Monitoramento de Maquinas Agricolas e de Construcao
Mapeamento tecnico das APIs da John Deere / Wirtgen Group e Hitachi Construction Machinery para desenvolvimento de aplicativo de monitoramento de frota. Todos os dados sao baseados exclusivamente na documentacao oficial das fabricantes.
21
Endpoints Mapeados
2
Fabricantes
ISO
15143-3 / AEMP 2.0
10min
Freq. Minima (Hitachi)
Proprietario + ISO 15143-3
John Deere Operations Center API
Precision Tech APIs — Gestao de Equipamentos e Frota
11 endpoints
Pre-requisito: Organizations
O endpoint GET /organizations e obrigatorio como ponto de partida. Sem listar as organizacoes do usuario autenticado, nao e possivel chamar nenhum endpoint que depende de {orgId}. A conexao entre a aplicacao e a organizacao do usuario e feita via https://connections.deere.com.
GET
/organizations
Listar Organizacoes
Retorna as organizacoes vinculadas ao usuario autenticado. Ponto de partida obrigatorio para todos os demais endpoints. Inclui links para recursos de cada organizacao (machines, fields, assets, etc).
GET
/equipment
Listar Equipamentos
Retorna a lista de equipamentos (maquinas e implementos) associados a uma organizacao. Suporta filtros por categoria, conectividade e IDs de organizacao. Substitui as antigas APIs separadas de Machines e Implements (depreciadas em Jan/2025).
GET
/equipment/{id}
Detalhes do Equipamento
Retorna informacoes detalhadas de uma maquina especifica, incluindo especificacoes tecnicas, estado atual de conectividade e dispositivos pareados.
GET
/organizations/{orgId}/machineLocations
Localizacoes de Maquinas
Fornece o historico de localizacao GPS das maquinas de uma organizacao. Permite rastreamento em tempo real e analise de rotas percorridas.
GET
/organizations/{orgId}/machineAlerts
Alertas de Maquinas (DTC)
Retorna alertas e codigos de falha (Diagnostic Trouble Codes) gerados pelas maquinas. Inclui severidade, descricao e timestamp. Tipos de alerta: machine, geofence e maintenance.
GET
/organizations/{orgId}/machineEngineHours
Horas de Motor (Cumulativas)
Retorna as horas cumulativas de operacao do motor de cada maquina. Dado fundamental para controle de depreciacao e agendamento de manutencao.
GET
/organizations/{orgId}/machineHoursOfOperation
Horas de Operacao (Ligado/Desligado)
Fornece as duracoes em que o motor esteve ligado ou desligado em um periodo especifico. Difere de Engine Hours por oferecer intervalos temporais detalhados em vez de apenas o valor cumulativo.
GET
/organizations/{orgId}/machineDistanceTraveled
Distancia Percorrida
Retorna a distancia total percorrida por cada maquina. Util para controle de quilometragem, logistica e calculo de desgaste mecanico.
GET
/organizations/{orgId}/machineDeviceStateReports
Estado do Dispositivo
Fornece o estado atual do dispositivo telematico instalado na maquina, incluindo nivel de combustivel, estado do motor e status de conectividade.
GET
/organizations/{orgId}/assets
Assets (Ativos Rastreados)
Gerencia ativos rastreados que nao sao necessariamente maquinas John Deere, permitindo integracao de equipamentos de terceiros na plataforma.
POST
/webhooks
Webhooks — Notificacoes em Tempo Real
Configura webhooks para receber notificacoes em tempo real quando eventos ocorrem (alertas, mudancas de estado, novas localizacoes). A JD tambem oferece Data Subscription Service para eventos mais granulares (flags, map layers, etc).
Equipment Measurements (POST) — Integracao de Terceiros
O endpoint POST /organizations/{orgId}/equipment/{id}/measurements permite enviar dados telematicos de equipamentos de terceiros (nao-JD) para o Operations Center. Relevante caso o cliente deseje consolidar dados de maquinas Hitachi no ambiente JD. Disponivel via equipmentapi.deere.com.
ISO 15143-3 / AEMP 2.0
John Deere — ISO 15143-3 (AEMP 2.0)
Padrao de Interoperabilidade para Frotas Mistas
2 endpoints
GET
/Fleet/{pageNumber}
Fleet Snapshot — Visao Geral da Frota
Endpoint principal do padrao AEMP 2.0. Retorna um snapshot com os dados mais recentes de todos os equipamentos da frota, paginado a cada 100 registros. Inclui: localizacao, horas cumulativas, combustivel, status do motor, idle hours e distancia percorrida.
GET
/Fleet/Equipment/{vin}
Dados AEMP de Equipamento Especifico
Retorna os dados telematicos padronizados de um equipamento especifico usando seu VIN (Vehicle Identification Number) ou PIN. Formato de resposta em XML ou JSON via header Accept.
AEMP 1.2 + ISO 15143-3 / AEMP 2.0
Hitachi Construction Machinery — Telematics API
Global e-Service — AEMP 1.2 e ISO 15143-3 (AEMP 2.0)
8 endpoints
GET
/Fleet/{pageNumber}
Fleet Snapshot — Visao Geral da Frota Hitachi
Endpoint principal de Fleet Snapshot. Retorna a ultima posicao conhecida, horas e combustivel de todas as maquinas Hitachi da frota. Paginado a cada 100 registros.
GET
/Fleet/Equipment/{vin}/Locations
Historico de Localizacoes
Serie temporal para historico de localizacoes de uma maquina Hitachi especifica. Permite reconstruir rotas e analisar padroes de deslocamento.
GET
/Fleet/Equipment/{vin}/CumulativeOperatingHours
Horas de Operacao Cumulativas
Retorna o historico de horas de operacao cumulativas de uma maquina Hitachi. Dado vital para controle de depreciacao, manutencao preventiva e faturamento de locacao.
GET
/Fleet/Equipment/{vin}/CumulativeFuelUsed
Combustivel Consumido Cumulativo
Dados de consumo de combustivel ao longo do tempo para uma maquina Hitachi especifica. Permite analises de eficiencia e calculo de custos operacionais.
GET
/Fleet/Equipment/{vin}/CumulativeIdleHours
Horas de Marcha Lenta (Idle Hours)
Retorna as horas em que a maquina esteve ligada mas ociosa (motor funcionando sem trabalho produtivo). Crucial para identificar desperdicio de combustivel.
GET
/Fleet/Equipment/{vin}/DistanceTraveled
Distancia Percorrida
Retorna a distancia acumulada percorrida pela maquina. Dado padrao do AEMP 2.0, util para logistica e calculo de desgaste. Disponibilidade varia por modelo e regiao.
GET
/Fleet/Equipment/{vin}/Faults
Codigos de Falha (DTC)
Retorna os codigos de falha ativos e historicos de uma maquina Hitachi para diagnostico remoto. Extensao do padrao AEMP 2.0 com dados de saude da maquina.
P-API (Proprietaria) — Dados Estendidos
A Hitachi oferece uma API proprietaria (P-API) que, alem dos dados AEMP/ISO, fornece informacoes adicionais como: temperatura do oleo hidraulico, emissoes de CO2, horas de escavacao e giro, e payload em carregadeiras ZW-7. O acesso e exclusivo via dealer e nao possui documentacao publica. Deve ser considerada caso o projeto necessite de dados alem do padrao AEMP.
Cobertura de Dados por Fabricante
Comparativo de disponibilidade de dados entre as APIs John Deere/Wirtgen e Hitachi
Categoria de Dados
John Deere
Hitachi
Localizacao GPS
100%
100%
Horas de Operacao
100%
100%
Consumo de Combustivel
80%
100%
Horas de Marcha Lenta
90%
100%
Distancia Percorrida
90%
70%
Codigos de Falha (DTC)
100%
80%
Notificacoes em Tempo Real
100%
40%
Dados de Operacao (WPT)
100%
40%
Alertas de Geofence
70%
40%
Geofences — Correcao Importante
A JD nao possui um endpoint publico dedicado para criacao/edicao de geofences via API. Os alertas de geofence sao um tipo de alerta retornado pela Machine Alerts API quando configurados no Operations Center UI. A coluna reflete apenas leitura de alertas de geofence, nao gestao completa.
Comparativo Tecnico
Parametro
John Deere / Wirtgen
Hitachi
Padrao
ISO 15143-3 + Proprietario
AEMP 1.2 + ISO 15143-3
Autenticacao
OAuth 2.0 (Auth Code)
OAuth 2.0 (Client Cred.)
Freq. API AEMP
Cache 1 hora (min.)
10 min | 60 min | 24h
Freq. Proprietaria
5s (WPT) — dados de campo
P-API via dealer
Acesso
developer.deere.com
Via dealer autorizado
Sandbox
sandboxapi.deere.com
Nao disponivel publicamente
Webhooks
Sim (nativo)
Nao documentado
Frota Mista
Sim (Assets API + AEMP)
Sim (via AEMP 2.0)
Formato Resposta
JSON (principal) / XML
XML (padrao) / JSON
Casos de Uso Recomendados
Aplicacoes praticas para o aplicativo de monitoramento
Dashboard Unificado de Frota
Usar os endpoints Fleet Snapshot (AEMP 2.0) de ambas as fabricantes para exibir todas as maquinas em um unico mapa interativo, independente da marca.
JD AEMP /Fleet/{page}
Hitachi /Fleet/{page}
Gestao de Eficiencia de Combustivel
Cruzar CumulativeFuelUsed com CumulativeIdleHours para identificar maquinas com alto indice de ociosidade e gerar relatorios de economia.
Hitachi /CumulativeFuelUsed
Hitachi /CumulativeIdleHours
JD /machineDeviceStateReports
Manutencao Preditiva
Monitorar machineAlerts e Faults para notificar mecanicos imediatamente quando um codigo de erro grave (DTC) for emitido por qualquer maquina da frota.
JD /machineAlerts
Hitachi /Faults
JD POST /webhooks
Controle de Horas e Faturamento
Usar CumulativeOperatingHours para automatizar o faturamento de maquinas alugadas e agendar revisoes preventivas com base em horas reais de uso.
JD /machineEngineHours
JD /machineHoursOfOperation
Hitachi /CumulativeOperatingHours
Rastreamento e Logistica
Combinar dados de localizacao e distancia percorrida para otimizar rotas, calcular tempo de deslocamento entre obras e controlar quilometragem.
JD /machineLocations
JD /machineDistanceTraveled
Hitachi /Locations
Hitachi /DistanceTraveled
Referencias Oficiais
Fontes utilizadas para o mapeamento — toda a informacao e baseada em documentacao publica
1John Deere Developer Portal — Operations Center Equipment API
2John Deere Developer Portal — ISO 15143-3 (AEMP 2.0)
3John Deere Developer Portal — Machine Alerts
4John Deere Developer Portal — Machine Device State Reports
5John Deere Developer Portal — Machine Hours of Operation
6John Deere Developer Portal — Machine Distance Traveled
7John Deere Developer Portal — Equipment Measurements (POST)
8John Deere Developer Portal — Organizations API
9Wirtgen Group — FAQ John Deere Operations Center Construction
10Wirtgen Group — Quick User Guide Operations Center (PDF)
11Hitachi Construction Machinery — Telematics API (Global)
12Hitachi Construction Machinery — Telematics API (Europe)
13Hitachi — Meets growing demand for mixed fleet data
14Hitachi — P-API Proprietary Data (via dealer documentation)
15Hiboo Help Center — Hitachi API Credentials
16AutoPi — AEMP 2.0 Explained: Mixed-Fleet Telematics Standard
17Caterpillar Digital — ISO 15143-3 (AEMP 2.0) API Developer Guide
18Geoforce — AEMP/ISO 15143-3 Mixed-Fleet Data Ingestion
19Esri — Connecting to John Deere JDLink Machine Data API (PDF)
20GitHub — deere-sdk: Unofficial TypeScript SDK for John Deere API