Fornire informazioni in tempo reale sulle corse con VehiclePosition

Importante: per fornire informazioni in tempo reale sulle corse con il feed VehiclePosition, consulta Selezionare una corsa con TripDescriptor.

Puoi utilizzare i feed VehiclePosition per fornire informazioni in tempo reale sullo stato di un mezzo pubblico in una determinata corsa.

Ricevere aggiornamenti sullo stato del veicolo

Un messaggio vehicle_position può fornire informazioni sullo stato attuale del veicolo in una determinata corsa.

Per i veicoli assegnati a una corsa, fornisci un feed VehiclePositions con un TripDescriptor pertinente, informazioni precise sulla posizione (position) e un timestamp in corrispondenza del quale è stata misurata la posizione.

VehiclePosition per l'ora di arrivo

Puoi utilizzare un messaggio VehiclePosition se fornisci: 

• La posizione (position) più aggiornata del veicolo con il timestamp della lettura
• Il descrittore della corsa (trip descriptor)
• Il descrittore del veicolo (vehicle descriptor)

Per ogni fermata successiva, utilizziamo un algoritmo per prevedere l'orario di arrivo stimato dell'autobus alla fermata in base alla posizione attuale. Queste informazioni vengono mostrate all'utente nell'app e interessano anche i risultati di ricerca.

Se la posizione più recente del veicolo e altre informazioni non sono disponibili, dovrebbero comparire l'ultima posizione nota e altri dati con il timestamp misurato della posizione originale. Scopri di più sugli effetti delle lacune nei dati sui feed in tempo reale.

VehicleDescriptor è necessario per monitorare il veicolo di una corsa nel tempo. Deve essere univoco per ogni feed e costante durante la durata della corsa. Per garantire che il veicolo possa essere monitorato, fornisci l'id del descrittore del veicolo.

Esempio di codice:

vehicle_position {
    trip {
      route_id: "route1"
      direction_id: "0"
      start_time: "10:10:00"
      start_date: "20160203"
 
    }
    vehicle {
      id: "route1-v1"
    }
    position {
      latitude: 4066265190
      longitude: 3862204692
    }
    timestamp: 1458508943
  }
}

Per le corse con orari fissi viene mostrato il ritardo effettivo:

  

Per le corse con orari basati sulla frequenza viene mostrata l'ora di arrivo della corsa successiva senza informazioni sul ritardo.

Fornire informazioni sulla capienza

Utilizza il campo occupancy_status insieme alla posizione specificata nel messaggio vehicle_position. La capienza verrà visualizzata nell'interfaccia utente come indicatore grafico.

Codice di esempio:

vehicle {
  trip {
    trip_id: xxx
    start_time: 12:34:56
    ... 
    occupancy_status: CRUSHED_STANDING_ROOM_ONLY
  }
}

Scopri come fornire dati sulla presenza di persone sui veicoli con GTFS.

Mostrare la posizione di un veicolo in tempo reale su Google Maps

Gli aggiornamenti ricevuti tramite il feed VehiclePosition mostrano la posizione in tempo reale dei veicoli su Google Maps.