Method: providers.vehicles.create

Instanziiert ein neues Fahrzeug, das mit einem On-Demand-Anbieter für Mitfahrdienste verknüpft ist. Jeder Vehicle muss eine eindeutige Fahrzeug-ID haben.

Die folgenden Vehicle-Felder sind beim Erstellen von 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 angegeben.

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 gehört, das diesen Aufruf durchführt, z. B. sample-cloud-project.

Abfrageparameter

Parameter
header

object (RequestHeader)

Der standardmäßige Fleet Engine-Anfrageheader.
vehicleId

string

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

  • Muss ein gültiger Unicode-String sein.
  • Er ist auf maximal 64 Zeichen begrenzt.
  • Normalisiert nach der Unicode-Normalisierungsform C.
  • Darf keine 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.