Method: providers.vehicles.create

Instanziiert ein neues Fahrzeug, das mit einem On-Demand-Mitfahrdienst oder Lieferdienst verknüpft ist. Jede Vehicle muss eine eindeutige Fahrzeug-ID haben.

Die folgenden Vehicle-Felder sind beim Erstellen eines Vehicle erforderlich:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

Die folgenden Vehicle-Felder werden beim Erstellen eines Vehicle ignoriert:

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

Alle anderen Felder sind optional und werden verwendet, sofern sie angegeben werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Muss das Format providers/{provider} haben. Der Anbieter muss die Projekt-ID des Google Cloud-Projekts sein, zu dem das Dienstkonto, das diesen Aufruf durchführt, gehört (z. B. sample-cloud-project).

Abfrageparameter

Parameter
header

object (RequestHeader)

Der standardmäßige Fleet Engine-Anfrageheader.
vehicleId

string

Erforderlich. Eindeutige Fahrzeug-ID. Es gelten die folgenden Einschränkungen:

  • Muss ein gültiger Unicode-String sein.
  • Sie ist auf maximal 64 Zeichen beschränkt.
  • Nach der Unicode-Normalisierungsform C normalisiert.
  • Darf keines der folgenden ASCII-Zeichen enthalten: '/', ':', '?', , oder '#'.

Anfragetext

Der Anfragetext enthält eine Instanz von Vehicle.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Vehicle.