VehicleLocation

Lokalizacja, prędkość i kierunek pojazdu w danym momencie.

Zapis 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
}
Pola
location

object (LatLng)

Lokalizacja pojazdu. Gdy jest wysyłana do Fleet Engine, lokalizacja pojazdu jest lokalizacją GPS. Gdy otrzymasz ją w odpowiedzi, lokalizacja pojazdu może być lokalizacją GPS, lokalizacją dodatkową lub inną lokalizacją szacunkową. Źródło jest określone w locationSensor.

horizontalAccuracy
(deprecated)

number

Wycofana: zamiast niej używaj zasady latlngAccuracy.

latlngAccuracy

number

Dokładność location w metrach jako promień.

heading

integer

Kierunek, w którym porusza się pojazd, w stopniach. 0 oznacza północ. Prawidłowy zakres to [0,360).

bearingAccuracy
(deprecated)

number

Wycofana: zamiast niej używaj zasady headingAccuracy.

headingAccuracy

number

Dokładność heading w stopniach.

altitude

number

Wysokość w metrach nad poziomem WGS84.

verticalAccuracy
(deprecated)

number

Wycofana: zamiast niej używaj zasady altitudeAccuracy.

altitudeAccuracy

number

Dokładność altitude w metrach.

speedKmph
(deprecated)

integer

Prędkość pojazdu w kilometrach na godzinę. Wycofana: zamiast niej używaj zasady speed.

speed

number

Prędkość pojazdu w metrach na sekundę

speedAccuracy

number

Dokładność speed w metrach na sekundę.

updateTime

string (Timestamp format)

Czas, w którym czujnik zgłosił wartość location zgodnie z zegarem czujnika.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

serverTime

string (Timestamp format)

Tylko dane wyjściowe. Czas, w którym serwer otrzymał informacje o lokalizacji.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

locationSensor

enum (LocationSensor)

Dostawca danych o lokalizacji (np. GPS).

isRoadSnapped

boolean

Określa, czy ikona location jest przyciągana do drogi.

isGpsSensorEnabled

boolean

Tylko dane wejściowe. Określa, czy na urządzeniu mobilnym jest włączony czujnik GPS.

timeSinceUpdate

integer

Tylko dane wejściowe. Czas (w sekundach) od momentu, gdy ta lokalizacja została po raz pierwszy wysłana na serwer. W przypadku pierwszej aktualizacji będzie to zero. Jeśli czas jest nieznany (np. po ponownym uruchomieniu aplikacji), ta wartość jest resetowana do zera.

numStaleUpdates
(deprecated)

integer

Tylko dane wejściowe. Wycofano: do określania, czy lokalizacja jest nieaktualna, używane są teraz inne sygnały.

rawLocation

object (LatLng)

Surowa lokalizacja pojazdu (nieprzetworzona przez funkcję przyciągania do drogi).

rawLocationTime

string (Timestamp format)

Sygnatura czasowa powiązana z nieprzetworzoną lokalizacją.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

rawLocationSensor

enum (LocationSensor)

Źródło nieprzetworzonej lokalizacji. Domyślna wartość to GPS.

rawLocationAccuracy

number

Dokładność rawLocation jako promień w metrach.

flpLocation

object (LatLng)

Lokalizacja z usługi lokalizacyjnej Androida.

flpUpdateTime

string (Timestamp format)

Aktualizacja sygnatury czasowej flpLocation

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

flpLatlngAccuracyMeters

number

Dokładność flpLocation w metrach jako promień.

flpHeadingDegrees

integer

Kierunek, w którym porusza się pojazd, w stopniach, określony przez dostawcę połączonej lokalizacji. 0 oznacza północ. Prawidłowy zakres to [0,360).

supplementalLocation

object (LatLng)

Dodatkowa lokalizacja podana przez aplikację integrującą.

supplementalLocationTime

string (Timestamp format)

Sygnatura czasowa powiązana z dodatkową lokalizacją.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

supplementalLocationSensor

enum (LocationSensor)

Źródło dodatkowej lokalizacji. Domyślna wartość to CUSTOMER_SUPPLIED_LOCATION.

supplementalLocationAccuracy

number

Dokładność supplementalLocation jako promień w metrach.

roadSnapped
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady isRoadSnapped.

LocationSensor

Czujnik lub metodologia użyte do określenia lokalizacji.

Wartości w polu enum
UNKNOWN_SENSOR Czujnik jest nieokreślony lub nieznany.
GPS GPS lub wspomagany GPS.
NETWORK GPS wspomagany, identyfikator stacji bazowej lub punkt dostępu Wi-Fi.
PASSIVE Identyfikator stacji bazowej lub punktu dostępu Wi-Fi.
ROAD_SNAPPED_LOCATION_PROVIDER Lokalizacja określona przez urządzenie mobilne jako najbardziej prawdopodobne położenie na drodze.
CUSTOMER_SUPPLIED_LOCATION Lokalizacja podana przez klienta z niezależnego źródła. Zwykle ta wartość jest używana w przypadku lokalizacji pochodzącej ze źródeł innych niż urządzenie mobilne, na którym działa pakiet Driver SDK. Jeśli pierwotne źródło jest opisane przez jedną z innych wartości wyliczeniowych, użyj tej wartości. Lokalizacje oznaczone jako CUSTOMER_SUPPLIED_LOCATION są zwykle podawane przez lastLocation.supplemental_location_sensor pojazdu.
FLEET_ENGINE_LOCATION Lokalizacja obliczona przez Fleet Engine na podstawie dostępnych sygnałów. Tylko dane wyjściowe. Jeśli ta wartość zostanie przesłana w żądaniu, zostanie odrzucona.
FUSED_LOCATION_PROVIDER Dostawca uśrednionej lokalizacji na Androidzie.
CORE_LOCATION Dostawca lokalizacji w systemach operacyjnych Apple.