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

Obsoleto: utilizza latlngAccuracy.

latlngAccuracy

number

Precisione di location in metri come raggio.

heading

integer

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

bearingAccuracy
(deprecated)

number

Obsoleto: utilizza headingAccuracy.

headingAccuracy

number

Precisione di heading in gradi.

altitude

number

Altitudine in metri sopra WGS84.

verticalAccuracy
(deprecated)

number

Obsoleto: utilizza altitudeAccuracy.

altitudeAccuracy

number

Precisione di altitude in metri.

speedKmph
(deprecated)

integer

Velocità del veicolo in chilometri orari. Obsoleto: 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 il valore di location è stato segnalato dal sensore in base all'orologio del sensore.

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

timeSinceUpdate

integer

Solo input. Tempo (in secondi) dall'invio della posizione al server. Il valore sarà zero per il primo aggiornamento. Se l'ora non è nota (ad esempio, quando l'app si riavvia), 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 avvistatori stradali).

rawLocationTime

string (Timestamp format)

Timestamp associato alla posizione non elaborata.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 integrata.

supplementalLocationTime

string (Timestamp format)

Timestamp associato alla località supplementare.

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

Obsoleto: 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 di telefonia mobile o punto di accesso Wi-Fi.
PASSIVE ID ripetitore di telefonia mobile o punto di accesso Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Una posizione stabilita dal dispositivo mobile come la posizione della strada più probabile.
CUSTOMER_SUPPLIED_LOCATION Una località fornita dal cliente da una fonte indipendente. In genere, questo valore viene utilizzato per una località fornita da origini diverse dal dispositivo mobile che esegue l'SDK Driver. Se la fonte originale è descritta da uno degli altri valori enum, utilizza quel valore. In genere, le sedi contrassegnate con CUSTOMER_SUPPLIED_LOCATION vengono fornite tramite il lastLocation.supplemental_location_sensor del veicolo.
FLEET_ENGINE_LOCATION Una località calcolata da Fleet Engine in base agli indicatori a sua disposizione. Solo output. Questo valore viene rifiutato se viene ricevuto in una richiesta.
FUSED_LOCATION_PROVIDER Fused Location Provider di Android.
CORE_LOCATION Il fornitore della posizione nei sistemi operativi Apple.