REST Resource: providers.vehicles

{
  "name": string,
  "vehicleState": enum (VehicleState),
  "supportedTripTypes": [
    enum (TripType)
  ],
  "currentTrips": [
    string
  ],
  "lastLocation": {
    object (VehicleLocation)
  },
  "maximumCapacity": integer,
  "attributes": [
    {
      object (VehicleAttribute)
    }
  ],
  "vehicleType": {
    object (VehicleType)
  },
  "licensePlate": {
    object (LicensePlate)
  },
  "route": [
    {
      object (TerminalLocation)
    }
  ],
  "currentRouteSegment": string,
  "currentRouteSegmentTraffic": {
    object (TrafficPolylineData)
  },
  "currentRouteSegmentVersion": string,
  "currentRouteSegmentEndPoint": {
    object (TripWaypoint)
  },
  "remainingDistanceMeters": integer,
  "etaToFirstWaypoint": string,
  "remainingTimeSeconds": integer,
  "waypoints": [
    {
      object (TripWaypoint)
    }
  ],
  "waypointsVersion": string,
  "backToBackEnabled": boolean,
  "navigationStatus": enum (NavigationStatus),
  "deviceSettings": {
    object (DeviceSettings)
  }
}

string

Tylko dane wyjściowe. Niepowtarzalna nazwa tego pojazdu. Format to providers/{provider}/vehicles/{vehicle}.

enum (VehicleState)

Stan pojazdu.

enum (TripType)

Typy podróży obsługiwane przez ten pojazd.

string

Tylko dane wyjściowe. Lista tripId na potrzeby podróży aktualnie przypisanych do tego pojazdu.

object (VehicleLocation)

Ostatnio zgłoszona lokalizacja pojazdu.

integer

Łączna liczba osób, które może przewieźć ten pojazd. Kierowca nie jest uwzględniany w tej wartości. Ta wartość nie może być mniejsza niż 1.

object (VehicleAttribute)

Lista atrybutów pojazdu. Pojazd może mieć maksymalnie 100 atrybutów, a każdy atrybut musi mieć unikalny klucz.

object (VehicleType)

Wymagane. Typ tego pojazdu. Może służyć do filtrowania pojazdów w wynikach wyszukiwania w usłudze vehicles.search. Wpływa też na szacowany czas dotarcia na miejsce i obliczanie trasy.

object (LicensePlate)

Informacje o tablicach rejestracyjnych pojazdu.

object (TerminalLocation)

Wycofane: użyj atrybutu Vehicle.waypoints.

string

Linia łamana określająca trasę, którą aplikacja kierowcy zamierza podążać do następnego punktu pośredniego. Ta lista jest też zwracana w języku Trip.current_route_segment w przypadku wszystkich aktywnych podróży przypisanych do pojazdu.

Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK. Dekodowanie nie jest jeszcze obsługiwane.

object (TrafficPolylineData)

Tylko dane wejściowe. Fleet Engine używa tych informacji do ulepszania udostępniania przejazdów. Uwaga: to pole jest przeznaczone tylko do użytku przez pakiet Driver SDK.

string (Timestamp format)

Tylko dane wyjściowe. Czas ustawienia parametru currentRouteSegment. Może być przechowywany przez klienta i przekazywana w przyszłych żądaniach vehicles.get, aby zapobiec zwrotowi tras, które nie uległy zmianie.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

object (TripWaypoint)

Punkt na trasie, w którym kończy się currentRouteSegment. Mogą je przekazać kierowcy podczas połączeń vehicles.update jako punkt na trasie obejmującej całą podróż, jako punkt pośredni LatLng lub jako ostatni element LatLng pojazdu currentRouteSegment. Jeśli nie zostanie w pełni określony, Fleet Engine podejmie wtedy wszelkie możliwe działania, aby interpolować do rzeczywistego punktu pośredniego. To pole jest ignorowane w wywołaniach vehicles.update, chyba że określono też pole currentRouteSegment.

integer

Pozostały dystans jazdy samochodem przez currentRouteSegment. Ta wartość jest też zwracana w polu Trip.remaining_distance_meters w przypadku wszystkich aktywnych podróży przypisanych do pojazdu. Wartość jest nieokreślona, jeśli pole currentRouteSegment jest puste.

string (Timestamp format)

Szacowany czas dotarcia na miejsce do pierwszego wpisu w polu waypoints. Wartość jest nieokreślona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste.

Podczas aktualizowania pojazdu zasada remainingTimeSeconds ma w tym samym żądaniu pierwszeństwo przed zasadą etaToFirstWaypoint.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

integer

Tylko dane wejściowe. Pozostały czas jazdy samochodem currentRouteSegment. Wartość jest nieokreślona, jeśli pole waypoints jest puste lub pole Vehicle.current_route_segment jest puste. Ta wartość powinna pasować do zakresu od etaToFirstWaypoint do current_time, jeśli wszystkie strony używają tego samego zegara.

Podczas aktualizowania pojazdu zasada remainingTimeSeconds ma w tym samym żądaniu pierwszeństwo przed zasadą etaToFirstWaypoint.

object (TripWaypoint)

Pozostałe punkty na trasie przypisane do tego pojazdu.

string (Timestamp format)

Tylko dane wyjściowe. Data ostatniej aktualizacji pola waypoints. Klienty powinny buforować tę wartość i przekazywać ją w narzędziu GetVehicleRequest, aby mieć pewność, że pole waypoints będzie zwracane tylko wtedy, gdy zostanie zaktualizowane.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

boolean

Wskazuje, czy kierowca akceptuje połączenia w obie strony. Jeśli zasada true, vehicles.search może uwzględniać pojazd, nawet jeśli jest przypisany do podróży. Wartością domyślną jest false.

enum (NavigationStatus)

Stan nawigacji pojazdu.

object (DeviceSettings)

Tylko dane wejściowe. Informacje o ustawieniach urządzenia mobilnego używanego przez kierowcę.

{
  "key": string,
  "value": string,

  // Union field vehicle_attribute_value can be only one of the following:
  "stringValue": string,
  "boolValue": boolean,
  "numberValue": number
  // End of list of possible types for union field vehicle_attribute_value.
}

string

Klucz atrybutu. Klucze nie mogą zawierać znaku dwukropka (:).

string

Wartość atrybutu.

string

Wartość atrybutu z ciągiem znaków.

Uwaga: działa tak samo jak pole value, które z czasem zostanie wycofane. Do tworzenia i aktualizacji danych możesz użyć dowolnego z tych pól, ale zdecydowanie zalecamy użycie stringValue. Jeśli ustawione są zarówno wartości stringValue, jak i value, muszą one być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

boolean

Wartość atrybutu wpisanego z użyciem wartości logicznej.

number

Wartość atrybutu została wpisana dwukrotnie.

{
  "category": enum (Category)
}

enum (Category)

Kategoria typu pojazdu

{
  "countryCode": string,
  "lastCharacter": string
}

string

Wymagane. Kod kraju/regionu CLDR. Na przykład US w przypadku Stanów Zjednoczonych lub IN w przypadku Indii.

string

Ostatnia cyfra tablicy rejestracyjnej lub „-1” oznacza brak wartości liczbowej na tablicy rejestracyjnej.

• „ABC 1234” -> „4”
• „AB 123 CD” -> „3”
• „ABCDEF” -> „–1”

{
  "trafficRendering": {
    object (VisualTrafficReportPolylineRendering)
  }
}

object (VisualTrafficReportPolylineRendering)

Renderowanie łamane pokazujące prędkość ruchu we wszystkich regionach na jednym odcinku przejazdu klienta.

{
  "roadStretch": [
    {
      object (RoadStretch)
    }
  ]
}

object (RoadStretch)

Opcjonalnie: Odcinki dróg, które powinny być renderowane wzdłuż linii łamanej. Rozciągnięcia nie nakładają się na siebie i nie muszą obejmować całej trasy.

Jeśli nie ma rozciągania drogi do stylu, klient powinien zastosować do trasy domyślną wartość.

{
  "style": enum (Style),
  "offsetMeters": integer,
  "lengthMeters": integer
}

enum (Style)

Wymagane. Styl, który ma zostać zastosowany.

integer

Wymagane. Styl powinien być stosowany między [offsetMeters, offsetMeters + lengthMeters).

integer

Wymagane. Długość ścieżki, w której chcesz zastosować styl.

{
  "locationPowerSaveMode": enum (LocationPowerSaveMode),
  "isPowerSaveMode": boolean,
  "isInteractive": boolean,
  "batteryInfo": {
    object (BatteryInfo)
  }
}

enum (LocationPowerSaveMode)

Jak funkcje lokalizacji działają na urządzeniu po włączeniu oszczędzania baterii.

boolean

Określa, czy urządzenie jest obecnie w trybie oszczędzania energii.

boolean

Wskazuje, czy urządzenie jest w trybie interaktywnym.

object (BatteryInfo)

Informacje o stanie baterii.

{
  "batteryStatus": enum (BatteryStatus),
  "powerSource": enum (PowerSource),
  "batteryPercentage": number
}

enum (BatteryStatus)

Stan baterii, stan naładowania, stan naładowania itd.

enum (PowerSource)

Stan źródła zasilania baterii.

number

Bieżąca wartość procentowa baterii [0–100].