Suivi en direct
Le suivi en direct montre sur vos cartes publiées où sont vos véhicules et où ils s'arrêtent aujourd'hui : la tournée d'un food truck, une boucle de navette, une clinique mobile. Les visiteurs voient chaque véhicule en service se déplacer sur la carte, les arrêts du jour avec Ici maintenant, Ouvert maintenant ou Fermé aujourd'hui, et une estimation du temps jusqu'au prochain arrêt. Voir la mise en page en direct pour ce que voit un visiteur.
Il comporte trois parties, toutes dans Kaleidr Studio :
| Partie | Ce que c'est |
|---|---|
| Une collection Arrêts | Les horaires : chaque arrêt, son adresse et ses plages de service hebdomadaires. Une collection de la Bibliothèque de lieux comme une autre. |
| Une flotte | Vos véhicules, leurs services et la précision avec laquelle les visiteurs les voient. Gérée sous Données, Flotte. |
| Positions | Où se trouve chaque véhicule, d'après l'une de quatre sources : le lien d'enregistrement d'un chauffeur, un téléphone en mode chauffeur, un traceur à vous, ou un connecteur vers votre fournisseur de télématique. |
Les positions ne sont affichées que pendant le service d'un véhicule. Une position enregistrée en dehors de tous les services de son véhicule est écartée à son arrivée : elle n'est jamais stockée ni affichée, seulement comptée. Voir Services.
Flottes
Sous Données, choisissez l'onglet Flotte, puis Nouvelle Flotte. Donnez-lui un nom et un fuseau horaire, et choisissez sa Collection d'Arrêts si vous en avez une. Studio crée une collection Véhicules du même nom : cette collection est la flotte sur vos cartes, et vous l'ajoutez à une carte comme n'importe quelle collection. Elle ne contient aucun lieu importé ; ses véhicules sont ceux de la flotte.
Ajouter un Véhicule, sur la page de la flotte, en ajoute un :
| Champ | Visible des visiteurs | Usage |
|---|---|---|
| Nom | Oui | Le libellé du véhicule sur la carte et dans le panneau, par exemple « Camion 1 ». Unique dans la flotte. |
| Type | Oui | Camion, fourgon, voiture, bus, navette, bateau, chariot ou vélo. |
| Couleur | Oui | La couleur du véhicule sur la carte. |
| Description | Oui | Une courte ligne sur sa fiche, jusqu'à 200 caractères. |
| ID externe | Non | Votre propre identifiant, utilisé par les connecteurs et par la colonne Véhicule de vos arrêts. |
| Heures de service | Non | Les heures hebdomadaires que suivent les services d'une flotte à horaires programmés. Voir Services. |
Un véhicule désactivé n'est jamais affiché, et ses positions sont écartées. La page de la flotte en dessine une carte en direct, en pleine précision, pour vous seul.
Les propriétaires, administrateurs et membres gèrent les flottes et les véhicules ; les lecteurs peuvent les voir. Seuls les propriétaires et administrateurs suppriment une flotte, effacent l'historique d'un véhicule et gèrent les connecteurs. Supprimer la Flotte supprime la flotte, ses véhicules, appareils, liens, services, historique et connecteurs, puis sa collection Véhicules.
Horaires des arrêts
Les horaires sont une collection Arrêts. Chaque arrêt est un lieu avec un nom et une adresse ou des coordonnées, et ces champs fixent quand il est desservi :
| Champ | Signification |
|---|---|
| Horaires | Les plages de service hebdomadaires de l'arrêt, écrites comme des horaires d'ouverture : jusqu'à quatre plages par jour. Une plage peut passer minuit et appartient au jour où elle commence. |
| Fuseau Horaire | Le fuseau dans lequel les plages sont écrites. Vide, celui de la collection. |
| Statut | paused retire l'arrêt de tous les jours. Toute autre valeur, ou aucune, le conserve. |
| Véhicule | Le nom ou l'ID externe du véhicule qui dessert l'arrêt. Vide, n'importe quel véhicule de la flotte. |
| Dates de service | Des dates au format YYYY-MM-DD, séparées par des virgules ou des espaces. Si elles sont présentes, l'arrêt n'est desservi qu'à ces dates. |
À une date donnée, les plages d'un arrêt sont :
- aucune si son statut est
paused, ou si son fuseau horaire n'est pas valide ; - aucune s'il a des Dates de service et que la date n'en fait pas partie ;
- sans Horaires : toute la journée si les Dates de service contiennent la date, sinon aucune ;
- sinon, les Horaires de ce jour de la semaine.
Un arrêt est ouvert maintenant quand une plage du jour contient l'heure locale, ou qu'une plage de la veille qui passe minuit la contient. « Aujourd'hui » est la date dans le fuseau horaire de la flotte.
| Arrêt | Demandé | Plages | Ouvert |
|---|---|---|---|
| Horaires lundi 11:00–14:00 | Lundi 12:00 | 11:00–14:00 | Oui |
| Le même | Lundi 15:00 | 11:00–14:00 | Non |
Le même, avec Dates de service 2026-11-02 | Lundi 2026-11-09, 12:00 | Aucune | Non |
Dates de service 2026-11-02, sans horaires | 2026-11-02, 09:00 | Toute la journée | Oui |
Horaires lundi 11:00–14:00, Statut Paused | Lundi 12:00 | Aucune | Non |
| Horaires vendredi 22:00–02:00 | Samedi 01:00 | Celle du vendredi, 22:00–02:00 | Oui |
| Horaires lundi 11:00–14:00, fuseau horaire non valide | Lundi 12:00 | Aucune | Inconnu |
Dates de service 2026-11-02, 2026-11-03 2026-11-04, horaires lundi 11:00–14:00 | Mardi 2026-11-03 | Les horaires du mardi : aucune | Non |
Le modèle Location du générateur de modèles et Télécharger le tableau d'exemple vous donnent une collection Arrêts déjà remplie pour commencer.
Liens d'enregistrement
Un lien d'enregistrement permet à un chauffeur de signaler le véhicule à un arrêt depuis le navigateur de n'importe quel téléphone, sans app ni compte.
Créez-en un sur la page de la flotte : un véhicule, Lien de Pointage, Créer le Lien. Studio affiche le lien une seule fois, avec Copier le Lien et un code QR à scanner. Il ressemble à https://map-embed.kaleidr.com/checkin.html#….
- Un lien par véhicule, valable 180 jours. Remplacer le Lien en émet un nouveau et met fin à l'ancien immédiatement ; utilisez-le quand un téléphone est perdu ou qu'un chauffeur part. Révoquer le Lien y met fin. Ensuite, Studio n'affiche que les quatre derniers caractères du lien, sa date d'expiration et sa dernière utilisation.
- Le lien est une clé. Toute personne qui le détient, près d'un arrêt, peut enregistrer le véhicule. Ne le partagez qu'avec le chauffeur.
- Ouvrez-le dans un navigateur. La page refuse de fonctionner dans le cadre d'une autre page.
La page du chauffeur affiche le véhicule, les arrêts du jour et leur statut :
- Je suis ici lit une fois la position du téléphone et enregistre l'arrivée à l'arrêt à portée : 250 mètres plus la précision du relevé, qui doit être de 100 mètres ou mieux. S'il y a plus d'un arrêt à portée, ou aucun, la page liste les arrêts du jour et le chauffeur en choisit un, qui doit être à moins de 2 000 mètres. Une flotte avec Autoriser l'enregistrement hors des arrêts activé propose aussi Pas un arrêt prévu.
- Fermé pour aujourd'hui marque les arrêts restants du véhicule pour la journée comme Fermé aujourd'hui et termine son service. Rouvrir aujourd'hui, le même jour, retire ces marques ; cela ne commence pas de service.
Un enregistrement ouvre un service jusqu'à 30 minutes après la fin de la plage de l'arrêt, et affiche le véhicule à la position propre de l'arrêt, pas à celle du téléphone. La position du téléphone sert à trouver l'arrêt, puis elle est écartée. Un enregistrement hors d'un arrêt affiche le véhicule à la position du téléphone pendant quatre heures, arrondie à environ 10 mètres, ou davantage si la précision publique de la flotte est plus grossière.
Téléphones en mode chauffeur
Le téléphone d'un chauffeur équipé de l'app Kaleidr partage la position du véhicule pendant le service du chauffeur. Sur la page de la flotte, un véhicule, Associer un Téléphone, Afficher le Code d'Association affiche un code QR et un code de huit caractères, valable 10 minutes et une seule fois. Le chauffeur scanne le QR avec l'appareil photo du téléphone, ou saisit le code dans l'app. Voir Mode chauffeur pour le côté chauffeur.
Appareils liste les téléphones et les traceurs de chaque véhicule. Dissocier en retire un immédiatement : son appel suivant est refusé, et un service qu'il a commencé se termine.
Traceurs et API des positions
Un traceur est tout appareil ou système à vous qui envoie des positions : un boîtier GPS avec un client HTTP, ou votre propre logiciel de répartition. Sur la page de la flotte, un véhicule, Ajouter un Traceur, donnez-lui un nom, et Studio affiche sa clé une seule fois. La clé appartient à ce véhicule.
curl https://api.kaleidr.com/live-api/v1/positions \
-H "Authorization: Bearer YOUR_DEVICE_KEY" \
-H "Content-Type: application/json" \
-d '{
"positions": [
{ "lat": 40.74110, "lng": -73.98970, "heading": 90, "speed": 8.3, "accuracy": 12,
"recorded_at": "2026-10-22T15:04:05Z" }
],
"sent_at": "2026-10-22T15:04:06Z"
}'
| Champ | Règle |
|---|---|
positions | De 1 à 100 points, dans n'importe quel ordre. Le corps fait au plus 64 Kio. |
lat, lng | Obligatoires. Dans les limites, et pas tous deux à 0. |
heading | Degrés depuis le nord. |
speed | Mètres par seconde. |
accuracy | Mètres. Un point moins précis que 100 mètres est écarté. |
recorded_at | Obligatoire. Quand la position a été mesurée : RFC 3339, ou millisecondes depuis 1970. |
sent_at | Quand le lot a été envoyé, selon l'horloge de l'appareil. S'il diffère de celle de Kaleidr de plus de 5 secondes et de moins d'un jour, chaque recorded_at est corrigé de l'écart ; d'un jour ou plus, le lot est refusé. |
La réponse :
{
"accepted": 1,
"dropped": { "off_shift": 0, "stale": 0, "future": 0, "inaccurate": 0, "rate": 0, "duplicate": 0 },
"shift": { "id": "…", "state": "on", "ends_at": "2026-10-23T03:04:05Z" },
"min_interval_s": 10
}
| Écarté comme | Pourquoi |
|---|---|
off_shift | Enregistré en dehors de tous les services du véhicule, ou le véhicule est inactif. Jamais stocké. |
stale | Enregistré il y a plus de 12 heures. |
future | Enregistré plus de 30 secondes en avance sur l'horloge de Kaleidr. |
inaccurate | Moins précis que 100 mètres, ou vitesse ou précision négative. |
rate | Plus proche dans le temps du point précédent du véhicule que l'intervalle de mise à jour de votre offre. |
duplicate | Un point avec le même recorded_at a déjà été conservé. |
GET /live-api/v1/device renvoie l'appareil, son véhicule, la flotte et le service ouvert. POST /live-api/v1/device/shift avec { "action": "start" } ou { "action": "end" } commence ou termine le service du véhicule depuis l'appareil.
| Statut | error | Signification |
|---|---|---|
| 400 | invalid_request | Le corps est mal formé ; field désigne la partie en cause. |
| 400 | clock_invalid | sent_at est à un jour ou plus de l'horloge de Kaleidr. |
| 401 | unauthorized | Aucune clé, ou une clé inconnue. |
| 401 | device_revoked | L'appareil a été retiré dans Studio. Arrêtez les envois. |
| 409 | off_shift | Le lot contenait des points, aucun ne tombait dans un service, et aucun service n'est ouvert. Arrêtez les envois jusqu'au début d'un service. |
| 413 | batch_too_large | Plus de 100 points, ou plus de 64 Kio. |
| 429 | rate_limited | Plus de 12 requêtes par minute depuis cet appareil. Attendez le nombre de secondes indiqué par Retry-After. |
Les erreurs sont { "error": <code>, "message": <sentence> }. Envoyez toutes les 10 à 30 secondes pendant le déplacement : un lot de points vaut mieux qu'une requête par point.
Connecteurs
Un connecteur récupère les positions d'un système de télématique auquel vos véhicules envoient déjà leurs données. Les propriétaires et administrateurs en ajoutent un sur la page de la flotte, sous Connecteurs, Ajouter un Connecteur. Les connecteurs sont disponibles avec Pro et Enterprise.
| Connecteur | Ce que vous fournissez | Comment arrivent les positions |
|---|---|---|
| Samsara | Un Jeton d'API avec accès en lecture aux positions des véhicules | Kaleidr demande à Samsara les nouvelles positions à chaque intervalle Interroger Toutes les. |
| Geotab | Serveur (un hôte geotab.com), Base de Données, Nom d'Utilisateur, Mot de Passe | Kaleidr demande à Geotab les nouveaux enregistrements à chaque intervalle Interroger Toutes les. |
| Traccar | Rien : Studio affiche une URL d'ingestion et un secret | Votre serveur Traccar transfère chaque position. |
| Webhook | Rien : Studio affiche une URL d'ingestion et un secret | Votre système envoie des lots signés. |
- Les identifiants sont en écriture seule. Studio vérifie un identifiant Samsara ou Geotab par un appel avant de l'enregistrer, et ne l'affiche plus jamais. Remplacer les Identifiants le change.
- Le secret d'ingestion n'est affiché qu'une fois. Renouveler le Secret en émet un nouveau ; l'ancien continue de fonctionner pendant 24 heures.
- Associer Par décide comment un véhicule du fournisseur retrouve le vôtre : ID Externe (par défaut) ou Nom. Un véhicule du fournisseur qui ne correspond à aucun est listé sous Véhicules non associés, avec Ajouter comme Véhicule ; ses positions sont écartées.
- Interroger Toutes les vaut au moins 30 secondes, et jamais moins que l'intervalle de mise à jour de votre offre.
- Statut : Actif ; En Pause, par vous ou parce que votre offre autorise moins de connecteurs ; En Échec après cinq interrogations échouées d'affilée, toujours retentées ; Non Valide quand le fournisseur refuse l'identifiant, jusqu'à ce que vous le remplaciez. Un connecteur Traccar ou webhook en pause ou non valide refuse ce qu'on lui envoie.
Les positions des connecteurs passent toujours par la règle des services.
Traccar
Ajoutez ces lignes au fichier de configuration de votre serveur Traccar, traccar.xml, avec l'URL et le secret affichés par Studio, puis redémarrez Traccar :
<entry key='forward.enable'>true</entry>
<entry key='forward.url'>https://api.kaleidr.com/live-api/v1/ingest/YOUR_CONNECTOR_ID/traccar</entry>
<entry key='forward.json'>true</entry>
<entry key='forward.header'>X-Kaleidr-Connector-Secret: YOUR_CONNECTOR_SECRET</entry>
Un appareil Traccar est associé à un véhicule par son identifiant unique (ID Externe) ou par son nom. Une position que Traccar marque comme non valide est écartée.
Webhook
Envoyez jusqu'à 100 points par requête à l'URL d'ingestion, signés avec le secret du connecteur :
import { createHmac } from 'node:crypto';
const body = JSON.stringify({
positions: [
{ vehicle: 'TRUCK-1', lat: 40.7411, lng: -73.9897, heading: 90, speed: 8.3, accuracy: 12,
recorded_at: '2026-10-22T15:04:05Z' },
],
});
const t = Math.floor(Date.now() / 1000);
const v1 = createHmac('sha256', process.env.KALEIDR_CONNECTOR_SECRET).update(`${t}.${body}`).digest('hex');
await fetch('https://api.kaleidr.com/live-api/v1/ingest/YOUR_CONNECTOR_ID/webhook', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'Kaleidr-Signature': `t=${t},v1=${v1}` },
body,
});
Kaleidr-Signaturevautt=<unix seconds>,v1=<hex HMAC-SHA256(secret, "<t>.<raw body>")>, le schéma des webhooks de réservation dans l'autre sens.tdoit être à moins de 5 minutes de l'horloge de Kaleidr, et la signature doit porter sur les octets exacts que vous envoyez.vehicleest l'ID externe ou le nom du véhicule, selon Associer Par.speedest en mètres par seconde,accuracyen mètres, etrecorded_aten RFC 3339 ou en millisecondes depuis 1970.- Une signature incorrecte est refusée avec 401
signature_invalid.
Services
Un service est la période pendant laquelle un véhicule peut être affiché. Un véhicule a au plus un service ouvert, qui dure au plus 16 heures. Il s'ouvre et se ferme de l'une de quatre façons :
| Ouvert par | Se termine |
|---|---|
| Commencer le Service en mode chauffeur | Terminer le Service, ou 16 heures plus tard |
| Un enregistrement | 30 minutes après la fin de la plage de l'arrêt, Fermé pour aujourd'hui, ou 16 heures plus tard |
| Commencer le Service sur le véhicule dans Studio | Terminer le Service dans Studio, ou 16 heures plus tard |
| Les heures de service du véhicule, dans une flotte dont le Mode de Service est Horaires Prévus | La fin de ces heures |
- Hors service, rien n'est publié ni conservé. Une position enregistrée en dehors de tous les services est écartée à son arrivée. Seul le nombre de positions écartées est conservé, pour la section Utilisation.
- Terminer un service retire le véhicule de vos cartes à leur rafraîchissement suivant.
- Les connecteurs et les traceurs envoient en permanence, c'est donc le service qui décide. Dans une flotte Manuel, leurs positions ne passent que pendant un service ouvert par un chauffeur, un enregistrement ou Studio. Dans une flotte à Horaires Prévus, les heures de service du véhicule ouvrent et ferment ses services.
- Retirer un appareil termine le service qu'il a commencé.
Précision publique
Confidentialité et Affichage, sur la page de la flotte, définit la précision avec laquelle les visiteurs voient vos véhicules :
| Précision publique | Les visiteurs voient | Cap et vitesse |
|---|---|---|
| Exacte | La position à environ 1 mètre près | Affichés |
| Rue, Environ 100 m (par défaut) | La position arrondie à environ 100 mètres | Affichés |
| Zone, Environ 1 km | La position arrondie à environ 1 kilomètre | Masqués |
- Un véhicule enregistré à un arrêt est affiché à la position propre de l'arrêt.
- Marquer Comme Ancien Après (de 30 à 900 secondes ; 120 par défaut) : un véhicule silencieux plus longtemps affiche Vu il y a 5 min.
- Masquer Après (de 60 à 3 600 secondes ; 900 par défaut) : un véhicule silencieux plus longtemps n'est pas affiché.
- Les visiteurs ne voient que le nom, le type, la couleur, la description, le statut, la position arrondie et l'âge du dernier signalement de chaque véhicule, ainsi que son cap et sa vitesse, sauf en Zone, Environ 1 km. Les appareils, les ID externes et l'historique ne sont jamais publiés.
Historique et conservation
Vous voyez le tracé de chaque véhicule pour une journée sous Historique, en pleine précision. L'historique conserve au plus un point toutes les 30 secondes, ou à chaque intervalle de mise à jour de votre offre s'il est plus long, plus tout point situé à 200 mètres ou plus du dernier conservé. Les points sont supprimés au-delà des jours d'historique de votre offre, et jamais conservés plus de 90 jours.
- Effacer l'Historique (propriétaires et administrateurs) supprime d'un coup toutes les positions et les services terminés d'un véhicule.
- Supprimer un véhicule ou une flotte supprime son historique avec lui. Dissocier un appareil conserve l'historique du véhicule.
- Une offre avec moins de jours d'historique supprime l'historique en trop au nettoyage quotidien suivant.
Les chauffeurs ne sont pas des comptes Kaleidr. Rien ici n'identifie une personne au-delà des noms d'appareil que vous saisissez.
Estimations d'arrivée
La mise en page en direct indique combien de temps un véhicule mettrait pour atteindre son prochain arrêt, ou un visiteur qui demande Combien de temps jusqu'à moi ?. Chacune de ces durées est une Estimation :
- Elle est calculée à partir de la distance routière et de vitesses habituelles. Le trafic n'est pas pris en compte, et l'itinéraire réel du véhicule peut différer.
- Elle part de la position que voient les visiteurs, à la précision publique de la flotte.
- Elle est affichée comme une durée, Environ 12 min, jamais comme une heure d'arrivée. Sans itinéraire routier, Pas d'estimation.
- La position d'un visiteur ne sert qu'à cette estimation, et n'est jamais stockée ni journalisée.
- Les itinéraires routiers sont construits à partir des données OpenStreetMap, © contributeurs d'OpenStreetMap, sous ODbL.
Les estimations sont limitées à 20 par minute pour un visiteur et à 2 000 par jour pour une carte. Elles ne comptent pas dans votre utilisation de Kaleidr AI.
Uniquement sur les cartes Kaleidr
Les véhicules en direct s'affichent sur les cartes qui utilisent le fond de carte propre à Kaleidr : tous les viewers intégrés, et Studio. Kaleidr Map n'affiche pas les véhicules d'une flotte quand il montre la carte d'un autre fournisseur. Aucune position de véhicule n'est envoyée à un fournisseur de cartes tiers.
Limites
| Limite | Free | Pro | Enterprise |
|---|---|---|---|
| Véhicules actifs dans toute l'organisation | 2 | 25 | Fixé dans votre contrat |
| Jours d'historique des positions | 1 | 30 | 90 |
| Intervalle minimal entre les points d'un véhicule | 30 secondes | 10 secondes | 5 secondes |
| Connecteurs | Aucun | 3 | Fixé dans votre contrat |
Une flotte compte au plus 500 véhicules. Une limite n'arrête que le travail nouveau : une organisation qui la dépasse garde ce qu'elle a, sauf l'historique au-delà des jours de son offre et les connecteurs au-delà de son offre, qui passent en pause.
Utilisation, sur la page de la flotte, affiche les compteurs du jour : positions acceptées, positions écartées et pourquoi, consultations des visiteurs et estimations.