Ajouter un trajet en temps réel

Vous pouvez ajouter une instance de trajet en temps réel. Pour cela, il suffit de dupliquer un prototype de trajet existant défini dans les données GTFS statiques et de le planifier à un autre moment. Pour ajouter un trajet en temps réel, procédez comme suit :

• Définissez le champ schedule_relationship sur ADDED.
• Identifiez le trajet en vous référant au trajet statique et utilisez le champ trip_id. 
• Indiquez de nouveaux horaires à l'aide du champ start_time. Nous vous recommandons de spécifier une heure de début (start_time) différente de l'heure de début du trajet d'origine. Sauf indication contraire explicite, toutes les heures d'arrivée ou de départ aux arrêts sont copiées à partir du trajet d'origine et modifiées en conséquence.

Il est également possible d'ajouter un trajet pour les services basés sur la fréquence. Pour un trajet statique basé sur la fréquence avec un enregistrement GTFS "exact_times=0", définissez plutôt le champ schedule_relationship sur SCHEDULED. Les trajets marqués comme ADDED seront également traités comme des trajets planifiés.

Les trajets ajoutés ne doivent pas contenir de correspondances de bloc ("block transfers"), car il est impossible d'ajouter ce type de trajet en temps réel.

Ajouter à l'aide du flux "TripUpdates" (mises à jour des trajets)

Pour conserver la référence au trajet ajouté, le tuple <trip_id, start_time, schedule_relationship> doit rester stable. Vous pouvez ajouter un champ stop_time_update pour définir les prédictions concernant les trajets ajoutés.

Exemple de code :

trip_update {
  trip {
    trip_id: xxx
    start_time: 12:34:56
    schedule_relationship: ADDED
  }
}

Ajouter à l'aide du flux "VehiclePosition" (position du véhicule)

Pour conserver la référence au trajet ajouté, le tuple <trip_id, start_time, vehicle_id, schedule_relationship> doit rester stable.

Exemple de code :

vehicle {
  trip {
    trip_id: xxx
    start_time: 12:34:56
    schedule_relationship: ADDED
  }
}

Ajouter à l'aide du flux "ServiceAlerts" (alertes de service)

Les trajets supplémentaires n'apparaissent pas dans les résultats. À la place, un message concernant un service supplémentaire est ajouté aux trajets existants. Pour indiquer des trajets supplémentaires, spécifiez ADDITIONAL_SERVICE dans le champ effect de l'alerte et précisez l'entité concernée (informed_entity). Vous pouvez ajouter l'alerte au niveau de l'agence, de l'itinéraire ou du trajet.

Exemple de code :

alert {
  informed_entity {
    trip: {
      trip_id: "G5"
      start_time: "15:15:00"
    }    
  active_period {
      start: 1284457468
      end: 1284468072
    }
  effect: ADDITIONAL_SERVICE
  ...
}

Voici comment les informations ServiceAlerts s'affichent :

Modifications apportées à la spécification GTFS

Une proposition de modification de la spécification GTFS visant à permettre l'ajout d'un trajet via le code schedule_relationship=DUPLICATED a été approuvée. Nous travaillons actuellement sur la nouvelle spécification GTFS pour autoriser les trajets DUPLICATED et abandonner les trajets ADDED. Une fois les modifications acceptées par Google, nous mettrons à jour cet article.

Si vous utilisez déjà des trajets dupliqués (DUPLICATED), consultez le guide de migration.