Fleet Engine Entities

Interfaccia di Attività

Interfaccia google.maps.journeySharing.Task

I dettagli di un'attività restituita da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi assegnati all'attività.
name
Tipo:  string
Il nome dell'attività nel formato "providers/{provider_id}/tasks/{task_id}". Il parametro task_id deve essere un identificatore univoco e non un ID monitoraggio. Per archiviare l'ID monitoraggio di una spedizione, utilizza il campo tracking_id. Più attività possono avere lo stesso tracking_id.
remainingVehicleJourneySegments
Informazioni sui segmenti ancora da completare per questa attività.
status
Tipo:  string
Lo stato di esecuzione attuale dell'attività.
type
Tipo:  string
Il tipo di attività, ad esempio una pausa o una spedizione.
estimatedCompletionTime optional
Tipo:  Date optional
Il timestamp del tempo di completamento stimato dell'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche dell'ultimo aggiornamento della posizione.
outcome optional
Tipo:  string optional
Il risultato dell'attività.
outcomeLocation optional
Tipo:  LatLngLiteral optional
La posizione in cui è stata completata l'attività (dal provider).
outcomeLocationSource optional
Tipo:  string optional
Il setter della posizione del risultato dell'attività ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
Il timestamp di quando è stato impostato il risultato dell'attività (dal provider).
plannedLocation optional
Tipo:  LatLngLiteral optional
La posizione in cui deve essere completata l'attività.
targetTimeWindow optional
Tipo:  TimeWindow optional
La finestra temporale durante la quale deve essere completata l'attività.
trackingId optional
Tipo:  string optional
L'ID monitoraggio della spedizione.
vehicleId optional
Tipo:  string optional
L'ID del veicolo che esegue questa attività.

Interfaccia TaskInfo

Interfaccia google.maps.journeySharing.TaskInfo

Tipo TaskInfo, utilizzato da DeliveryVehicleStop.
extraDurationMillis optional
Tipo:  number optional
Il tempo aggiuntivo necessario per eseguire l'attività, in millisecondi.
id optional
Tipo:  string optional
L'ID dell'attività.
targetTimeWindow optional
Tipo:  TimeWindow optional
La finestra temporale durante la quale deve essere completata l'attività.

Interfaccia TaskTrackingInfo

Interfaccia google.maps.journeySharing.TaskTrackingInfo

I dettagli per un oggetto informazioni sul monitoraggio delle attività restituito da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi assegnati all'attività.
name
Tipo:  string
Nome nel formato "providers/{provider_id}/taskTrackingInfo/{tracking_id}", dove tracking_id rappresenta l'ID monitoraggio.
trackingId
Tipo:  string
L'ID monitoraggio di un'attività.
  • Deve essere una stringa Unicode valida.
  • Lunghezza massima: 64 caratteri.
  • Normalizzata secondo lo standard Unicode Normalization Form C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".
estimatedArrivalTime optional
Tipo:  Date optional
L'ora di arrivo prevista alla posizione della fermata.
estimatedTaskCompletionTime optional
Tipo:  Date optional
Il tempo di completamento stimato di un'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche dell'ultimo aggiornamento della posizione.
plannedLocation optional
Tipo:  LatLng optional
La posizione in cui verrà completata l'attività.
remainingDrivingDistanceMeters optional
Tipo:  number optional
La distanza totale rimanente in metri al VehicleStop di interesse.
remainingStopCount optional
Tipo:  number optional
Indica il numero di fermate rimanenti del veicolo fino al raggiungimento dell'arresto attività, incluso l'arresto attività. Ad esempio, se la fermata successiva del veicolo è la fermata dell'attività, il valore sarà 1.
routePolylinePoints optional
Tipo:  Array<LatLng> optional
Un elenco di punti che, se collegati, forma una polilinea del percorso previsto dal veicolo verso il luogo in cui si svolge l'attività.
state optional
Tipo:  string optional
Lo stato di esecuzione attuale dell'attività.
targetTimeWindow optional
Tipo:  TimeWindow optional
La finestra temporale durante la quale deve essere completata l'attività.
taskOutcome optional
Tipo:  string optional
L'esito del tentativo di eseguire un'attività.
taskOutcomeTime optional
Tipo:  Date optional
L'ora in cui il risultato dell'attività è stato impostato dal provider.

Interfaccia Trip

Interfaccia google.maps.journeySharing.Trip

I dettagli di una corsa restituita da Fleet Engine.
name
Tipo:  string
Nel formato "providers/{provider_id}/trips/{trip_id}". Il trip_id deve essere un identificatore univoco.
passengerCount
Tipo:  number
Numero di passeggeri per questa corsa; non è incluso il conducente.
remainingWaypoints
Un array di waypoint che indica il percorso dalla posizione corrente al punto di discesa.
status
Tipo:  string
Stato attuale della corsa. I valori possibili sono UNKNOWN_TRIP_STATUS, NEW, ENROUTE_TO_PICKUP, ARRIVED_AT_PICKUP, ARRIVED_AT_INTERMEDIATE_DESTINATION, ENROUTE_TO_INTERMEDIATE_DESTINATION, ENROUTE_TO_DROPOFF, COMPLETE o CANCELED.
type
Tipo:  string
Il tipo di viaggio. I valori possibili sono UNKNOWN_TRIP_TYPE, SHARED o EXCLUSIVE.
vehicleId
Tipo:  string
ID del veicolo che effettua il viaggio.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente è stato consegnato.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Luogo in cui è stato ritirato il cliente.
dropOffTime optional
Tipo:  Date optional
L'ora futura stimata in cui lasceranno i passeggeri o l'ora effettiva in cui lasceranno.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche dell'ultimo aggiornamento della posizione.
pickupTime optional
Tipo:  Date optional
L'ora futura stimata in cui i passeggeri saranno assunti o l'ora effettiva in cui sono stati prelevati.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente indica che andrà a buon fine.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente indica che verrà ritirato.

Interfaccia DeliveryVehicle

Interfaccia google.maps.journeySharing.DeliveryVehicle

I dettagli di un veicolo per la consegna restituito da Fleet Engine.
attributes
Tipo:  Object<string, string optional>
Attributi personalizzati del veicolo per la consegna.
name
Tipo:  string
Nel formato "providers/{provider_id}/delivery Vehicles/{delivery_vehicle_id}". Il delivery_vehicle_id deve essere un identificatore univoco.
navigationStatus
Tipo:  string
Lo stato di navigazione attuale del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza percorsa rimanente nel tratto di percorso corrente, in metri.
remainingVehicleJourneySegments
I segmenti di viaggio assegnati a questo veicolo per la consegna, a partire dalla posizione del veicolo segnalata più di recente. Viene compilato solo se l'oggetto dati DeliveryVehicle viene fornito tramite FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:  LatLngLiteral optional
La posizione in cui termina il tratto di percorso corrente.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
L'ultima posizione segnalata del veicolo per la consegna.
remainingDurationMillis optional
Tipo:  number optional
La durata di guida rimanente nel tratto di percorso corrente in millisecondi.

Interfaccia DeliveryVehicleStop

Interfaccia google.maps.journeySharing.DeliveryVehicleStop

Tipo di interruzioneVeicolo per la consegna
tasks
Tipo:  Array<TaskInfo>
L'elenco di attività da eseguire in questa interruzione.
  • id: l'ID dell'attività.
  • extraDurationMillis: il tempo aggiuntivo necessario per eseguire l'attività, in millisecondi.
plannedLocation optional
Tipo:  LatLngLiteral optional
La posizione della fermata.
state optional
Tipo:  DeliveryVehicleStopState optional
Lo stato della fermata.

Costanti di DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState costanti

Lo stato attuale di un oggetto DeliveryVehicleStop.

Accedi chiamando const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
ARRIVED Arrivato alla fermata. Presuppone che, quando il veicolo sta passando alla fermata successiva, che tutte le fermate precedenti siano state completate.
ENROUTE Assegnati e routing attivo.
NEW L'elemento è stato creato, ma il routing non è attivo.
UNSPECIFIED Sconosciuto.

Interfaccia VehicleJourneySegment

Interfaccia google.maps.journeySharing.VehicleJourneySegment

Tipo di segmento VehicleJourney
drivingDistanceMeters optional
Tipo:  number optional
La distanza da percorrere dalla fermata precedente a questa fermata, in metri.
drivingDurationMillis optional
Tipo:  number optional
Il tempo di percorrenza in millisecondi dalla fermata precedente di questa fermata.
path optional
Tipo:  Array<LatLngLiteral> optional
Il percorso dalla fermata precedente (o la posizione attuale del veicolo, se questa è la prima nell'elenco delle fermate) fino a questa fermata.
stop optional
Tipo:  DeliveryVehicleStop optional
Informazioni sulla fermata.

Interfaccia VehicleLocationUpdate

Interfaccia google.maps.journeySharing.VehicleLocationUpdate

Tipo di aggiornamento della posizione del veicolo
heading optional
Tipo:  number optional
L'intestazione dell'aggiornamento. 0 corrisponde al nord, da 180 a sud.
location optional
Tipo:  LatLngLiteral|LatLng optional
La posizione dell'aggiornamento.
speedKilometersPerHour optional
Tipo:  number optional
La velocità in chilometri orari.
time optional
Tipo:  Date optional
Ora di ricezione di questo aggiornamento dal veicolo.

Interfaccia di VehicleWaypoint

Interfaccia google.maps.journeySharing.VehicleWaypoint

Tipo di VehicleWaypoint.
distanceMeters optional
Tipo:  number optional
La distanza in metri del percorso tra il waypoint precedente (o la posizione attuale del veicolo, se questo è il primo nell'elenco dei waypoint).
durationMillis optional
Tipo:  number optional
Tempo di percorrenza in millisecondi tra il waypoint precedente (o la posizione attuale del veicolo, se questo è il primo nell'elenco dei waypoint) in millisecondi.
location optional
Tipo:  LatLngLiteral optional
La posizione del waypoint.
path optional
Tipo:  Array<LatLngLiteral> optional
Il percorso dal waypoint precedente (o la posizione attuale del veicolo, se questo è il primo nell'elenco dei waypoint) verso questo waypoint.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
L'elenco delle velocità del traffico lungo il percorso dal waypoint precedente (o dalla posizione del veicolo) al waypoint attuale. Ciascun intervallo nell'elenco descrive il traffico su un tratto contiguo del percorso; l'intervallo definisce i punti di partenza e di arrivo del segmento tramite i relativi indici. Consulta la definizione di SpeedReadingInterval per ulteriori dettagli.

Interfaccia del veicolo

Interfaccia google.maps.journeySharing.Vehicle

I dettagli di un veicolo restituito da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi personalizzati del veicolo.
name
Tipo:  string
Nel formato "providers/{provider_id}/vehicles/{vehicle_id}". Il valore Vehicle_id deve essere un identificatore univoco.
navigationStatus
Lo stato di navigazione attuale del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza percorsa rimanente nel tratto di percorso corrente, in metri.
vehicleState
Tipo:  VehicleState
Lo stato del veicolo.
vehicleType
Tipo:  VehicleType
Il tipo di questo veicolo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
Il waypoint in cui termina il segmento di percorso corrente.
currentRouteSegmentVersion optional
Tipo:  Date optional
L'ora in cui è stato impostato il tratto di percorso corrente.
currentTrips optional
Tipo:  Array<string> optional
Elenco di ID corsa per le corse attualmente assegnate a questo veicolo.
etaToFirstWaypoint optional
Tipo:  Date optional
L'orario di arrivo stimato alla prima voce nel campo dei waypoint.
latestLocation optional
Tipo:  VehicleLocationUpdate optional
L'ultima posizione segnalata del veicolo.
maximumCapacity optional
Tipo:  number optional
Il numero totale di passeggeri che questo veicolo può trasportare. Il conducente non è considerato in questo valore.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipi di viaggio supportati da questo veicolo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
I waypoint rimanenti assegnati a questo veicolo.
waypointsVersion optional
Tipo:  Date optional
L'ultima volta che il campo dei waypoint è stato aggiornato.

Costanti di VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus costanti

Lo stato di navigazione attuale di un elemento Vehicle.

Accedi chiamando const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
ARRIVED_AT_DESTINATION Il veicolo si trova a circa 50 metri dalla destinazione.
ENROUTE_TO_DESTINATION La navigazione passo passo è disponibile e la navigazione dell'app Driver è passata alla modalità GUIDD_NAV.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
OFF_ROUTE Il veicolo ha abbandonato il percorso suggerito.
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.

Costanti di VehicleState

google.maps.journeySharing.VehicleState costanti

Lo stato attuale di un oggetto Vehicle.

Accedi chiamando const {VehicleState} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
OFFLINE Il veicolo non accetta nuovi viaggi.
ONLINE Il veicolo accetta nuovi viaggi.
UNKNOWN_VEHICLE_STATE Stato del veicolo sconosciuto.

Costanti di VehicleType

google.maps.journeySharing.VehicleType costanti

Il tipo di Vehicle.

Accedi chiamando const {VehicleType} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
AUTO Un'automobile.
TAXI Qualsiasi veicolo che funge da taxi (solitamente con licenza o regolamentato).
TRUCK Un veicolo con un ampio spazio di archiviazione.
TWO_WHEELER Moto, ciclomotore o altro veicolo a due ruote.
UNKNOWN Tipo di veicolo sconosciuto.

Costanti TripType

google.maps.journeySharing.TripType costanti

Tipi di viaggio supportati da un Vehicle.

Accedi chiamando const {TripType} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
EXCLUSIVE Il viaggio è riservato esclusivamente a un veicolo.
SHARED La corsa potrebbe condividere un veicolo con altri viaggi.
UNKNOWN_TRIP_TYPE Tipo di viaggio sconosciuto.

Interfaccia di TripWaypoint

Interfaccia google.maps.journeySharing.TripWaypoint

Tipo di punto di viaggio.
distanceMeters optional
Tipo:  number optional
La distanza in metri del percorso tra il waypoint precedente (o la posizione attuale del veicolo, se questo è il primo nell'elenco dei waypoint).
durationMillis optional
Tipo:  number optional
Tempo di percorrenza in millisecondi tra il waypoint precedente (o la posizione attuale del veicolo, se questo è il primo nell'elenco dei waypoint) in millisecondi.
location optional
Tipo:  LatLng optional
La posizione del waypoint.
path optional
Tipo:  Array<LatLng> optional
Il percorso dalla fermata precedente (o la posizione attuale del veicolo, se questa è la prima nell'elenco delle fermate) fino a questa fermata.
speedReadingIntervals optional
Tipo:  Array<SpeedReadingInterval> optional
L'elenco delle velocità del traffico lungo il percorso dal waypoint precedente (o dalla posizione del veicolo) al waypoint attuale. Ciascun intervallo nell'elenco descrive il traffico su un tratto contiguo del percorso; l'intervallo definisce i punti di partenza e di arrivo del segmento tramite i relativi indici. Consulta la definizione di SpeedReadingInterval per ulteriori dettagli.
tripId optional
Tipo:  string optional
La corsa associata a questo waypoint.
waypointType optional
Tipo:  WaypointType optional
Il ruolo svolto da questo waypoint in questa corsa, ad esempio prelievo o discesa.

Costanti WaypointType

google.maps.journeySharing.WaypointType costanti

Tipi di waypoint supportati da Vehicle.

Accedi chiamando const {WaypointType} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Waypoint per la consegna dei passeggeri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoint per destinazioni intermedie in un viaggio con più destinazioni.
PICKUP_WAYPOINT_TYPE Waypoint per la presa dei passeggeri.
UNKNOWN_WAYPOINT_TYPE Tipo di waypoint sconosciuto.

Interfaccia TimeWindow

Interfaccia google.maps.journeySharing.TimeWindow

Un intervallo di tempo.
endTime
Tipo:  Date
L'ora di fine della finestra temporale (inclusa).
startTime
Tipo:  Date
L'ora di inizio della finestra temporale (inclusa).

Costanti di velocità

google.maps.journeySharing.Speed costanti

La classificazione della velocità delle polilinea in base ai dati sul traffico.

Accedi chiamando const {Speed} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
NORMAL Velocità normale, nessun rallentamento rilevato.
SLOW È stato rilevato un rallentamento, ma non si è verificato un ingorgo.
TRAFFIC_JAM È stato rilevato un ingorgo.

Interfaccia SpeedReadingInterval

Interfaccia google.maps.journeySharing.SpeedReadingInterval

Indicatore della densità del traffico su un tratto di percorso contiguo. L'intervallo definisce i punti di partenza e di arrivo del segmento tramite i relativi indici.
endPolylinePointIndex
Tipo:  number
L'indice in base zero del punto finale dell'intervallo nel percorso.
speed
Tipo:  Speed
Velocità del traffico in questo intervallo.
startPolylinePointIndex
Tipo:  number
L'indice in base zero del punto iniziale dell'intervallo nel percorso.