Véhicules

Attention !

La documentation ne correspond plus à la version actuelle de l'API. Celle-ci sera mise à jour prochainement.

Informations

RealBus met à disposition en libre accès ses données sur les véhicules du réseau.

Ces données contiennent :

  • Numéro du véhicule

  • Couleur du véhicule

  • Type de véhicule

  • Fabricant

  • Modèle

  • Affectations d'aujourd'hui

Etant donné que les informations sont vérifiées manuellement & bénévolement, certains véhicules peuvent être encore en attente d'ajoute. C'est le cas notamment pour les véhicules sous-traités.

En cas de problème, contactez nous via metbusrt-project@sigmazz.fr.

Cependant, l'ajout des véhicules, ainsi que leur(s) affection(s) se mettent à jour de manière automatique.


Format des données

Le serveur renvoie une réponse en format application/json de ce format :

{ "header": { "timestamp": 0000000000000 }, "data": { ... } }

Le champ "header" contient les données relative à la génération des données demandées. Dans ce cas précis, il renvoie la date de génération des données par le serveur. (Cette tâche est effectué SI NECESSAIRE toutes les ~30s environ).

Le champ "data" contient l'ensemble des données des véhicules dans ce format :

"ID": {
  "type": "..",
  "color": "..",
  "maker": "..",
  "model": "..",
  "gallery": "..",
  "notes": [],
  "routes": {
    "today": {
      "ROUTE_SHORT_NAME": {
        "color": "COLOR",
        "sort_id": 0
      }
    }
  }
}

Le champ "ID" correspond au numéro du véhicule. Le champ "Type" correspond au numéro de type de véhicule. Le champ "Color" correspond au numéro de couleur. Le champ "Maker" correspond au nom du constructeur du véhicule. Le champ "Model" correspond au nom du modèle du véhicule. Le champ "Notes" correspond au notes concernant le véhicule. -> Il n'est pas affiché si le véhicule n'en a pas. Le champ "Gallery" correspond au photos concernant le véhicule. -> Il n'est pas affiché si le véhicule n'en a pas. Le champ "ROUTE_SHORT_NAME" correspond au nom court de la ligne. Le champ "COLOR" correspond à la couleur hexadécimale de la ligne. Le champ "0" correspond au numéro de tri de la ligne.

Exemple

Voici un exemple de données concernant le véhicule N°2131 :


"2131": {
            "type": 1, //Bus standard
            "color": 2, //Vert
            "maker": "Mercedes", //Fabricant
            "model": "Citaro C 2", //Modèle
            "notes": [
                { //Contenu de la note ci-dessous
                    "title": "Dépôt", 
                    "content": "Ce véhicule ne fait pas partie du dépôt de Joba.",
                    "date": 1710887908274
                }
            ],
            "gallery": [
                {
                    "name": "Mathis L.", //Auteur de la photo
                     "date": "02/05/2024", //Date de prise de la photo
                     "path": "541-TBdceHOuUzrnmcza.png" //Chemin de la photo
                     // Notez que la photo est stockée sur le serveur de fichiers 
                     // Correspondant au réseau. Sur cet exemple, cela sera
                     // https://files-metz.realbus.fr/541-TBdceHOuUzrnmcza.png
                  }
            ],
            "routes": {
                "today": { //Lignes assignées aujourd'hui
                    "P102": { //La ligne P102 a été assignée aujourd'hui
                        "color": "97BF0D", //Couleur hexadécimal de cette ligne
                        "sort_id": 16 //Numéro de tri de cette ligne
                    }
                }
            }
        },

Références

Dernière mise à jour