Open data du réseau Ginko

Ce site s'adresse à des développeurs en informatique

Une clé d'API est maintenant nécessaire

Une clé d'API est maintenant obligatoire pour chaque requête effectuée sur l'API. L'utilisation de l'API demeure gratuite. La clé nous permet d'obtenir des statistiques d'utilisation et de mettre en place une gestion de droits pour accéder à des informations complémentaires comme l'affluence.

Demandez dès maintenant votre clé en nous contactant à l'adresse ginko.support-ssi@keolis.com

Informations proposées en Open Data

Certaines informations sont disponibles via une API, d'autres sont proposées sous forme d'un jeu de fichiers au format GTFS. Lisez attentivement les informations ci-dessous pour connaître les différences entre ces deux sources de données.

API Temps Réel

Structure des lignes, recherche d'arrêts, horaires de passage en temps réel...

API REST API Javascript

GTFS lignes urbaines et périurbaines

Données théoriques des lignes urbaines et périurbaines Ginko (horaires, itinéraires). Fichier mis à jour à chaque changement d'offre. Les données actuelles sont valables jusqu'au inclus.

Télécharger

L'API fonctionne exclusivement par des requêtes HTTP GET ou POST. La réponse est au format JSON. Vous pouvez utiliser l'API bas niveau depuis n'importe quel langage; en complément, une surcouche haut niveau est disponible en Javascript pour accélérer votre développement. Note: le format JSON ne garantit pas l'ordre des champs à l'intérieur d'un objet. L'ordre choisi dans cette documentation ne correspond donc pas forcément à l'ordre réel.
Le jeu de fichiers GTFS est fourni sous forme de fichier ZIP téléchargeable à l'adresse https://api.ginko.voyage/gtfs-ginko.zip. L'URL du jeu de données GTFS est fixe. Le fichier est remplacé tous les jours. Pour plus d'informations sur le format GTFS, consultez la documentation Google Developers.

L'API permet d'effectuer des requêtes précises pour rechercher des informations à la demande; elle donne également accès aux données temps réel du réseau Ginko (temps d'attente et infos-trafic). Nous vous conseillons de l'utiliser si votre application dispose d'un accès internet permanent lors de son utilisation. Le format GTFS donne accès à toutes les informations statiques du réseau (structure des lignes, horaires théoriques), il peut donc être chargé au démarrage de l'application afin que celle-ci ne soit plus dépendante de la connexion réseau par la suite. Une utilisation conjointe du fichier GTFS et de l'API peut être pertinente si vous développez une application de navigation.

Informations disponibles	API	GTFS
Nom et position GPS des arrêts	Oui	Oui
Structure des lignes	Oui	Oui
Horaires théoriques	Non	Oui
Tracé GPS des lignes (en suivant les routes)	Non	Oui
Informations d'accessibilité des arrêts	Oui	Oui
Informations d'accessibilité des véhicules	Oui	Non
Tarifs des titres de transport et abonnements	Oui	Non
Temps d'attente en temps réel	Oui	Non
Infos-trafic (perturbations anticipées ou non)	Oui	Non
Informations temps réel sur les véhicules	Oui	Non
Prévision d'Affluence de la journée *	Oui	Non
Affluence temps réel par véhicule	Oui	Non
Prévision d'affluence temps réel par station	Oui	Non

En raison de la complexité inhérente aux particularités de ces services, l'ouverture des données des services spéciaux, scolaires, et services à la demande n'est pas planifiée pour le moment.

Licence d'utilisation

Les données ouvertes du réseau Ginko sont mises à disposition gratuitement.

Les données sont mises à disposition sous Licence ODbL (Open Database Licence). L'utilisation de l'API et/ou le téléchargement du jeu de données GTFS vaut acceptation de la licence. Cette licence vous impose notamment de mentionner la provenance des informations utilisées par vos développements, ce qui peut se faire par exemple par un lien vers ce site.

Cette licence implique que vous êtes libres de :

Partager
Adapter
Créer

à partir de notre base de données ...

Du moment que vous :

Mentionnez la paternité : Vous devez mentionnez la source de la base de données pour toute utilisation publique la base de données, ou pour toute création produite à partir de la base de données, de la manière indiquée dans l'ODbL. Pour toute utilisation ou redistribution de la base de données, ou création produite à partir de cette base de données, vous devez clairement mentionner aux tiers la licence de la base de données et garder intacte toute mention légale sur la base de données originaire.
Partagez aux conditions identiques : si vous utilisez publiquement une version adaptée de cette base de données, ou que vous produisiez une création à partir d'une base de données adaptée, vous devez aussi offrir cette base de données adaptée selon les termes de la licence ODbL.
Gardez ouvert : si vous redistribuez la base de données, ou une version modifiée de celle-ci, alors vous ne pouvez utiliser de mesure technique restreignant la création que si vous distribuez aussi une version sans ces restrictions.

Continuité de service

Toute modification apportée dans la diffusion des données fera l’objet d’une information sur ce site décrivant les nouvelles modalités dans un délai d’un mois au moins avant application de la modification. Pour être notifié par email de ces modifications, faites-en la demande à l'adresse ginko.support-ssi@keolis.com.

Disclaimer

Malgré tout le soin que nous y avons accordé, la documentation peut contenir des inexactitudes. Les informations proposées ne font l'objet d'aucune garantie. La responsabilité de Keolis Besançon Mobilités, exploitant du réseau urbain Ginko, ni celle de Grand Besançon Métropole, Autorité Organisatrice des Mobilités, ne sauraient être engagées en cas de dysfonctionnement temporaire de cette plateforme ou d'inexactitude dans les informations qu'elle fournit.

N'hésitez pas à nous remonter les éventuels bugs et erreurs dans la documentation à l'adresse ginko.support-ssi@keolis.com.

L'API Javascript est un outil facultatif destiné à accélérer le développement de votre application web. Elle fournit un moyen simple et rapide d'interroger l'API bas niveau, de récupérer les résultats et de traiter les erreurs. (Testé avec la dernière version d'Internet Explorer, Firefox et Chrome, mais fonctionne sûrement avec les versions plus anciennes et d'autres navigateurs.)

Mise en oeuvre

Il suffit d'inclure le script https://api.ginko.voyage/api.js dans la balise HEAD de votre page, en fournissant votre clé API si vous en avez une, comme ceci:

<script type="text/javascript" src="https://api.ginko.voyage/api.js?apiKey=XXX"></script>

Utilisez ensuite la méthode: ginkoAPI(methodPath, args, success [, error] [, timeout]) pour interroger l'API:

Paramètre	Type	Description
methodPath*	Chaine	Chemin de la méthode de l'API à invoquer. Il est indiqué dans la documentation de chaque méthode (parcourez les onglets à gauche pour découvrir les méthodes disponibles). Exemple: `DR/getDetailsVariante`
args*	Objet	Objet contenant les paramètres demandés par la méthode de l'API. Si vous n'avez pas de paramètre à transmettre, spécifiez un objet vide `{ }`. Il n'est pas nécessaire de fournir votre clé d'API à chaque requête (celle-ci étant fournie lors du chargement de l'API). Exemple: `{ idLigne: "3", idVariante: "34-0" }`
success*	Méthode	Méthode callback invoquée en cas de succès de la requête. Reçoit un seul paramètre, qui est le résultat décapsulé de la méthode de l'API (décrit dans la documentation de la méthode). Exemple: `function(listeArrets){ ... }`
error	Méthode	Méthode callback invoquée en cas d'échec de la requête. Reçoit un message d'erreur en paramètre. Il n'est pas obligatoire de fournir un callback d'erreur, toutefois, si vous ne le faites pas, votre application risque de planter discrètement sans que l'utilisateur en soit informé. Si vous ne souhaitez pas fournir ce paramètre, spécifiez `null` pour pouvoir indiquer le paramètre suivant. Exemple: `function(msg){ alert(msg); }`
timeout	Entier	Délai maximal d'éxécution de la requête, en secondes. Ce paramètre est optionnel (10 secondes par défaut).

Exemple simple

Visitez cette page et consultez sa source.

Présentation SIRI

SIRI (Standard Interface for Real-time Information) est la nouvelle norme d'interface Européenne pour l'échange de données en temps réel. Depuis le 18 octobre 2023, SIRI est mis à votre disposition dans notre API, vous pouvez l'essayer avec une clé temporaire (pour une clé définitive, veuillez-nous contacter sur ginko.support-ssi@keolis.com).

SIRI met en place des Web Service de type SOAP et propose un système de communication sous la forme d'abonnements et de requêtes. A l'heure d'aujourd'hui, seul le mode requête a été développé.

Nous avons mis en place 3 Web Services qui sont Stop Monitoring (SM), Estimated Timetable(ET) et General Message(GM).
Ces services ont été mis en place en suivant le profil français issu du profil Ile-de-France Mobilité

Requête SIRI

Comme indiqué précédemment, le protocole d'échange utilisé pour SIRI est le SOAP, un protocole d'échange HTTP où les requêtes/réponses sont au format XML.
Lors de notre développement nous avons utilisé le logiciel PostMan afin d'effectuer nos requêtes.

De plus, le gouvernement a mis à notre disposition un générateur de requêtes très utile, vous permettant de générer et d'exécuter des requêtes sur nos différents services disponibles.

Générateur de requête

Check Status

Le service Check Status permet de récupérer l'état de l'API SIRI.

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
  <soap:Header></soap:Header>
  <soap:Body>
    <CheckStatusResponse xmlns:ns6="http://datex2.eu/schema/2_0RC1/2_0" xmlns:ns5="http://www.ifopt.org.uk/ifopt" xmlns:ns2="http://www.siri.org.uk/siri" xmlns:ns4="http://www.ifopt.org.uk/acsb" xmlns:ns3="http://www.opengis.net/gml/3.2">
      <ServiceDeliveryInfo>
        <ns2:ResponseTimestamp>2024-01-15T13:01:12.267872091+01:00</ns2:ResponseTimestamp>
        <ns2:ProducerRef>Ginko</ns2:ProducerRef>
        <ns2:ResponseMessageIdentifier>5de614f2-0d26-445f-988a-3fc9a53b0c25</ns2:ResponseMessageIdentifier>
        <ns2:RequestMessageRef>Test::Message::be92e19b-7373-44c6-ba1a-20b6dcac3a29</ns2:RequestMessageRef>
      </ServiceDeliveryInfo>
      <Answer xsi:type="ns2:CheckStatusResponseStructure" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <ns2:ResponseTimestamp>2024-01-15T13:01:12.26792148+01:00</ns2:ResponseTimestamp>
        <ns2:Status>true</ns2:Status>
      </Answer>
    </CheckStatusResponse>
    <soap:Fault></soap:Fault>
  </soap:Body>
</soap:Envelope>

ServiceDeliveryInfo

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

La date et l'heure de la réponse

ProducerRef

1-1

Le producteur de la donnée, ici Ginko

ResponseMessageIdentifier

1-1

Identifiant de la requête équivalent à l'identifiant de la requête qui l'a déclenché

RequestMessageRef

1-1

Identifiant de la réponse

Answer

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

L'heure à laquelle la réponse a été envoyée

MonitoringRef

1-1

Booléen indiquant si oui ou non l'API est fonctionnelle

Stop Monitoring

Le service Stop Monitoring permet de récupérer les informations de passages en temps réel d'un arrêt du réseau.

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
  <soap:Header></soap:Header>
  <soap:Body>
    <GetStopMonitoringResponse xmlns:ns6="http://datex2.eu/schema/2_0RC1/2_0" xmlns:ns5="http://www.ifopt.org.uk/ifopt" xmlns:ns2="http://www.siri.org.uk/siri" xmlns:ns4="http://www.ifopt.org.uk/acsb" xmlns:ns3="http://www.opengis.net/gml/3.2">
      <ServiceDeliveryInfo>
        <ns2:ResponseTimestamp>2024-01-15T09:50:24.209870559+01:00</ns2:ResponseTimestamp>
        <ns2:ProducerRef>Ginko</ns2:ProducerRef>
        <ns2:ResponseMessageIdentifier>815160db-989f-46d2-ae36-fa165d412355</ns2:ResponseMessageIdentifier>
        <ns2:RequestMessageRef>Test::Message::d6fc3037-6fb2-465b-a2e4-d4fa3e4a28a0</ns2:RequestMessageRef>
      </ServiceDeliveryInfo>
      <Answer xsi:type="ns2:StopMonitoringDeliveryStructure" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <ns2:MonitoringRef>t_hdc1</ns2:MonitoringRef>
        <ns2:MonitoringName xml:lang="FR">Hauts du Chazal</ns2:MonitoringName>
        <ns2:MonitoredStopVisit>
          <ns2:RecordedAtTime>2024-01-15T09:50:14.501144796+01:00</ns2:RecordedAtTime>
          <ns2:ItemIdentifier>t_hdc1-8555737</ns2:ItemIdentifier>
          <ns2:MonitoringRef>t_hdc1</ns2:MonitoringRef>
          <ns2:MonitoredVehicleJourney>
            <ns2:LineRef>101</ns2:LineRef>
            <ns2:DirectionRef>Aller</ns2:DirectionRef>
            <ns2:PublishedLineName xml:lang="FR">T1</ns2:PublishedLineName>
            <ns2:OriginRef>t_hdc1</ns2:OriginRef>
            <ns2:OriginName xml:lang="FR">Hauts du Chazal</ns2:OriginName>
            <ns2:DestinationRef>t_chal</ns2:DestinationRef>
            <ns2:DestinationName xml:lang="FR">Chalezeule</ns2:DestinationName>
            <ns2:MonitoredCall>
              <ns2:StopPointRef>t_hdc1</ns2:StopPointRef>
              <ns2:Order>2</ns2:Order>
              <ns2:StopPointName>Hauts du Chazal</ns2:StopPointName>
              <ns2:AimedArrivalTime>2024-01-15T09:54:00+01:00</ns2:AimedArrivalTime>
              <ns2:ExpectedArrivalTime>2024-01-15T09:54:01+01:00</ns2:ExpectedArrivalTime>
            </ns2:MonitoredCall>
          </ns2:MonitoredVehicleJourney>
        </ns2:MonitoredStopVisit>
        </Answer>
    </GetStopMonitoringResponse>
    <soap:Fault></soap:Fault>
  </soap:Body>
</soap:Envelope>

ServiceDeliveryInfo

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

La date et l'heure de la réponse

ProducerRef

1-1

Le producteur de la donnée, ici Ginko

ResponseMessageIdentifier

1-1

Identifiant de la requête équivalent à l'identifiant de la requête qui l'a déclenché

RequestMessageRef

1-1

Identifiant de la réponse

Answer

Attribut

Cardinalité

Description

MonitoringName

1-1

Le nom public de l'arrêt dont on regarde les temps d'attentes

MonitoringRef

1-1

L'id de l'arrêt'

MonitoredStopVisit

0-*

Description des passages à l'arrêt

MonitoredStopVisit

Attribut

Cardinalité

Description

RecordedAtTime

1-1

La date et l'heure de l'enregistrement de la donnée

ItemIdentifier

1-1

ID de l'item, ici idArrêt-numVoyage

MonitoringRef

1-1

ID de l'arrêt

MonitoredVehicleJourney

1-1

L'id de la course, avec idArrêt-numVoyage

MonitoredVehicleJourney

Attribut

Cardinalité

Description

LineRef

1-1

Identifiant de la ligne concernée

DirectionRef

1-1

Sens de la ligne (aller ou retour)

PublishedLineName

1-1

Le nom public de la ligne

OriginRef

1-1

Identifiant de l'arrêt public d'origine de la ligne

OriginName

1-1

Nom public de l'arrêt d'origine

DestinationRef

1-1

Identifiant de l'arrêt public de destination

DestinationName

1-1

Nom public du terminus

MonitoredCall

0-1

Structure décrivant les informations horaires

MonitoredCall

Attribut

Cardinalité

Description

StopPointRef

1-1

Identifiant de l'arrêt

Order

1-1

Ordre de passage de l'arrêt

StopPointName

1-1

Nom public de l'arrêt

AimedArrivalTime

1-1

Horaire théorique de passage à l'arrêt

ExpectedArrivalTime

1-1

Horaire calculée (réelle) de passage à l'arrêt

Estimated Timetable

Le service Estimated Timetable permet de récupérer les informations de passages en temps réel d'une ligne du réseau.

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
  <soap:Header></soap:Header>
  <soap:Body>
    <GetEstimatedTimetableResponse xmlns:ns6="http://datex2.eu/schema/2_0RC1/2_0" xmlns:ns5="http://www.ifopt.org.uk/ifopt" xmlns:ns2="http://www.siri.org.uk/siri" xmlns:ns4="http://www.ifopt.org.uk/acsb" xmlns:ns3="http://www.opengis.net/gml/3.2">
      <ServiceDeliveryInfo>
        <ns2:ResponseTimestamp>2024-01-15T10:04:43.22563583+01:00</ns2:ResponseTimestamp>
        <ns2:ProducerRef>Ginko</ns2:ProducerRef>
        <ns2:ResponseMessageIdentifier>b68749a8-00af-473f-9eca-7d392bdc6616</ns2:ResponseMessageIdentifier>
        <ns2:RequestMessageRef>Test::Message::81d3e218-8bc4-4a87-ac62-931e60751d0f</ns2:RequestMessageRef>
      </ServiceDeliveryInfo>
      <Answer xsi:type="ns2:EstimatedTimetableDeliveryStructure" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <ns2:EstimatedJourneyVersionFrame>
          <ns2:RecordedAtTime>2024-01-15T10:04:43.226485997+01:00</ns2:RecordedAtTime>
          <ns2:EstimatedVehicleJourney>
            <ns2:LineRef>3</ns2:LineRef>
            <ns2:DirectionRef>Retour</ns2:DirectionRef>
            <ns2:DatedVehicleJourneyRef>8497664</ns2:DatedVehicleJourneyRef>
            <ns2:PublishedLineName xml:lang="FR">Pôle Temis &lt; &gt; Centre-ville - 8 Septembre</ns2:PublishedLineName>
            <ns2:DestinationRef>TEMIS1</ns2:DestinationRef>
            <ns2:DestinationName xml:lang="FR">Pôle Temis</ns2:DestinationName>
            <ns2:EstimatedCalls>
              <ns2:EstimatedCall>
                <ns2:StopPointRef>REPUBL2</ns2:StopPointRef>
                <ns2:Order>1</ns2:Order>
                <ns2:StopPointName xml:lang="FR">République</ns2:StopPointName>
                <ns2:DestinationDisplay>Pôle Temis</ns2:DestinationDisplay>
                <ns2:AimedArrivalTime>2024-01-15T12:48:00.903+01:00</ns2:AimedArrivalTime>
                <ns2:ExpectedArrivalTime>2024-01-15T12:49:00.903+01:00</ns2:ExpectedArrivalTime>
                <ns2:ArrivalProximityText xml:lang="FR">En approche</ns2:ArrivalProximityText>
                <ns2:AimedDepartureTime>2024-01-15T12:48:00.903+01:00</ns2:AimedDepartureTime>
                <ns2:ExpectedDepartureTime>2024-01-15T12:49:00.903+01:00</ns2:ExpectedDepartureTime>
              </ns2:EstimatedCall>
            </ns2:EstimatedCalls>
          </ns2:EstimatedVehicleJourney>
        </ns2:EstimatedJourneyVersionFrame>
      </Answer>
    </GetEstimatedTimetableResponse>
    <soap:Fault></soap:Fault>
  </soap:Body>
</soap:Envelope>

ServiceDeliveryInfo

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

La date et l'heure de la réponse

ProducerRef

1-1

Le producteur de la donnée, ici Ginko

ResponseMessageIdentifier

1-1

Identifiant de la requête équivalent à l'identifiant de la requête qui l'a déclenché

RequestMessageRef

1-1

Identifiant de la réponse

EstimatedJourneyVersionFrame

Attribut

Cardinalité

Description

RecordedAtTime

1-1

La date et l'heure de l'enregistrement

EstimatedVehicleJourney

0-*

Informations concernant un voyage avec ses temps d'attentes

EstimatedVehicleJourney

Attribut

Cardinalité

Description

LineRef

1-1

Identifiant de la ligne

DirectionRef

1-1

Aller ou retour

DatedVehicleJourneyRef

1-1

Identifiant de la course

PublishedLineName

1-1

Nom public de la ligne

DirectionName

1-1

Nom public de la direction

EstimatedCalls

0-1

Description ordonnée des arrêts et heures de passage. Cet objet est composé d'EstimatedCall avec cardinalité 1-*

EstimatedCall

Attribut

Cardinalité

Description

Order

1-1

Ordre de passage de l'arrêt

StopPointName

1-1

Nom public de l'arrêt

Occupancy

1-1

Enumération indiquant l'occupation des places dans le bus (EMPTY, MANY_SEATS_AVAILABLE, FEW_SEATS_AVAILABLE, STANDING_AVAILABLE, NOT_ACCEPTING_PASSENGERS

DestinationDisplay

1-1

Destination de la ligne

AimedArrivalTime

1-1

Heure théorique d'arrivée

ExpectedArrivalTime

1-1

Heure calculée (réelle) d'arfivée

ArrivalProximityText

1-1

Texte d'affichage lorsque le véhicule est en approche

AimedDepartureTime

1-1

Heure théorique de départ

ExpectedDepartureTime

1-1

Heure calculée (réelle) de départ

General Message

Le service General Message permet de récupérer les messages diffusés sur les bornes d'informations destinées aux voyageurs réseau.

<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
  <soap:Header></soap:Header>
  <soap:Body>
    <GetGeneralMessageResponse xmlns:ns6="http://datex2.eu/schema/2_0RC1/2_0" xmlns:ns5="http://www.ifopt.org.uk/ifopt" xmlns:ns2="http://www.siri.org.uk/siri" xmlns:ns4="http://www.ifopt.org.uk/acsb" xmlns:ns3="http://www.opengis.net/gml/3.2">
      <ServiceDeliveryInfo>
        <ns2:ResponseTimestamp>2024-01-15T10:27:52.450596597+01:00</ns2:ResponseTimestamp>
        <ns2:ProducerRef>Ginko</ns2:ProducerRef>
        <ns2:ResponseMessageIdentifier>8d83db99-c5fb-45ef-ac77-f8d3455f1ce6</ns2:ResponseMessageIdentifier>
        <ns2:RequestMessageRef>Test::Message::a81d8aab-de91-46d2-b9ef-9d3c489e644b</ns2:RequestMessageRef>
      </ServiceDeliveryInfo>
      <Answer xsi:type="ns2:GeneralMessageDeliveryStructure" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <ns2:ResponseTimestamp>2024-01-15T10:27:52.450693985+01:00</ns2:ResponseTimestamp>
        <ns2:GeneralMessage formatRef="France">
          <ns2:ItemIdentifier>4862</ns2:ItemIdentifier>
          <ns2:InfoMessageIdentifier>4862</ns2:InfoMessageIdentifier>
          <ns2:InfoChannelRef>Perturbation</ns2:InfoChannelRef>
          <ns2:ValidUntilTime>2024-01-16T02:59:00.296+01:00</ns2:ValidUntilTime>
          <ns2:Content xsi:type="FrGeneralMessage">
            <LineRef>249</LineRef>
            <StopPointRef>TEMIS1</StopPointRef>
            <StopPointRef>JULEHAG4</StopPointRef>
            <Message>
              <MessageType>textOnly</MessageType>
              <MessageText> Travaux avenue Clémenceau  - ligne D249 déviée  du lundi 8 janvier à 05h00 au vendredi 28 juin à la fin du service. Info+ : www.ginko.voyage ou l'Appli Ginko Mobilités rubrique Info trafic  </MessageText>
            </Message>
            <Message>
              <MessageType>HTML</MessageType>
              <MessageText>&lt;div class="gk-mivMessage"&gt;&lt;strong&gt;Travaux avenue Clémenceau&lt;/strong&gt; - ligne D249 déviée  du lundi 8 janvier à 05h00 au vendredi 28 juin à la fin du service.&lt;br&gt;Info+ : www.ginko.voyage ou l'Appli Ginko Mobilités rubrique Info trafic &lt;/div&gt;</MessageText>
            </Message>
          </ns2:Content>
        </ns2:GeneralMessage>
        <ns2:GeneralMessage formatRef="France">
          <ns2:ItemIdentifier>4863</ns2:ItemIdentifier>
          <ns2:InfoMessageIdentifier>4863</ns2:InfoMessageIdentifier>
          <ns2:InfoChannelRef>Perturbation</ns2:InfoChannelRef>
          <ns2:ValidUntilTime>2024-01-16T02:59:00.296+01:00</ns2:ValidUntilTime>
          <ns2:Content xsi:type="FrGeneralMessage">
            <LineRef>249</LineRef>
            <Message>+
              <MessageType>textOnly</MessageType>
              <MessageText> Travaux avenue Clémenceau  - ligne D249 déviée  du lundi 8 janvier à 05h00 au vendredi 28 juin à la fin du service. Info+ : www.ginko.voyage ou l'Appli Ginko Mobilités rubrique Info trafic  </MessageText>
            </Message>
            <Message>
              <MessageType>HTML</MessageType>
              <MessageText>&lt;div class="gk-mivMessage"&gt;&lt;strong&gt;Travaux avenue Clémenceau&lt;/strong&gt; - ligne D249 déviée  du lundi 8 janvier à 05h00 au vendredi 28 juin à la fin du service.&lt;br&gt;Info+ : www.ginko.voyage ou l'Appli Ginko Mobilités rubrique Info trafic &lt;/div&gt;</MessageText>
            </Message>
          </ns2:Content>
        </ns2:GeneralMessage>
      </Answer>
    </GetGeneralMessageResponse>
    <soap:Fault></soap:Fault>
  </soap:Body>
</soap:Envelope>

ServiceDeliveryInfo

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

La date et l'heure de la réponse

ProducerRef

1-1

Le producteur de la donnée, ici Ginko

ResponseMessageIdentifier

1-1

Identifiant de la réponse équivalent à l'identifiant de la requête qui l'a déclenché

RequestMessageRef

1-1

Identifiant de la réponse

Answer

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

Date et heure de la réponse

GeneralMessage

1-*

Structure de données définissant une diffusion

GeneralMessage

Attribut

Cardinalité

Description

ItemIdentifier

1-1

Identifiant du message

InfoMessageIdentifier

1-1

Identifiant du message

InfoChannelRef

1-1

Type du message (Perturbation ou Information)

ValidUntilTime

1-1

Date de fin de la diffusion, dans notre cas chaque diffusion a une date de fin à la fin du service. Lorsque celle-ci s'arrête, elle n'est plus envoyé dans la réponse.

Content

1-1

Définition du scope et du contenu de la diffusion

Content

Attribut

Cardinalité

Description

LineRef

1-*

Identifiant des lignes concernées

StopPointRef

1-*

Identifiant des arrêts concernées

Message

1-*

Contenu des messages avec un type

Message

Attribut

Cardinalité

Description

MessageType

1-1

Type du message (shortMessage, longMessage, textOnly, formattedText, HTML, RTF, codedMessage

MessageText

1-1

Contenu du message

Situation Exchange

Le service Situation Exchange permet de récupérer les perturbations en cours sur le réseau, indiquant les lignes et arrêt impactés, ainsi que d'autres informations telles que la gravité, la conséquence...

Ce service étant assez conséquent, nous ne pouvons pas le détailler dans son entièreté.
Cependant, voici la documentation que nous avons suivie : Documentation SIRI
Si malgré cette documentation, vous n'avez pas réponse à tout, contactez-nous.


    <?xml version="1.0"?>
    <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope/" soap:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
        <soap:Header></soap:Header>
        <soap:Body>
            <GetSituationExchangeResponse xmlns:ns6="http://datex2.eu/schema/2_0RC1/2_0" xmlns:ns5="http://www.ifopt.org.uk/acsb" xmlns:ns2="http://www.siri.org.uk/siri" xmlns:ns4="http://www.opengis.net/gml/3.2" xmlns:ns3="http://www.ifopt.org.uk/ifopt">
                <ServiceDeliveryInfo>
                    <ns2:ResponseTimestamp>2024-10-25T09:40:32.0704334+02:00</ns2:ResponseTimestamp>
                    <ns2:ProducerRef>Ginko</ns2:ProducerRef>
                    <ns2:ResponseMessageIdentifier>c5db78c9-606b-4468-abc4-55dcb0d71240</ns2:ResponseMessageIdentifier>
                    <ns2:RequestMessageRef>Test::Message::27274aa5-a6f3-4bbd-a292-113c0e479e17</ns2:RequestMessageRef>
                </ServiceDeliveryInfo>
                <Answer xsi:type="ns2:SituationExchangeDeliveryStructure" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                    <ns2:ResponseTimestamp>2024-10-25T09:40:32.0704334+02:00</ns2:ResponseTimestamp>
                    <ns2:Situations>
                        <ns2:PtSituationElement>
                            <ns2:CreationTime>2024-10-08T10:26:08+02:00</ns2:CreationTime>
                            <ns2:CountryRef>fr</ns2:CountryRef>
                            <ns2:ParticipantRef>Ginko</ns2:ParticipantRef>
                            <ns2:SituationNumber>9551</ns2:SituationNumber>
                            <ns2:Version>1</ns2:Version>
                            <ns2:Source>
                                <ns2:Country>fr</ns2:Country>
                                <ns2:Web>https://www.ginko.voyage</ns2:Web>
                                <ns2:Name xml:lang="FR">Ginko</ns2:Name>
                            </ns2:Source>
                            <ns2:Verification>verified</ns2:Verification>
                            <ns2:Progress>open</ns2:Progress>
                            <ns2:QualityIndex>certain</ns2:QualityIndex>
                            <ns2:Reality>real</ns2:Reality>
                            <ns2:ValidityPeriod>
                                <ns2:StartTime>2024-10-24T00:00:00+02:00</ns2:StartTime>
                            </ns2:ValidityPeriod>
                            <ns2:UnknownReason>Travaux rue Meslier</ns2:UnknownReason>
                            <ns2:Severity>normal</ns2:Severity>
                            <ns2:Priority>1</ns2:Priority>
                            <ns2:Audience>public</ns2:Audience>
                            <ns2:Language>FR</ns2:Language>
                            <ns2:Description>Travaux rue Meslier</ns2:Description>
                            <ns2:InfoLinks>
                                <ns2:InfoLink>
                                    <ns2:Uri>https://www.ginko.voyage/info-trafic/?idevenement=1581</ns2:Uri>
                                </ns2:InfoLink>
                            </ns2:InfoLinks>
                            <ns2:Affects>
                                <ns2:Networks>
                                    <ns2:AffectedNetwork>
                                        <ns2:AffectedLine>
                                            <ns2:LineRef>10</ns2:LineRef>
                                        </ns2:AffectedLine>
                                    </ns2:AffectedNetwork>
                                </ns2:Networks>
                                <ns2:StopPoints>
                                    <ns2:AffectedStopPoint>
                                        <ns2:StopPointRef>MESLIER1</ns2:StopPointRef>
                                    </ns2:AffectedStopPoint>
                                </ns2:StopPoints>
                            </ns2:Affects>
                            <ns2:Consequences>
                                <ns2:Consequence>
                                    <ns2:Severity>severe</ns2:Severity>
                                    <ns2:Affects>
                                        <ns2:Networks>
                                            <ns2:AffectedNetwork>
                                                <ns2:AffectedLine>
                                                    <ns2:LineRef>10</ns2:LineRef>
                                                </ns2:AffectedLine>
                                            </ns2:AffectedNetwork>
                                        </ns2:Networks>
                                        <ns2:StopPoints>
                                            <ns2:AffectedStopPoint>
                                                <ns2:StopPointRef>MESLIER1</ns2:StopPointRef>
                                            </ns2:AffectedStopPoint>
                                        </ns2:StopPoints>
                                    </ns2:Affects>
                                    <ns2:Boarding>
                                        <ns2:ArrivalBoardingActivity>noAlighting</ns2:ArrivalBoardingActivity>
                                        <ns2:DepartureBoardingActivity>noBoarding</ns2:DepartureBoardingActivity>
                                    </ns2:Boarding>
                                </ns2:Consequence>
                            </ns2:Consequences>
                            <ns2:PublishingActions>
                                <ns2:PublishToWebAction>
                                    <ns2:ActionStatus>open</ns2:ActionStatus>
                                    <ns2:Description xml:lang="FR">Publication sur le site web</ns2:Description>
                                </ns2:PublishToWebAction>
                            </ns2:PublishingActions>
                        </ns2:PtSituationElement>
                    </ns2:Situations>
                </Answer>
            </GetSituationExchangeResponse>
            <soap:Fault></soap:Fault>
        </soap:Body>
    </soap:Envelope>

ServiceDeliveryInfo

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

La date et l'heure de la réponse

ProducerRef

1-1

Le producteur de la donnée, ici Ginko

ResponseMessageIdentifier

1-1

Identifiant de la réponse équivalent à l'identifiant de la requête qui l'a déclenché

RequestMessageRef

1-1

Identifiant de la réponse

Answer

Attribut

Cardinalité

Description

ResponseTimestamp

1-1

Date et heure de la réponse

Situations

1-1

Ensemble des perturbations

Situations

Attribut

Cardinalité

Description

PtSituationElement

0-*

Structure définissant une perturbation

PtSituationElement

Attribut

Cardinalité

Description

CreationTime

1-1

Date de création de la perturbation

SituationNumber

1-1

Identifiant de la perturbation

Description

1-1

Description de la perturbation

Priority

1-1

Priorité de la perturbation

InfoLinks

1-1

Structure donnant les liens vers la perturbations (ginko.voyage)

Affects

1-1

Structure définissant les lignes et les arrêts affectés

Consequences

1-1

Structure définissant les conséquences sur les temps d'attente

PublishingActions

1-1

Structure définissant les moyen de communication sur la perturbation

Pour pouvoir utiliser l'API de manière temporaire, vous pouvez utiliser une clé temporaire générée tous les jours. Cette clé est valable uniquement 24h, et il sera nécessaire de récupérer la nouvelle clé le lendemain. Pour obtenir une clé permanente, rendez-vous dans la section "Contact" afin d'effectuer votre demande.

Veuillez saisir les chiffres visibles à l'écran