Method: providers.vehicles.create
יצירת רכב חדש שמשויך לספק של שירותי שיתוף נסיעות או משלוחים על פי דרישה. לכל Vehicle צריך להיות מזהה רכב ייחודי.
חובה למלא את השדות הבאים ב-Vehicle כשיוצרים Vehicle:
vehicleStatesupportedTripTypesmaximumCapacityvehicleType
השדות הבאים של Vehicle מתעלמים כשיוצרים Vehicle:
namecurrentTripsavailableCapacitycurrentRouteSegmentcurrentRouteSegmentEndPointcurrentRouteSegmentVersioncurrentRouteSegmentTrafficroutewaypointswaypointsVersionremainingDistanceMetersremainingTimeSecondseta_to_next_waypointnavigationStatus
כל שאר השדות הם אופציונליים, והמערכת משתמשת בהם אם הם צוינו.
בקשת 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.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-08 (שעון UTC).
[null,null,["עדכון אחרון: 2024-11-08 (שעון UTC)."],[[["Instantiates a new vehicle associated with an on-demand rideshare or deliveries provider, requiring a unique vehicle ID for each vehicle."],["When creating a `Vehicle`, `vehicleState`, `supportedTripTypes`, `maximumCapacity`, and `vehicleType` fields are required; while fields like `name`, `currentTrips`, `availableCapacity`, and route-related fields are ignored."],["Sends a POST request to `https://fleetengine.googleapis.com/v1/{parent=providers/*}/vehicles` to create a vehicle, with the provider specified in the path parameter."],["Requires a `header` for the Fleet Engine request and a unique `vehicleId` in the query parameters, adhering to specified restrictions for the `vehicleId` format."],["Includes the `Vehicle` object details in the request body and returns the newly created `Vehicle` object in the response body upon successful creation."]]],[]]
