Aggiungere una corsa in tempo reale

Puoi aggiungere un'istanza di corsa in tempo reale. Duplica un prototipo di corsa esistente definito nei dati GTFS statici e programmalo per un altro orario. Per aggiungere una corsa in tempo reale:

• Specifica schedule_relationship come ADDED.
• Identifica la corsa facendo riferimento alla corsa statica e utilizza il trip_id. 
• Specifica una nuova programmazione utilizzando start_time. È consigliabile che il valore start_time sia diverso da start_time della corsa originale. Tutti gli orari di arrivo e partenza dalle fermate vengono copiati dalla corsa originale e spostati di conseguenza, se non diversamente specificato.

È possibile aggiungere una corsa per entrambi i casi di corsa con exact_times e corse con una frequenza. Invece, per una corsa statica basata su una frequenza con exact_times impostato su 0, utilizza schedule_relationship di SCHEDULED. Anche le corse ADDED saranno considerate come programmate.

Le corse aggiunte non devono contenere cambi a blocchi poiché non è possibile aggiungere una corsa con cambi a blocchi in tempo reale.

Aggiunta con TripUpdates

Per mantenere il riferimento alla corsa aggiunta, la tupla <trip_id, start_time, schedule_relationship> deve rimanere stabile. È possibile aggiungere uno stop_time_update per definire le previsioni per le corse aggiunte.

Esempio di codice:

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

Aggiunta con VehiclePosition

Per mantenere il riferimento alla corsa aggiunta, la tupla <trip_id, start_time, vehicle_id, schedule_relationship> deve rimanere stabile.

Esempio di codice:

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

Aggiunta con ServiceAlerts

Le corse aggiuntive non vengono visualizzate tra i risultati. Invece, viene allegato un messaggio di servizio aggiuntivo alle corse esistenti. Per indicare corse aggiuntive, specifica ADDITIONAL_SERVICE nel campo effect dell'avviso e indica il valore informed_entity appropriato. L'avviso può essere aggiunto a livello di agenzia, percorso o corsa.

Esempio di codice:

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

Ecco come vengono visualizzate le informazioni di ServiceAlerts:

Modifiche alla specifica GTFS

È stata approvata una proposta GTFS per supportare le corse schedule_relation=DUPLICATED. Al momento, stiamo lavorando alla nuova specifica GTFS per offrire corse DUPLICATE, che sostituiranno le corse ADDED. Quando Google supporterà le modifiche, aggiorneremo questo articolo.

Se hai già aggiunto il supporto per le corse DUPLICATE, consulta la guida alla migrazione.