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 C.
  • לא יכול להכיל אף אחד מתווי ASCII הבאים: '/', ':', '?', ' או '#'.

גוף הבקשה

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

גוף התשובה

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