Fleet Engine Entities

Interfaccia Task

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}". L'ID attività è 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 ID monitoraggio.
remainingVehicleJourneySegments
Informazioni sui segmenti da completare per questa attività.
status
Tipo:  string
Lo stato di esecuzione attuale dell'attività.
type
Tipo:  string
Il tipo di attività, ad esempio un'interruzione 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 località.
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 località dei risultati dell'attività ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime optional
Tipo:  Date optional
Il timestamp di quando è 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 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 di 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 di un oggetto informazioni di monitoraggio 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 modulo di normalizzazione Unicode C.
  • Non può contenere i seguenti caratteri ASCII: '/', ':', '?', ',' o '#'.
estimatedArrivalTime optional
Tipo:  Date optional
L'orario di arrivo previsto per la località della fermata.
estimatedTaskCompletionTime optional
Tipo:  Date optional
Il tempo stimato per il completamento di un'attività.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della località.
plannedLocation optional
Tipo:  LatLng optional
La posizione in cui verrà completata l'attività.
remainingDrivingDistanceMeters optional
Tipo:  number optional
La distanza totale rimanente in metri rispetto al VehicleStop di interesse.
remainingStopCount optional
Tipo:  number optional
Indica il numero di fermate del veicolo rimanenti fino all'interruzione dell'attività, inclusa quella dell'attività. Ad esempio, se la fermata successiva del veicolo è l'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 nella 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 eseguire un'attività.
taskOutcomeTime optional
Tipo:  Date optional
L'ora in cui il risultato dell'attività è stato impostato dal provider.

Interfaccia di 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 include il conducente.
remainingWaypoints
Un array di tappe che indicano il percorso dalla posizione corrente al punto di abbandono.
status
Tipo:  string
Lo 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 corsa. 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 ha lasciato il negozio.
actualPickupLocation optional
Tipo:  LatLngLiteral optional
Località in cui è stato ritirato il cliente.
dropOffTime optional
Tipo:  Date optional
L'orario futuro stimato in cui i passeggeri potranno lasciare l'auto o l'ora effettiva in cui li hanno lasciati.
latestVehicleLocationUpdate optional
Tipo:  VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della località.
pickupTime optional
Tipo:  Date optional
L'orario futuro stimato per il prelievo dei passeggeri o l'orario effettivo del prelievo.
plannedDropOffLocation optional
Tipo:  LatLngLiteral optional
Località in cui il cliente indica di essere lasciato.
plannedPickupLocation optional
Tipo:  LatLngLiteral optional
Luogo in cui il cliente indica che verrà ritirato.

Interfaccia Delivery Vehicle

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 dei veicoli di consegna.
name
Tipo:  string
Nel formato "providers/{provider_id}/delivery Vehicles/{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 percorsa in auto nel segmento del percorso corrente, in metri.
remainingVehicleJourneySegments
I segmenti del percorso assegnati a questo veicolo di consegna, a partire dalla posizione segnalata più di recente dal veicolo. Questo campo viene completato solo quando l'oggetto dati DeliveryVehicle viene fornito tramite FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint optional
Tipo:  LatLngLiteral optional
La località in cui termina il segmento 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 segmento di percorso corrente, in millisecondi.

Interfaccia Delivery VehicleStop

Interfaccia google.maps.journeySharing.DeliveryVehicleStop

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

Uniformi per i veicoli DeliveryStopState

google.maps.journeySharing.DeliveryVehicleStopState costanti

Lo stato attuale di 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 indirizzando alla fermata successiva, tutte le fermate precedenti siano state completate.
ENROUTE Assegnato e routing attivo.
NEW Creato, ma non instradato attivamente.
UNSPECIFIED Sconosciuto.

Interfaccia VehicleJourneySegment

Interfaccia google.maps.journeySharing.VehicleJourneySegment

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

Interfaccia VehicleLocationUpdate

Interfaccia google.maps.journeySharing.VehicleLocationUpdate

Tipo di 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.

Interfaccia EngineWaypoint

Interfaccia google.maps.journeySharing.VehicleWaypoint

Tipo di VehicleWaypoint.
distanceMeters optional
Tipo:  number optional
La distanza tra il percorso (tra il punto di accesso precedente e la posizione corrente del veicolo, se questo è il primo punto nell'elenco di tappe) a questo punto in metri.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza tra il punto di partenza precedente (o la posizione corrente del veicolo, se questo è il primo punto nell'elenco di tappe) per questo punto di accesso (in millisecondi).
location optional
Tipo:  LatLngLiteral optional
La posizione del tappeto.
path optional
Tipo:  Array<LatLngLiteral> optional
Il percorso dal punto di accesso precedente (o la posizione corrente del veicolo, se questo è il primo punto nell'elenco di tappe) a questo punto di accesso.

Interfaccia Veicolo

Interfaccia google.maps.journeySharing.Vehicle

I dettagli di un veicolo restituito da Fleet Engine.
attributes
Tipo:  Object<string, *>
Attributi personalizzati dei veicoli.
name
Tipo:  string
Nel formato "providers/{provider_id}/vehicles/{vehicle_id}". L'ID veicolo è un identificatore univoco.
navigationStatus
Lo stato di navigazione attuale del veicolo.
remainingDistanceMeters
Tipo:  number
La distanza percorsa in auto nel segmento del percorso corrente, in metri.
vehicleState
Tipo:  VehicleState
Lo stato del veicolo.
vehicleType
Tipo:  VehicleType
Il tipo di veicolo.
currentRouteSegmentEndPoint optional
Tipo:  TripWaypoint optional
Il punto in cui termina il segmento di percorso corrente.
currentRouteSegmentVersion optional
Tipo:  Date optional
Ora in cui è stato impostato il segmento di percorso corrente.
currentTrips optional
Tipo:  Array<string> optional
Elenco degli ID di corsa attualmente assegnati a questo veicolo.
etaToFirstWaypoint optional
Tipo:  Date optional
L'orario di arrivo stimato per la prima voce nel campo dei tappe.
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. L'autista non viene considerato in questo valore.
supportedTripTypes optional
Tipo:  Array<TripType> optional
Tipi di corsa supportati da questo veicolo.
waypoints optional
Tipo:  Array<TripWaypoint> optional
I rimanenti tappe assegnati a questo veicolo.
waypointsVersion optional
Tipo:  Date optional
L'ultima volta che il campo dei Waypoint è stato aggiornato.

costante di navigazione veicolo

google.maps.journeySharing.VehicleNavigationStatus costanti

Lo stato di navigazione corrente di 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 nell'app Driver è stata attivata in modalità GUIDED_NAV.
NO_GUIDANCE La navigazione dell'app Driver è in modalità FREE_NAV.
OFF_ROUTE Il veicolo ha percorso il percorso suggerito.
UNKNOWN_NAVIGATION_STATUS Stato di navigazione non specificato.

Costanti di StateState

google.maps.journeySharing.VehicleState costanti

Lo stato attuale di 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 agisce come 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 di 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 è esclusivo per un veicolo.
SHARED La corsa può condividere un veicolo con altri viaggi.
UNKNOWN_TRIP_TYPE Tipo di viaggio sconosciuto.

Interfaccia TripWaypoint

Interfaccia google.maps.journeySharing.TripWaypoint

Tipo di TripWaypoint.
distanceMeters optional
Tipo:  number optional
La distanza tra il percorso (tra il punto di accesso precedente e la posizione corrente del veicolo, se questo è il primo punto nell'elenco di tappe) a questo punto in metri.
durationMillis optional
Tipo:  number optional
Tempo di percorrenza tra il punto di partenza precedente (o la posizione corrente del veicolo, se questo è il primo punto nell'elenco di tappe) per questo punto di accesso (in millisecondi).
location optional
Tipo:  LatLngLiteral optional
La posizione del tappeto.
tripId optional
Tipo:  string optional
La corsa associata a questo tappeto.
waypointType optional
Tipo:  WaypointType optional
Il ruolo svolto da questo tappe in questa corsa, come il ritiro o la consegna.

costante di WaypointType

google.maps.journeySharing.WaypointType costanti

Tipi di tappe 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 lasciare i passeggeri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoint per destinazioni intermedie in una corsa che effettua più destinazioni.
PICKUP_WAYPOINT_TYPE Waypoint per ritirare i 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 dell'intervallo di tempo (incluso).
startTime
Tipo:  Date
L'ora di inizio dell'intervallo di tempo (incluso).