Method: providers.vehicles.create

יוצרות רכב חדש שמשויך לספק נסיעות או משלוחים על פי דרישה. לכל Vehicle צריך להיות מזהה רכב ייחודי.

כשיוצרים Vehicle, צריך למלא את השדות הבאים של Vehicle:

  • vehicleState
  • supportedTripTypes
  • maximumCapacity
  • vehicleType

כשיוצרים Vehicle, המערכת מתעלמת מהשדות הבאים של Vehicle:

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

כל שאר השדות הם אופציונליים ונעשה בהם שימוש אם ציינתם אותם.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. חייב להיות בפורמט providers/{provider}. הספק צריך להיות מזהה הפרויקט (למשל sample-cloud-project) של הפרויקט ב-Google Cloud שמשויך לחשבון השירות שמבצע את הקריאה הזו.

פרמטרים של שאילתה

פרמטרים
header

object (RequestHeader)

כותרת הבקשה הרגילה של Fleet Engine.
vehicleId

string

חובה. מזהה רכב ייחודי. בכפוף להגבלות הבאות:

  • חייבת להיות מחרוזת Unicode חוקית.
  • מוגבל לאורך מקסימלי של 64 תווים.
  • מנורמל לפי טופס נירמול Unicode.
  • אינו יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ',' או '#'.

גוף הבקשה

גוף הבקשה מכיל מופע של Vehicle.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע חדש של Vehicle שנוצר.