Fleet Engine Entities

Interfaccia Attività

google.maps.journeySharing.Task interfaccia

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}". task_id deve essere un identificatore univoco e non un ID monitoraggio. Per memorizzare un ID monitoraggio di una spedizione, utilizza il campo tracking_id. Più attività possono avere lo stesso tracking_id.
remainingVehicleJourneySegments
Informazioni sui segmenti rimanenti 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 stimato per il completamento 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 fornitore).
outcomeLocationSource optional
Tipo:  string optional
Il setter della posizione del risultato dell'attività ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
Timestamp dell'impostazione del risultato dell'attività (da parte del fornitore).
plannedLocation optional
Tipo:  LatLngLiteral optional
La località 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

google.maps.journeySharing.TaskInfo interfaccia

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à.

TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfo interfaccia

I dettagli di un oggetto di informazioni di monitoraggio delle attività restituito da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi assegnati all'attività.
name
Tipo:  string
Il 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.
  • Limitato a una lunghezza massima di 64 caratteri.
  • Normalizzato in base al modulo di normalizzazione Unicode C.
  • Non può contenere i seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.
estimatedArrivalTime optional
Tipo:  Date optional
L'orario di arrivo stimato alla posizione della fermata.
estimatedTaskCompletionTime optional
Tipo:  Date optional
Il tempo stimato per il completamento di un'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche dell'ultimo aggiornamento della posizione.
plannedLocation optional
Tipo:  LatLng optional
La località in cui verrà completata l'attività.
remainingDrivingDistanceMeters optional
Tipo:  number optional
La distanza totale rimanente in metri fino al VehicleStop di interesse.
remainingStopCount optional
Tipo:  number optional
Indica il numero di fermate rimanenti del veicolo fino al raggiungimento della fermata dell'attività, inclusa la fermata dell'attività. Ad esempio, se la prossima fermata del veicolo è la fermata dell'attività, il valore sarà 1.
routePolylinePoints optional
Tipo:  Array<LatLng> optional
Un elenco di punti che, se collegati, formano una polilinea del percorso previsto del veicolo fino alla posizione di questa 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
Il risultato del tentativo di esecuzione di un'attività.
taskOutcomeTime optional
Tipo:  Date optional
L'ora in cui il risultato dell'attività è stato impostato dal fornitore.

Interfaccia di viaggio

google.maps.journeySharing.Trip interfaccia

I dettagli di un viaggio restituiti da Fleet Engine.
name
Tipo:  string
Nel formato "providers/{provider_id}/trips/{trip_id}". trip_id deve essere un identificatore univoco.
passengerCount
Tipo:  number
Numero di passeggeri di questo viaggio, autista escluso.
remainingWaypoints
Un array di tappe che indica il percorso dalla posizione attuale al punto di consegna.
status
Tipo:  string
Stato attuale del viaggio. 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 questo viaggio.
actualDropOffLocation optional
Tipo:  LatLngLiteral optional
Luogo in cui è stato lasciato il cliente.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Luogo in cui è stato prelevato il cliente.
dropOffTime optional
Tipo:  Date optional
L'orario futuro stimato in cui i passeggeri verranno accompagnati a destinazione o l'orario effettivo in cui sono stati accompagnati.
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 verranno prelevati o l'ora effettiva in cui sono stati prelevati.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
La località in cui il cliente indica che verrà accompagnato.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
La località in cui il cliente indica che verrà prelevato.

Interfaccia DeliveryVehicle

google.maps.journeySharing.DeliveryVehicle interfaccia

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

Interfaccia DeliveryVehicleStop

google.maps.journeySharing.DeliveryVehicleStop interfaccia

Tipo DeliveryVehicleStop
tasks
Tipo:  Array<TaskInfo>
L'elenco delle attività da svolgere in questa fermata.
  • 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 DeliveryVehicleStopState

google.maps.journeySharing.DeliveryVehicleStopState costanti

Lo stato attuale di un DeliveryVehicleStop.

Accesso chiamando il numero const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
ARRIVED Arrivo alla fermata. Presuppone che, quando il veicolo si dirige verso la fermata successiva, tutte le fermate precedenti siano state completate.
ENROUTE Assegnato e in fase di routing attivo.
NEW Creata, ma non instradata attivamente.
UNSPECIFIED Sconosciuto.

Interfaccia VehicleJourneySegment

google.maps.journeySharing.VehicleJourneySegment interfaccia

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

Interfaccia VehicleLocationUpdate

google.maps.journeySharing.VehicleLocationUpdate interfaccia

Tipo VehicleLocationUpdate
heading optional
Tipo:  number optional
L'intestazione dell'aggiornamento. 0 corrisponde a nord, 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
L'ora in cui è stato ricevuto questo aggiornamento dal veicolo.

VehicleWaypoint VehicleWaypoint

google.maps.journeySharing.VehicleWaypoint interfaccia

Tipo VehicleWaypoint.
distanceMeters optional
Tipo:  number optional
La distanza del percorso tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint in metri.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza dal waypoint precedente (o dalla posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) a questo waypoint in millisecondi.
location optional
Tipo:  LatLngLiteral optional
La posizione del waypoint.
path optional
Tipo:  Array<LatLngLiteral> optional
Il percorso dal waypoint precedente (o dalla posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) a 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. Ogni intervallo nell'elenco descrive il traffico su un segmento contiguo del percorso; l'intervallo definisce i punti iniziale e finale del segmento tramite i relativi indici. Per ulteriori dettagli, consulta la definizione di SpeedReadingInterval.

Interfaccia del veicolo

google.maps.journeySharing.Vehicle interfaccia

I dettagli di un veicolo restituiti da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi veicolo personalizzati.
name
Tipo:  string
Nel formato "providers/{provider_id}/vehicles/{vehicle_id}". vehicle_id deve essere un identificatore univoco.
navigationStatus
Lo stato attuale della navigazione del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza di guida rimanente nel segmento di percorso attuale, in metri.
vehicleState
Tipo:  VehicleState
Lo stato del veicolo.
vehicleType
Tipo:  VehicleType
Il tipo di veicolo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
Il waypoint in cui termina il segmento di percorso attuale.
currentRouteSegmentVersion optional
Tipo:  Date optional
L'ora in cui è stato impostato il segmento di percorso attuale.
currentTrips optional
Tipo:  Array<string> optional
Elenco degli ID corsa per le corse attualmente assegnate a questo veicolo.
etaToFirstWaypoint optional
Tipo:  Date optional
L'ETA per la 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 è incluso in questo valore.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipi di viaggi supportati da questo veicolo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
I restanti waypoint assegnati a questo veicolo.
waypointsVersion optional
Tipo:  Date optional
L'ultima volta che è stato aggiornato il campo dei waypoint.

Costanti VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus costanti

Lo stato di navigazione attuale di un Vehicle.

Accesso chiamando il numero const {VehicleNavigationStatus} = await google.maps.importLibrary("journeySharing").
Consulta 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 è entrata in modalità GUIDED_NAV.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
OFF_ROUTE Il veicolo si è allontanato dal percorso suggerito.
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.

Costanti VehicleState

google.maps.journeySharing.VehicleState costanti

Lo stato attuale di un Vehicle.

Accesso chiamando il numero const {VehicleState} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
OFFLINE Il veicolo non accetta nuove corse.
ONLINE Il veicolo accetta nuove corse.
UNKNOWN_VEHICLE_STATE Stato del veicolo sconosciuto.

Costanti VehicleType

google.maps.journeySharing.VehicleType costanti

Il tipo di Vehicle.

Accesso chiamando il numero const {VehicleType} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
AUTO Un'automobile.
TAXI Qualsiasi veicolo che funge da taxi (in genere con licenza o regolamentato).
TRUCK Un veicolo con una grande capacità di carico.
TWO_WHEELER Una motocicletta, un ciclomotore o un altro veicolo a due ruote.
UNKNOWN Tipo di veicolo sconosciuto.

Costanti TripType

google.maps.journeySharing.TripType costanti

Tipi di viaggi supportati da un Vehicle.

Accesso chiamando il numero const {TripType} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
EXCLUSIVE Il viaggio è esclusivo per un veicolo.
SHARED La corsa potrebbe condividere un veicolo con altre corse.
UNKNOWN_TRIP_TYPE Tipo di viaggio sconosciuto.

Interfaccia TripWaypoint

google.maps.journeySharing.TripWaypoint interfaccia

Tipo TripWaypoint.
distanceMeters optional
Tipo:  number optional
La distanza del percorso tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint in metri.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza dal waypoint precedente (o dalla posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) a questo waypoint in millisecondi.
location optional
Tipo:  LatLng optional
La posizione del waypoint.
path optional
Tipo:  Array<LatLng> optional
Il percorso dalla fermata precedente (o dalla posizione attuale del veicolo, se questa fermata è la prima nell'elenco delle fermate) 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. Ogni intervallo nell'elenco descrive il traffico su un segmento contiguo del percorso; l'intervallo definisce i punti iniziale e finale del segmento tramite i relativi indici. Per ulteriori dettagli, consulta la definizione di SpeedReadingInterval.
tripId optional
Tipo:  string optional
Il viaggio associato a questo waypoint.
waypointType optional
Tipo:  WaypointType optional
Il ruolo che svolge questo waypoint nel viaggio, ad esempio ritiro o consegna.

Costanti WaypointType

google.maps.journeySharing.WaypointType costanti

Tipi di waypoint supportati da Vehicle.

Accesso chiamando il numero const {WaypointType} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
DROP_OFF_WAYPOINT_TYPE Waypoint per accompagnare i passeggeri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Tappe per le destinazioni intermedie di un viaggio con più destinazioni.
PICKUP_WAYPOINT_TYPE Waypoint per il prelievo dei passeggeri.
UNKNOWN_WAYPOINT_TYPE Tipo di waypoint sconosciuto.

Interfaccia TimeWindow

google.maps.journeySharing.TimeWindow interfaccia

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

Costanti di velocità

google.maps.journeySharing.Speed costanti

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

Accesso chiamando il numero const {Speed} = await google.maps.importLibrary("journeySharing").
Consulta Librerie nell'API Maps JavaScript.
NORMAL Velocità normale, nessun rallentamento rilevato.
SLOW Rallentamento rilevato, ma non si è formata una coda.
TRAFFIC_JAM È stato rilevato un ingorgo stradale.

Interfaccia SpeedReadingInterval

google.maps.journeySharing.SpeedReadingInterval interfaccia

Indicatore della densità del traffico su un segmento di percorso contiguo. L'intervallo definisce i punti iniziale e finale 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.