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.
Puoi utilizzare un messaggio VehiclePosition se fornisci:
- La posizione (
position
) più aggiornata del veicolo con iltimestamp
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.
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.
Gli aggiornamenti ricevuti tramite il feed VehiclePosition mostrano la posizione in tempo reale dei veicoli su Google Maps.