10) Envio de Trajeto na Aplicação

Exemplo React Native com Expo Location

O exemplo abaixo mostra como o app pode capturar a localização do aparelho e montar os pontos que serão enviados posteriormente para o endpoint receber_trajeto_aplicacao. A coleta pode ser feita a cada 3 segundos.

Instalação

npx expo install expo-location

Exemplo TypeScript

import * as Location from 'expo-location';

type TrajetoPonto = {
  client_point_id: string;
  data: string;
  hora: string;
  latitude: number;
  longitude: number;
  accuracy: number | null;
  speed: number | null;
  heading: number | null;
  ordem: number;
};

let ordemAtual = 0;
let pontos: TrajetoPonto[] = [];

function formatarDataHora(timestamp: number) {
  const dt = new Date(timestamp);

  const yyyy = dt.getFullYear();
  const mm = String(dt.getMonth() + 1).padStart(2, '0');
  const dd = String(dt.getDate()).padStart(2, '0');

  const hh = String(dt.getHours()).padStart(2, '0');
  const mi = String(dt.getMinutes()).padStart(2, '0');
  const ss = String(dt.getSeconds()).padStart(2, '0');

  return {
    data: `${yyyy}-${mm}-${dd}`,
    hora: `${hh}:${mi}:${ss}`,
  };
}

export async function iniciarColetaTrajeto() {
  const { status } = await Location.requestForegroundPermissionsAsync();

  if (status !== 'granted') {
    throw new Error('Permissão de localização não concedida.');
  }

  const subscription = await Location.watchPositionAsync(
    {
      accuracy: Location.Accuracy.High,
      timeInterval: 3000,
      distanceInterval: 0,
    },
    (location) => {
      ordemAtual += 1;

      const { data, hora } = formatarDataHora(location.timestamp);

      const ponto: TrajetoPonto = {
        client_point_id: `pt_${ordemAtual}`,
        data,
        hora,
        latitude: location.coords.latitude,
        longitude: location.coords.longitude,
        accuracy: location.coords.accuracy ?? null,
        speed: location.coords.speed ?? null,
        heading: location.coords.heading ?? null,
        ordem: ordemAtual,
      };

      pontos.push(ponto);

      // Aqui o app deve salvar o ponto no banco offline local.
      console.log('Ponto coletado:', ponto);
    }
  );

  return subscription;
}

Exemplo de ponto gerado

{
  "client_point_id": "pt_1",
  "data": "2026-04-27",
  "hora": "08:56:00",
  "latitude": -21.85888,
  "longitude": -47.4845167,
  "accuracy": 4.5,
  "speed": null,
  "heading": null,
  "ordem": 1
}

Exemplo de payload

O campo pontos deve ser enviado como string JSON no corpo do POST.

action=apiG10
f=receber_trajeto_aplicacao
id_aplicacao=123
client_event_id=550e8400-e29b-41d4-a716-446655440000
amostragem_segundos=3
observacao=Aplicação realizada no talhão 1
pontos=[
  {
    "client_point_id": "pt_001",
    "data": "2026-04-27",
    "hora": "08:56:00",
    "latitude": -21.8588800,
    "longitude": -47.4845167,
    "accuracy": 4.5,
    "speed": null,
    "heading": null,
    "ordem": 1
  },
  {
    "client_point_id": "pt_002",
    "data": "2026-04-27",
    "hora": "08:56:03",
    "latitude": -21.8588900,
    "longitude": -47.4845300,
    "accuracy": 4.3,
    "speed": null,
    "heading": null,
    "ordem": 2
  },
  {
    "client_point_id": "pt_003",
    "data": "2026-04-27",
    "hora": "08:56:06",
    "latitude": -21.8589000,
    "longitude": -47.4845450,
    "accuracy": 4.2,
    "speed": null,
    "heading": null,
    "ordem": 3
  }
]

Resposta esperada da API

Sucesso HTTP 200

{
  "success": true,
  "msg": "Trajeto da aplicação recebido com sucesso.",
  "data": {
    "id_trajeto": 88,
    "id_aplicacao": 123,
    "client_event_id": "550e8400-e29b-41d4-a716-446655440000",
    "device_id": 26,
    "device_name": "testeG10",
    "account_type": "produtor",
    "total_pontos": 240,
    "inseridos": 240,
    "duplicados": 0,
    "duracao_segundos": 720,
    "sequencia_ok": true,
    "total_gaps": 0,
    "maior_gap_segundos": 3,
    "already_registered": false
  }
}

Reenvio idempotente

{
  "success": true,
  "msg": "Trajeto já registrado.",
  "data": {
    "id_trajeto": 88,
    "id_aplicacao": 123,
    "client_event_id": "550e8400-e29b-41d4-a716-446655440000",
    "already_registered": true
  }
}

Resumo para o desenvolvedor

• O app coleta o trajeto offline e envia depois.
• O envio é feito em um único endpoint.
• O vínculo principal é id_aplicacao.
• O trajeto usa client_event_id, seguindo o padrão do modo offline.
• Cada ponto usa client_point_id.
• O ERP identifica o aparelho pelo X-DEVICE-TOKEN.
• O ERP calcula início, fim, duração, total de pontos e gaps de sequência.