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 Normalization Form C.
  • אסור לכלול את תווים ה-ASCII הבאים: '/',‏ ':',‏ '?',‏ ',' או '#'.

גוף הבקשה

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

גוף התשובה

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