VehicleLocation

La posizione, la velocità e la direzione di un veicolo in un determinato momento.

Rappresentazione JSON
{
  "location": {
    object (LatLng)
  },
  "horizontalAccuracy": number,
  "latlngAccuracy": number,
  "heading": integer,
  "bearingAccuracy": number,
  "headingAccuracy": number,
  "altitude": number,
  "verticalAccuracy": number,
  "altitudeAccuracy": number,
  "speedKmph": integer,
  "speed": number,
  "speedAccuracy": number,
  "updateTime": string,
  "serverTime": string,
  "locationSensor": enum (LocationSensor),
  "isRoadSnapped": boolean,
  "isGpsSensorEnabled": boolean,
  "timeSinceUpdate": integer,
  "numStaleUpdates": integer,
  "rawLocation": {
    object (LatLng)
  },
  "rawLocationTime": string,
  "rawLocationSensor": enum (LocationSensor),
  "rawLocationAccuracy": number,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (LocationSensor),
  "supplementalLocationAccuracy": number,
  "roadSnapped": boolean
}
Campi
location

object (LatLng)

La posizione del veicolo. Quando viene inviato a Fleet Engine, la posizione del veicolo è una posizione GPS. Quando la ricevi in una risposta, la posizione del veicolo può essere una posizione GPS, una posizione supplementare o un'altra posizione stimata. L'origine è specificata in locationSensor.

horizontalAccuracy
(deprecated)

number

Deprecato: utilizza latlngAccuracy.

latlngAccuracy

number

Precisione di location metri come raggio.

heading

integer

La direzione di spostamento del veicolo in gradi. 0 rappresenta il nord. L'intervallo valido è [0,360).

bearingAccuracy
(deprecated)

number

Deprecato: usa invece headingAccuracy.

headingAccuracy

number

Precisione di heading gradi.

altitude

number

Altitudine in metri sopra WGS84.

verticalAccuracy
(deprecated)

number

Deprecato: usa invece altitudeAccuracy.

altitudeAccuracy

number

Precisione di altitude in metri.

speedKmph
(deprecated)

integer

Velocità del veicolo in chilometri all'ora. Deprecato: usa invece speed.

speed

number

Velocità del veicolo in metri/secondo

speedAccuracy

number

Precisione di speed in metri al secondo.

updateTime

string (Timestamp format)

L'ora in cui location è stato registrato dal sensore in base all'orologio del sensore.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

serverTime

string (Timestamp format)

Solo output. L'ora in cui il server ha ricevuto le informazioni sulla posizione.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

locationSensor

enum (LocationSensor)

Fornitore di dati sulla posizione (ad esempio GPS).

isRoadSnapped

boolean

Indica se location è agganciato a una strada.

isGpsSensorEnabled

boolean

Solo input. Indica se il sensore GPS è abilitato sul dispositivo mobile.

timeSinceUpdate

integer

Solo input. Tempo (in secondi) dall'invio della posizione al server per la prima volta. Sarà pari a zero per il primo aggiornamento. Se l'ora è sconosciuta (ad esempio quando l'app si riavvia), questo valore viene reimpostato su zero.

numStaleUpdates
(deprecated)

integer

Solo input. Ritiro: ora vengono utilizzati altri indicatori per determinare se una località è obsoleta.

rawLocation

object (LatLng)

Posizione del veicolo grezzo (non elaborata da un esperto di autovelox).

rawLocationTime

string (Timestamp format)

Timestamp associato alla posizione non elaborata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

rawLocationSensor

enum (LocationSensor)

Origine della posizione non elaborata. Il valore predefinito è GPS.

rawLocationAccuracy

number

Precisione di rawLocation come raggio, in metri.

supplementalLocation

object (LatLng)

Posizione supplementare fornita dall'app di integrazione.

supplementalLocationTime

string (Timestamp format)

Timestamp associato alla stazione di ricarica supplementare.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

supplementalLocationSensor

enum (LocationSensor)

Origine della località supplementare. Il valore predefinito è CUSTOMER_SUPPLIED_LOCATION.

supplementalLocationAccuracy

number

Precisione di supplementalLocation come raggio, in metri.

roadSnapped
(deprecated)

boolean

Deprecato: utilizza isRoadSnapped.

LocationSensor

Il sensore o la metodologia utilizzati per determinare la posizione.

Enum
UNKNOWN_SENSOR Il sensore non è specificato o sconosciuto.
GPS GPS o GPS assistito.
NETWORK GPS assistito, ID ripetitore cellulare o punto di accesso Wi-Fi.
PASSIVE ID torre cellulare o punto di accesso Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Una posizione determinata dal dispositivo mobile come la posizione più probabile sulla strada.
CUSTOMER_SUPPLIED_LOCATION Una località fornita dal cliente da una fonte indipendente. In genere, questo valore viene utilizzato per una posizione fornita da origini diverse dal dispositivo mobile su cui è in esecuzione l'SDK Driver. Se l'origine originale è descritta da uno degli altri valori dell'enum, utilizza quel valore. Le località contrassegnate come CUSTOMER_SUPPLIED_LOCATION vengono in genere fornite tramite l'elemento lastLocation.supplemental_location_sensor di un veicolo.
FLEET_ENGINE_LOCATION Una posizione calcolata da Fleet Engine in base agli indicatori a sua disposizione. Solo output. Questo valore verrà rifiutato se viene ricevuto in una richiesta.
FUSED_LOCATION_PROVIDER Fused Location Provider di Android.
CORE_LOCATION Il fornitore di servizi di geolocalizzazione sui sistemi operativi Apple.