Rastreamento e DispositivosTrack (Tempo Real)

Track (Tempo Real)

Obtém a última posição/coordenada de rastreamento do dispositivo em tempo real.

Requisição HTTP

MétodoCaminho (Path)
GET/api/track

Parâmetros de Consulta (Query)

ParâmetroTipoObrigatórioDescrição
access_tokenstringtrueO token de acesso.
imeisstringtrueLista de IMEIs de destino, separados por vírgula, no máximo 100 IMEIs por chamada.

Exemplo

Request URL:

GET https://api.brasilsatgps.com.br/api/track?access_token={ACCESS_TOKEN}&imeis=358899123456789,355139000000234

Estrutura de Retorno (Schema)

Campo JSONTipo de DadoDescrição
recordArrayLista de objetos de status dos alvos.
record[].imeistringO IMEI do dispositivo de destino.
record[].servertimelongHora atual do servidor (carimbo de data/hora UNIX em segundos).
record[].gpstimelongHora do GPS (carimbo de data/hora UNIX em segundos).
record[].hearttimelongHora de pulso/heartbeat, última vez que o alvo enviou dados (carimbo de data/hora UNIX).
record[].systemtimelongHora no sistema do servidor quando os dados de GPS foram recebidos (carimbo de data/hora UNIX em segundos).
record[].longitudedoubleLongitude.
record[].latitudedoubleLatitude.
record[].courseintDireção (Norte é 0, aumento no sentido horário, no máximo 360).
record[].speedintVelocidade (KM/H).
record[].acctimelongACC status kept time interval in seconds.
record[].accstatusintACC status.
1: ACC ON
0: ACC OFF
-1: No acc status
record[].doorstatusintStatus de portas.
1: Porta aberta
0: Porta fechada
-1: Sem status disponível
record[].chargestatusintStatus de carregamento.
1: Carregando
0: Não está carregando
-1: Sem status disponível
record[].oilpowerstatusintStatus de combustível/bloqueio.
1: Combustível liberado
0: Combustível cortado
-1: Sem status disponível
record[].defencestatusintStatus do alarme físico/defesa.
1: Defesa Ativada
0: Defesa Desativada
-1: Sem status disponível
record[].datastatusintStatus de dados.
1: Nunca online
2: OK
3: Expirado
4: Offline
5: Bloqueado
record[].batteryintBateria interna do dispositivo.
-1: Sem status de bateria disponível
record[].mileageintQuilometragem (unidade: metros).
-1: Sem quilometragem disponível
record[].todaymileageintQuilometragem de hoje (unidade: metros).
-1: Sem quilometragem de hoje disponível
record[].externalpowerstringTensão externa (unidade: V).
"": Sem tensão externa
record[].fuelstringNível de Combustível (unidade: L).
"": Sem medição de combustível
record[].fueltimelongHora de combustível, última vez que o alvo enviou dados de combustível (carimbo de data/hora UNIX).
0: Sem medição de combustível
record[].temperaturearrayTemperatura (unidade: ℃). Se o dispositivo tiver múltiplos sensores: ["30.90", "31.70"]. []: Sem temperatura disponível
record[].temperaturetimelongHora da temperatura, última vez que o alvo enviou dados de temperatura (carimbo de data/hora UNIX).
0: Sem dados de temperatura

Exemplo de Resposta JSON

{
  "record": [
    {
      "imei": "358899123456789",
      "course": 195,
      "systemtime": 1419905754,
      "gpstime": 1419906052,
      "speed": 0,
      "hearttime": 1419906952,
      "servertime": 1420964313,
      "longitude": 113.909813,
      "latitude": 22.583197,
      "acctime": 1400,
      "accstatus": 1,
      "doorstatus": 0,
      "chargestatus": 0,
      "oilpowerstatus": 1,
      "defencestatus": 0,
      "datastatus": 2,
      "battery": 100,
      "mileage": 51654,
      "todaymileage": 15654,
      "externalpower": "12.1",
      "fuel": "2.6",
      "fueltime": 1419906052,
      "temperature": ["21.2"],
      "temperaturetime": 1419906052
    }
  ],
  "code": 0
}

Mais Informações

Para obter o status de um dispositivo, você pode seguir o fluxograma abaixo: