Method: providers.vehicles.create

Tworzony jest nowy pojazd powiązany z usługą wspólnych przejazdów na żądanie lub z dostawcą. Każdy element Vehicle musi mieć unikalny identyfikator pojazdu.

Podczas tworzenia Vehicle wymagane są te pola Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Podczas tworzenia Vehicle te pola Vehicle są ignorowane:

  • name
  • currentTrips
  • availableCapacity
  • currentRouteSegment
  • currentRouteSegmentEndPoint
  • currentRouteSegmentVersion
  • currentRouteSegmentTraffic
  • route
  • waypoints
  • waypointsVersion
  • remainingDistanceMeters
  • remainingTimeSeconds
  • eta_to_next_waypoint
  • navigationStatus

Wszystkie pozostałe pola są opcjonalne i są używane, jeśli zostały podane.

Żądanie HTTP

POST https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Musi mieć format providers/{provider}. Dostawca musi być identyfikatorem projektu (np. sample-cloud-project) projektu Google Cloud, którego członkiem jest konto usługi wywołujące to wywołanie.

Parametry zapytania

Parametry
header

object (RequestHeader)

Standardowy nagłówek żądania Fleet Engine.

vehicleId

string

Wymagane. Unikalny identyfikator pojazdu. Obowiązują następujące ograniczenia:

  • Musi być prawidłowym ciągiem znaków Unicode.
  • Może mieć maksymalnie 64 znaki.
  • Znormalizowane zgodnie z formularzem normalizacji Unicode C.
  • Nie może zawierać następujących znaków ASCII: „/”, „:”, „?”, „,” ani „#”.

Treść żądania

Treść żądania zawiera wystąpienie elementu Vehicle.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Vehicle.