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 inviata 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

Direzione di marcia 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: utilizza altitudeAccuracy.

altitudeAccuracy

number

Precisione di altitude metri.

speedKmph
(deprecated)

integer

Velocità del veicolo in chilometri orari. Deprecato: utilizza 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 il sensore ha segnalato location in base all'orologio del sensore.

Un timestamp nel formato "Zulu" RFC3339 UTC, 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 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".

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 iniziale di questa posizione al server. Il valore sarà zero per il primo aggiornamento. Se l'ora non è nota (ad esempio, al riavvio dell'app), questo valore viene reimpostato su zero.

numStaleUpdates
(deprecated)

integer

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

rawLocation

object (LatLng)

Posizione non elaborata del veicolo (non elaborata da RoadSnapper).

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 località 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 località supplementare.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi 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: usa invece 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 torre cellulare o punto di accesso Wi-Fi.
PASSIVE ID ripetitore di telefonia mobile 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 fonti 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 il 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 posizione sui sistemi operativi Apple.