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,
  "flpLocation": {
    object (LatLng)
  },
  "flpUpdateTime": string,
  "flpLatlngAccuracyMeters": number,
  "flpHeadingDegrees": integer,
  "supplementalLocation": {
    object (LatLng)
  },
  "supplementalLocationTime": string,
  "supplementalLocationSensor": enum (LocationSensor),
  "supplementalLocationAccuracy": number,
  "roadSnapped": boolean
}
Campi
location

object (LatLng)

La posizione del veicolo. Quando viene inviata a Fleet Engine, la posizione del veicolo è una posizione GPS. Quando lo 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

Direzione di movimento del veicolo in gradi. 0 rappresenta il nord. L'intervallo valido è [0,360).
bearingAccuracy
(deprecated)

number

Deprecato: utilizza headingAccuracy.
headingAccuracy

number

Precisione di heading gradi.
altitude

number

Altitudine in metri sopra il WGS84.
verticalAccuracy
(deprecated)

number

Deprecato: utilizza altitudeAccuracy.
altitudeAccuracy

number

Precisione di altitude metri.
speedKmph
(deprecated)

integer

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

number

Velocità del veicolo in metri/secondo
speedAccuracy

number

Precisione di speed in metri/secondo.
updateTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serverTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
locationSensor

enum (LocationSensor)

Fornitore dei 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) trascorso da quando questa posizione è stata inviata per la prima volta al server. Questo valore sarà zero per il primo aggiornamento. Se l'ora non è nota (ad esempio, quando l'app viene riavviata), questo valore viene reimpostato su zero.
numStaleUpdates
(deprecated)

integer

Solo input. Obsoleto: ora vengono utilizzati altri indicatori per determinare se una posizione è obsoleta.
rawLocation

object (LatLng)

Posizione grezza del veicolo (non elaborata da road-snapper).
rawLocationTime

string (Timestamp format)

Timestamp associato alla posizione non elaborata.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
rawLocationSensor

enum (LocationSensor)

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

number

Precisione di rawLocation come raggio, in metri.
flpLocation

object (LatLng)

La posizione fornita da Fused Location Provider di Android.
flpUpdateTime

string (Timestamp format)

Aggiorna il timestamp di flpLocation

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
flpLatlngAccuracyMeters

number

Precisione di flpLocation metri come raggio.
flpHeadingDegrees

integer

Direzione di movimento del veicolo in gradi, determinata dal Fused Location Provider. 0 rappresenta il nord. L'intervallo valido è [0,360).
supplementalLocation

object (LatLng)

Posizione supplementare fornita dall'app di integrazione.
supplementalLocationTime

string (Timestamp format)

Timestamp associato alla posizione supplementare.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
supplementalLocationSensor

enum (LocationSensor)

Origine della posizione 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 della torre 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 stradale più probabile.
CUSTOMER_SUPPLIED_LOCATION Una località fornita dal cliente da una fonte indipendente. In genere, questo valore viene utilizzato per una posizione fornita da fonti diverse dal dispositivo mobile che esegue Driver SDK. Se l'origine originale è descritta da uno degli altri valori enum, utilizza quel valore. Le posizioni contrassegnate come CUSTOMER_SUPPLIED_LOCATION vengono in genere fornite tramite il lastLocation.supplemental_location_sensor del veicolo.
FLEET_ENGINE_LOCATION Una posizione calcolata da Fleet Engine in base ai segnali a sua disposizione. Solo output. Questo valore verrà rifiutato se ricevuto in una richiesta.
FUSED_LOCATION_PROVIDER Fused Location Provider di Android.
CORE_LOCATION Il fornitore di servizi di localizzazione sui sistemi operativi Apple.