Fleet Engine Entities

Interfaccia dell'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 archiviare 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 di completamento stimato dell'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della posizione.
outcome optional
Tipo:  string optional
L'esito dell'attività.
outcomeLocation optional
Tipo:  LatLngLiteral optional
La posizione in cui è stata completata l'attività (dal provider).
outcomeLocationSource optional
Tipo:  string optional
L'attributo setter della posizione del risultato dell'attività ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
Il timestamp del momento in cui è stato impostato il risultato dell'attività (dal fornitore).
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 l'attività deve essere completata.
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 l'attività deve essere completata.

Interfaccia TaskTrackingInfo

google.maps.journeySharing.TaskTrackingInfo interfaccia

I dettagli di un oggetto di informazioni sul 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.
  • Sono consentiti massimo 64 caratteri.
  • Normalizzato in base al formato di normalizzazione Unicode C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.
estimatedArrivalTime optional
Tipo:  Date optional
L'orario di arrivo stimato alla fermata.
estimatedTaskCompletionTime optional
Tipo:  Date optional
Il tempo di completamento stimato di un'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche sull'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 fino al VehicleStop di interesse.
remainingStopCount optional
Tipo:  number optional
Indica il numero di fermate rimanenti per il veicolo fino al raggiungimento della fermata dell'attività, inclusa la fermata dell'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, formano un 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 l'attività deve essere completata.
taskOutcome optional
Tipo:  string optional
Il risultato del tentativo di esecuzione di un'attività.
taskOutcomeTime optional
Tipo:  Date optional
L'ora in cui il fornitore ha impostato il risultato dell'attività.

Interfaccia di Trip

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; non è incluso il conducente.
remainingWaypoints
Un array di waypoint che indica il percorso dalla posizione attuale al punto di consegna.
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
Posizione in cui il cliente è stato lasciato.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente è stato ritirato.
dropOffTime optional
Tipo:  Date optional
L'ora futura stimata in cui i passeggeri verranno lasciati o l'ora effettiva in cui sono stati lasciati.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della posizione.
pickupTime optional
Tipo:  Date optional
L'ora futura stimata in cui i passeggeri verranno raccolti o l'ora effettiva in cui sono stati raccolti.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente indica di essere in attesa.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente indica di essere disponibile per il ritiro.

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 dei veicoli 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 di navigazione attuale del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza di guida rimanente nel tratto di percorso corrente, in metri.
remainingVehicleJourneySegments
I segmenti di viaggio assegnati a questo veicolo di consegna, a partire dalla posizione segnalata più di recente del veicolo. Viene compilato solo quando 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 di consegna.
remainingDurationMillis optional
Tipo:  number optional
La durata rimanente della guida nel tratto di percorso corrente, in millisecondi.

Interfaccia DeliveryVehicleStop

google.maps.journeySharing.DeliveryVehicleStop interfaccia

Tipo DeliveryVehicleStop
tasks
Tipo:  Array<TaskInfo>
L'elenco di attività da eseguire 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.

Accedi chiamando const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
ARRIVED Arrivato alla fermata. Si presume che, quando il veicolo si dirige verso la fermata successiva, tutte le fermate precedenti siano state completate.
ENROUTE Assegnati e in routing attivo.
NEW Creato, ma non instradamento attivo.
UNSPECIFIED Sconosciuto.

Interfaccia VehicleJourneySegment

google.maps.journeySharing.VehicleJourneySegment interfaccia

Tipo di 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 percorrenza 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 di aggiornamento della posizione del veicolo
heading optional
Tipo:  number optional
La voce 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 all'ora.
time optional
Tipo:  Date optional
L'ora in cui questo aggiornamento è stato ricevuto dal veicolo.

Interfaccia VehicleWaypoint

google.maps.journeySharing.VehicleWaypoint interfaccia

Tipo di waypoint del veicolo.
distanceMeters optional
Tipo:  number optional
La distanza in metri tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza in millisecondi tra il waypoint precedente (o la posizione corrente del veicolo, se questo waypoint è il primo nell'elenco di waypoint) e questo waypoint.
location optional
Tipo:  LatLngLiteral optional
La posizione del waypoint.
path optional
Tipo:  Array<LatLngLiteral> optional
Il percorso dal waypoint precedente (o dalla posizione corrente 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 corrente. Ogni intervallo nell'elenco descrive il traffico su un segmento contiguo del percorso. L'intervallo definisce i punti di inizio e di fine 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}". L'attributo vehicle_id deve essere un identificatore univoco.
navigationStatus
Lo stato di navigazione attuale del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza di guida rimanente nel tratto di percorso corrente, 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 tratto di percorso corrente.
currentRouteSegmentVersion optional
Tipo:  Date optional
Ora in cui è stato impostato il tratto di percorso corrente.
currentTrips optional
Tipo:  Array<string> optional
Elenco di ID viaggio per i viaggi attualmente assegnati a questo veicolo.
etaToFirstWaypoint optional
Tipo:  Date optional
L'orario di arrivo stimato alla prima voce del 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 il veicolo può trasportare. Il conducente non viene considerato in questo valore.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipi di viaggi supportati da questo veicolo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
I waypoint rimanenti assegnati a questo veicolo.
waypointsVersion optional
Tipo:  Date optional
Data dell'ultimo aggiornamento del campo dei waypoint.

Costanti VehicleNavigationStatus

google.maps.journeySharing.VehicleNavigationStatus costanti

Lo stato di navigazione attuale di un 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 m dalla destinazione.
ENROUTE_TO_DESTINATION La navigazione passo passo è disponibile e la navigazione dell'app Driver è passata alla modalità GUIDED_NAV.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
OFF_ROUTE Il veicolo ha deviato dal percorso suggerito.
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.

Costanti VehicleState

google.maps.journeySharing.VehicleState costanti

Lo stato attuale di un 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 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 (in genere autorizzato o regolamentato).
TRUCK Un veicolo con una grande capacità di carico.
TWO_WHEELER Una motocicletta, un motorino 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.

Accedi chiamando const {TripType} = await google.maps.importLibrary("journeySharing"). Consulta la sezione Librerie nell'API Maps JavaScript.
EXCLUSIVE Il viaggio è riservato a 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 di waypoint di viaggio.
distanceMeters optional
Tipo:  number optional
La distanza in metri tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza in millisecondi tra il waypoint precedente (o la posizione corrente del veicolo, se questo waypoint è il primo nell'elenco di waypoint) e questo waypoint.
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 corrente. Ogni intervallo nell'elenco descrive il traffico su un segmento contiguo del percorso. L'intervallo definisce i punti di inizio e di fine 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 di questo waypoint in questo viaggio, ad esempio ritiro o consegna.

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 discesa dei passeggeri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoint per le destinazioni intermedie in 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 (valore inserito incluso).

Costanti velocità

google.maps.journeySharing.Speed costanti

La classificazione della velocità del 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 Rallentamento rilevato, ma non si è formato ingorgo.
TRAFFIC_JAM È stato rilevato un ingorgo.

Interfaccia SpeedReadingInterval

google.maps.journeySharing.SpeedReadingInterval interfaccia

Indicatore della densità del traffico in un tratto di percorso contiguo. L'intervallo definisce i punti di inizio e di fine del segmento tramite i relativi indici.
endPolylinePointIndex
Tipo:  number
L'indice a partire da zero del punto di fine dell'intervallo nel percorso.
speed
Tipo:  Speed
Velocità del traffico in questo intervallo.
startPolylinePointIndex
Tipo:  number
L'indice a partire da zero del punto iniziale dell'intervallo nel percorso.