Fleet Engine Entities

Interfaccia Task

interfaccia google.maps.journeySharing.Task

I dettagli di un'attività restituiti 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 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
Stato di esecuzione attuale dell'attività.
type
Tipo: string
Il tipo di attività, ad esempio una pausa o una spedizione.
estimatedCompletionTime
facoltativo
Tipo: Date optional
Il timestamp del tempo di completamento stimato dell'attività.
latestVehicleLocationUpdate
facoltativo
Tipo: VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della posizione.
outcome
facoltativo
Tipo: string optional
Il risultato dell'attività.
outcomeLocation
facoltativo
Tipo: LatLngLiteral optional
La località in cui è stata completata l'attività (dal provider).
outcomeLocationSource
facoltativo
Tipo: string optional
L'impostatore della località del risultato dell'attività ("PROVIDER" o "LAST_VEHICLE_LOCATION").
outcomeTime
facoltativo
Tipo: Date optional
Il timestamp di quando è stato impostato il risultato dell'attività (dal provider).
plannedLocation
facoltativo
Tipo: LatLngLiteral optional
La località in cui deve essere completata l'attività.
targetTimeWindow
facoltativo
Tipo: TimeWindow optional
La finestra temporale durante la quale l'attività deve essere completata.
trackingId
facoltativo
Tipo: string optional
L'ID monitoraggio della spedizione.
vehicleId
facoltativo
Tipo: string optional
L'ID del veicolo che esegue questa attività.

Interfaccia TaskInfo

interfaccia google.maps.journeySharing.TaskInfo

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

Interfaccia TaskTrackingInfo

interfaccia google.maps.journeySharing.TaskTrackingInfo

I dettagli di un oggetto di informazioni di monitoraggio del tracker 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.
  • Lunghezza massima di 64 caratteri.
  • Normalizzato in base alla forma di normalizzazione Unicode C.
  • Non può contenere nessuno dei seguenti caratteri ASCII: "/", ":", "?", "," o "#".
estimatedArrivalTime
facoltativo
Tipo: Date optional
L'ora di arrivo prevista alla località della fermata.
estimatedTaskCompletionTime
facoltativo
Tipo: Date optional
La data di completamento stimata di un'attività.
latestVehicleLocationUpdate
facoltativo
Tipo: VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della posizione.
plannedLocation
facoltativo
Tipo: LatLng optional
La località in cui verrà completata l'attività.
remainingDrivingDistanceMeters
facoltativo
Tipo: number optional
La distanza totale rimanente in metri fino alla VehicleStop di interesse.
remainingStopCount
facoltativo
Tipo: number optional
Indica il numero di fermate del veicolo rimanenti prima di raggiungere la fermata dell'attività, inclusa la fermata dell'attività. Ad esempio, se la fermata successiva del veicolo è quella dell'attività, il valore sarà 1.
routePolylinePoints
facoltativo
Tipo: Array<LatLng> optional
Un elenco di punti che, se collegati, formano una polilinea del percorso previsto del veicolo verso la località di questa attività.
state
facoltativo
Tipo: string optional
Stato di esecuzione attuale della Task.
targetTimeWindow
facoltativo
Tipo: TimeWindow optional
La finestra temporale durante la quale l'attività deve essere completata.
taskOutcome
facoltativo
Tipo: string optional
Il risultato del tentativo di esecuzione di un'attività.
taskOutcomeTime
facoltativo
Tipo: Date optional
L'ora in cui il risultato dell'attività è stato impostato dal fornitore.

Interfaccia Trip

interfaccia google.maps.journeySharing.Trip

I dettagli di un percorso 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 questa corsa, escluso il conducente.
remainingWaypoints
Un array di tappe che indicano il percorso dalla posizione attuale al punto di arrivo.
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 corsa. I valori possibili sono UNKNOWN_TRIP_TYPE, SHARED o EXCLUSIVE.
vehicleId
Tipo: string
ID del veicolo che effettua il percorso.
actualDropOffLocation
facoltativo
Tipo: LatLngLiteral optional
Località in cui il cliente è stato lasciato.
actualPickupLocation
facoltativo
Tipo: LatLngLiteral optional
La località in cui il cliente è stato prelevato.
dropOffTime
facoltativo
Tipo: Date optional
L'orario futuro stimato in cui i passeggeri verranno lasciati o l'orario effettivo in cui sono stati lasciati.
latestVehicleLocationUpdate
facoltativo
Tipo: VehicleLocationUpdate optional
Informazioni specifiche sull'ultimo aggiornamento della posizione.
pickupTime
facoltativo
Tipo: Date optional
L'orario futuro stimato in cui i passeggeri verranno prelevati o l'orario effettivo in cui sono stati prelevati.
plannedDropOffLocation
facoltativo
Tipo: LatLngLiteral optional
La località in cui il cliente indica che verrà lasciato.
plannedPickupLocation
facoltativo
Tipo: LatLngLiteral optional
Località in cui il cliente indica che verrà prelevato.

Interfaccia DeliveryVehicle

interfaccia google.maps.journeySharing.DeliveryVehicle

I dettagli di un veicolo di consegna restituiti da Fleet Engine.
attributes
Tipo: Object<string, string optional>
Attributi personalizzati del veicolo di consegna.
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 segmento di percorso corrente, in metri.
remainingVehicleJourneySegments
I segmenti del percorso assegnati a questo veicolo per le consegne, a partire dalla posizione più recente segnalata dal veicolo. Questo campo viene compilato solo quando l'oggetto dati DeliveryVehicle viene fornito tramite FleetEngineDeliveryVehicleLocationProvider.
currentRouteSegmentEndPoint
facoltativo
Tipo: LatLngLiteral optional
La posizione in cui termina il segmento di percorso corrente.
latestVehicleLocationUpdate
facoltativo
Tipo: VehicleLocationUpdate optional
L'ultima posizione segnalata del veicolo di consegna.
remainingDurationMillis
facoltativo
Tipo: number optional
La durata di guida rimanente nel segmento di percorso corrente, in millisecondi.

Interfaccia DeliveryVehicleStop

interfaccia google.maps.journeySharing.DeliveryVehicleStop

Tipo DeliveryVehicleStop
tasks
L'elenco delle attività da eseguire in questa fermata.
  • id: l'ID dell'attività.
  • extraDurationMillis: il tempo aggiuntivo necessario per eseguire l'attività, in millisecondi.
plannedLocation
facoltativo
Tipo: LatLngLiteral optional
La posizione della fermata.
state
facoltativo
Lo stato della fermata.

Costanti DeliveryVehicleStopState

constants google.maps.journeySharing.DeliveryVehicleStopState
library "journeySharing"

Lo stato attuale di un DeliveryVehicleStop.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo DeliveryVehicleStopStateString.

const {DeliveryVehicleStopState} = await google.maps.importLibrary("journeySharing");
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 con routing attivo.
NEW Creato, ma non indirizza attivamente.
UNSPECIFIED Sconosciuto.

Interfaccia VehicleJourneySegment

interfaccia google.maps.journeySharing.VehicleJourneySegment

Tipo VehicleJourneySegment
drivingDistanceMeters
facoltativo
Tipo: number optional
La distanza di viaggio dalla fermata precedente a questa fermata, in metri.
drivingDurationMillis
facoltativo
Tipo: number optional
Il tempo di percorrenza dalla fermata precedente a questa, in millisecondi.
path
facoltativo
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
facoltativo
Tipo: DeliveryVehicleStop optional
Informazioni sulla fermata.

Interfaccia VehicleLocationUpdate

interfaccia google.maps.journeySharing.VehicleLocationUpdate

Tipo VehicleLocationUpdate
heading
facoltativo
Tipo: number optional
L'intestazione dell'aggiornamento. 0 corrisponde al nord, 180 al sud.
location
facoltativo
Tipo: LatLngLiteral|LatLng optional
La località dell'aggiornamento.
speedKilometersPerHour
facoltativo
Tipo: number optional
La velocità in chilometri orari.
time
facoltativo
Tipo: Date optional
L'ora in cui questo aggiornamento è stato ricevuto dal veicolo.

Interfaccia VehicleWaypoint

interfaccia google.maps.journeySharing.VehicleWaypoint

Tipo VehicleWaypoint.
distanceMeters
facoltativo
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
facoltativo
Tipo: number optional
Tempo di percorrenza tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint in millisecondi.
location
facoltativo
Tipo: LatLngLiteral optional
La posizione del waypoint.
path
facoltativo
Tipo: Array<LatLngLiteral> optional
Il percorso dalla tappa precedente (o dalla posizione attuale del veicolo, se questa tappa è la prima nell'elenco delle tappe) a questa tappa.
speedReadingIntervals
facoltativo
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 Vehicle

interfaccia google.maps.journeySharing.Vehicle

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

Costanti VehicleNavigationStatus

constants google.maps.journeySharing.VehicleNavigationStatus
library "journeySharing"

Lo stato di navigazione corrente di un Vehicle.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo VehicleNavigationStatusString.

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

Costanti VehicleState

constants google.maps.journeySharing.VehicleState
library "journeySharing"

Lo stato attuale di un Vehicle.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo VehicleStateString.

const {VehicleState} = await google.maps.importLibrary("journeySharing");
OFFLINE Il veicolo non accetta nuove corse.
ONLINE Il veicolo accetta nuove corse.
UNKNOWN_VEHICLE_STATE Stato del veicolo sconosciuto.

Costanti VehicleType

constants google.maps.journeySharing.VehicleType
library "journeySharing"

Il tipo di Vehicle.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("journeySharing");
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 moto, un ciclomotore o un altro veicolo a due ruote.
UNKNOWN Tipo di veicolo sconosciuto.

Costanti TripType

constants google.maps.journeySharing.TripType
library "journeySharing"

Tipi di corse supportati da un Vehicle.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo TripTypeString.

const {TripType} = await google.maps.importLibrary("journeySharing");
EXCLUSIVE La corsa è esclusiva per un veicolo.
SHARED La corsa potrebbe condividere un veicolo con altre corse.
UNKNOWN_TRIP_TYPE Tipo di viaggio sconosciuto.

Interfaccia TripWaypoint

interfaccia google.maps.journeySharing.TripWaypoint

Tipo TripWaypoint.
distanceMeters
facoltativo
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
facoltativo
Tipo: number optional
Tempo di percorrenza tra il waypoint precedente (o la posizione attuale del veicolo, se questo waypoint è il primo nell'elenco dei waypoint) e questo waypoint in millisecondi.
location
facoltativo
Tipo: LatLng optional
La posizione del waypoint.
path
facoltativo
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
facoltativo
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
facoltativo
Tipo: string optional
La corsa associata a questo waypoint.
waypointType
facoltativo
Tipo: WaypointType optional
Il ruolo che questo waypoint svolge in questa corsa, ad esempio ritiro o consegna.

Costanti WaypointType

constants google.maps.journeySharing.WaypointType
library "journeySharing"

Tipi di waypoint supportati da Vehicle.

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo WaypointTypeString.

const {WaypointType} = await google.maps.importLibrary("journeySharing");
DROP_OFF_WAYPOINT_TYPE Waypoint per far scendere i passeggeri.
INTERMEDIATE_DESTINATION_WAYPOINT_TYPE Waypoint per le destinazioni intermedie di un viaggio con più destinazioni.
PICKUP_WAYPOINT_TYPE Waypoint per il ritiro 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à

constants google.maps.journeySharing.Speed
library "journeySharing"

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

Queste costanti sono utilizzabili anche come stringhe. In TypeScript, i valori letterali stringa sono definiti dal tipo SpeedString.

const {Speed} = await google.maps.importLibrary("journeySharing");
NORMAL Velocità normale, non viene rilevato alcun rallentamento.
SLOW Rallentamento rilevato, ma non si è formato un ingorgo.
TRAFFIC_JAM Rilevato ingorgo stradale.

Interfaccia SpeedReadingInterval

interfaccia google.maps.journeySharing.SpeedReadingInterval

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