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 dla podróży obecnie przypisanych do tego pojazdu.

object (VehicleLocation)

Ostatnio zgłoszona lokalizacja pojazdu.

integer

Łączna liczba pasażerów, których może przewieźć pojazd. W tej wartości nie uwzględnia się kierowcy. Ta wartość musi być większa niż lub równa 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 pojazdu. Można go użyć do filtrowania pojazdów w wynikach vehicles.search. Wpływa też na szacowany czas dotarcia na miejsce i obliczanie trasy.

object (LicensePlate)

Informacje o tablicy rejestracyjnej pojazdu.

object (TerminalLocation)

Wycofane: użyj w zastępstwie zasady Vehicle.waypoints.

string

Linia łamana określająca trasę, którą aplikacja kierowcy ma poprowadzić do następnego punktu orientacyjnego. Ta lista jest również zwracana w Trip.current_route_segment dla wszystkich aktywnych przejazdów przypisanych do pojazdu.

Uwaga: to pole jest przeznaczone tylko do użycia 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życia przez pakiet Driver SDK.

string (Timestamp format)

Tylko dane wyjściowe. Czas ustawienia 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 formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy 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. Kierowcy mogą podać te informacje podczas wywołania vehicles.update jako punkt na całej trasie, punkt na trasie LatLng lub ostatni LatLng na currentRouteSegment. Fleet Engine zrobi, co w jego mocy, aby interpolować do rzeczywistego punktu kontrolnego, jeśli nie jest on w pełni określony. To pole jest ignorowane w wywołaniach vehicles.update, chyba że podano też parametr currentRouteSegment.

integer

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

string (Timestamp format)

Przewidywany czas dotarcia do pierwszego elementu w polu waypoints. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona.

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

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc 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. Jeśli pole waypoints lub Vehicle.current_route_segment jest puste, wartość jest nieokreślona. Ta wartość powinna być równa etaToFirstWaypoint - 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. Ostatnia aktualizacja 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 formacie RFC3339 UTC „Zulu” z rozdzielczością nanosekundy 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 przejazdy z kolei. 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ć 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 opcje stringValue i value są ustawione, muszą być identyczne, w przeciwnym razie wystąpi błąd. Oba pola są wypełniane w odpowiedziach.

boolean

Wartość atrybutu typu logicznego.

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 numeru rejestracyjnego lub „-1”, aby wskazać, że numer rejestracyjny nie zawiera wartości liczbowej.

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

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

object (VisualTrafficReportPolylineRendering)

Renderowanie łamanej szybkości 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, na której ma być zastosowany styl.

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

enum (LocationPowerSaveMode)

Jak funkcje lokalizacji działają na urządzeniu, gdy włączone jest oszczędzanie baterii.

boolean

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

boolean

Określa, czy urządzenie jest w stanie interaktywnym.

object (BatteryInfo)

Informacje o stanie baterii.

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

enum (BatteryStatus)

Stan baterii, czy jest naładowana, czy ładowana itp.

enum (PowerSource)

Stan źródła zasilania baterii.

number

Aktualny poziom naładowania baterii [0–100].