curl --request GET \
--url https://api.ugps.io/api/trackers/live-status \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ugps.io/api/trackers/live-status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ugps.io/api/trackers/live-status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ugps.io/api/trackers/live-status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ugps.io/api/trackers/live-status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ugps.io/api/trackers/live-status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ugps.io/api/trackers/live-status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"data": [
{
"flespiId": "6512345",
"live": {
"connectionStatus": "just_registered",
"lastContactAt": 1763128800,
"lastFixReceivedAt": 1763128800,
"position": {
"latitude": -33.4489,
"longitude": -70.6693
},
"positionAt": 1763128795,
"movementStatus": "moving",
"stationarySince": 1763125200,
"speedKmh": 0,
"ignitionOn": false
},
"counters": {
"odometer": {
"km": 118000,
"source": "device",
"stale": true
},
"engineHours": {
"hours": 5321.5,
"source": "device",
"stale": true
}
}
}
]
}{
"error": "Token inválido o expirado"
}{
"error": "No tiene permisos para realizar esta acción"
}{
"message": "Error interno del servidor"
}Estado en vivo de los trackers
Una fila por tracker del alcance del usuario (su empresa y, si lo tiene, su acceso a vehículos), con la posición, el estado de conexión y el movimiento que mantiene el servicio en tiempo real, la misma fuente que el mapa. El estado de conexión se resuelve al leer, con la hora actual, a partir del último contacto y el último fix recibido: puede adelantarse hasta 3 minutos al que muestra el mapa. El movement status es el que calcula el servicio en tiempo real con el perfil de detección del tracker: en el perfil de ignición, con la ignición apagada queda estacionado aunque tenga velocidad.
Sin estado en vivo para un tracker (todavía no hay datos o el estado en tiempo real no
responde) la fila llega con live: null; la respuesta sigue siendo 200.
counters trae el odómetro y las horas de motor de cada tracker, leídos de la base con el
mismo cálculo que GET /api/trackers/{flespiId}/odometer (el valor que muestra la ficha
del activo), no del servicio en tiempo real. Un tracker sin counters configurados llega
con counters: null.
Se une con el activo por flespiId = mainTrackerId. Contrato:
TrackerLiveStatus de @atlas/shared/tracker-live.
curl --request GET \
--url https://api.ugps.io/api/trackers/live-status \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.ugps.io/api/trackers/live-status"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ugps.io/api/trackers/live-status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.ugps.io/api/trackers/live-status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.ugps.io/api/trackers/live-status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.ugps.io/api/trackers/live-status")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ugps.io/api/trackers/live-status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "success",
"data": [
{
"flespiId": "6512345",
"live": {
"connectionStatus": "just_registered",
"lastContactAt": 1763128800,
"lastFixReceivedAt": 1763128800,
"position": {
"latitude": -33.4489,
"longitude": -70.6693
},
"positionAt": 1763128795,
"movementStatus": "moving",
"stationarySince": 1763125200,
"speedKmh": 0,
"ignitionOn": false
},
"counters": {
"odometer": {
"km": 118000,
"source": "device",
"stale": true
},
"engineHours": {
"hours": 5321.5,
"source": "device",
"stale": true
}
}
}
]
}{
"error": "Token inválido o expirado"
}{
"error": "No tiene permisos para realizar esta acción"
}{
"message": "Error interno del servidor"
}
