मांग पर यात्रा के लिए वाहन बनाएं

मांग पर यात्राओं के लिए, फ़्लीट इंजन में वाहन बनाने के लिए, CreateVehicle का इस्तेमाल करें एंडपॉइंट CreateVehicleRequest के साथ होना चाहिए. इस एंडपॉइंट के लिए, आपके पास Fleet Engine के ऑन-डिमांड एडमिन की भूमिका वाला खाता होना चाहिए.

मांग पर यात्रा वाले वाहनों के लिए फ़ील्ड

मांग पर मिलने वाली यात्राओं के लिए वाहन बनाते समय, आपको ज़रूरी फ़ील्ड सेट करने होंगे. आपको यह भी पता होना चाहिए कि वाहन के कुछ फ़ील्ड, Fleet Engine की अन्य सुविधाओं पर कैसे असर डालते हैं. इसके बारे में जानने के लिए, वाहन के फ़ील्ड अपडेट करें पर जाएं.

मांग पर उपलब्ध यात्राओं के लिए ज़रूरी फ़ील्ड

  • vehicle_state: डिफ़ॉल्ट तौर पर, कोई जानकारी नहीं होती है. हालांकि, यह 'ऑनलाइन' या 'ऑनलाइन' पर सेट होना चाहिए ऑफ़लाइन. अपडेट करें' सेक्शन में, वाहन की स्थिति वाला फ़ील्ड सेट करने के बारे में जानकारी देखें वाहन के फ़ील्ड.
  • supported_trip_types: डिफ़ॉल्ट रूप से, इसकी वैल्यू 'जानकारी नहीं है' पर सेट होती है. हालांकि, इसे SHARED, EXCLUSIVE या दोनों पर सेट किया जाना चाहिए. ज़्यादा जानकारी के लिए, ऑन-डिमांड यात्राएं के लिए बनी गाइड में यात्रा के टाइप देखें.
  • maximum_capacity: वाहन में कितने यात्री चल सकते हैं, इसमें ड्राइवर शामिल नहीं होता है (परिभाषा के मुताबिक).
  • vehicle_type: वैल्यू AUTO, TAXI, TRUCK, TWO_WHEELER हैं, BICYCLE या PEDESTRIAN. इसका इस्तेमाल, वाहनों के लिए वाहनों को फ़िल्टर करने के लिए किया जा सकता है खोजें. इससे ETA और रास्ते के कैलकुलेशन पर भी असर पड़ता है. Fleet Engine, वाहन के इन टाइप के ग्रुप के आधार पर, यात्रा के तरीके के हिसाब से रास्ते और यात्रा के समय का हिसाब लगाता है:
    • AUTO, TAXI या TRUCK: उदाहरण के लिए, हाइवे.
    • TWO_WHEELER: उदाहरण के लिए, उन रास्तों की जानकारी नहीं दिखाई जाएगी जहां दोपहिया वाहन नहीं हैं अनुमति है.
    • BICYCLE: उदाहरण के लिए, साइकल का पाथ.
    • PEDESTRIAN: उदाहरण के लिए, सिर्फ़ पैदल चलने के लिए बने ब्रिज और रास्ते.

अन्य फ़ील्ड

वाहन बनाते समय सेट किए जा सकने वाले अन्य फ़ील्ड देखने के लिए, वाहन की जानकारी अपडेट करें फ़ील्ड.

वाहन बनाने का उदाहरण

CreateVehicle से मिली वैल्यू, बनाई गई Vehicle इकाई है.

Java

static final String PROJECT_ID = "project-id";

VehicleServiceBlockingStub vehicleService =
    VehicleService.newBlockingStub(channel);

String parent = "providers/" + PROJECT_ID;
Vehicle vehicle = Vehicle.newBuilder()
    .setVehicleState(VehicleState.OFFLINE)  // Initial state
    .addSupportedTripTypes(TripType.EXCLUSIVE)
    .setMaximumCapacity(4)
    .setVehicleType(VehicleType.newBuilder().setCategory(VehicleType.Category.AUTO))
    .addAttributes(VehicleAttribute.newBuilder()
        .setKey("on_trip").setValue("false"))  // Opaque to the Fleet Engine
    // Add .setBackToBackEnabled(true) to make this vehicle eligible for trip
    // matching while even if it is on a trip.  By default this is disabled.
    .build();

CreateVehicleRequest createVehicleRequest =
    CreateVehicleRequest.newBuilder()  // no need for the header
        .setParent(parent)
        .setVehicleId("vid-8241890")  // Vehicle ID assigned by Rideshare or Delivery Provider
        .setVehicle(vehicle)  // Initial state
        .build();

// In this case, the Vehicle is being created in the OFFLINE state and
// no initial position is being provided.  When the Driver App checks
// in with the Rideshare or Delivery Provider, the state can be set to ONLINE and
// the Driver App will update the Vehicle Location.

try {
  Vehicle createdVehicle =
      vehicleService.createVehicle(createVehicleRequest);
} catch (StatusRuntimeException e) {
  Status s = e.getStatus();
  switch (s.getCode()) {
    case ALREADY_EXISTS:
      break;
    case PERMISSION_DENIED:
      break;
  }
  return;
}
// If no Exception, Vehicle created successfully.

आराम

curl -X POST \
  "https://fleetengine.googleapis.com/v1/providers/project-id/vehicles?vehicleId=vid-8241890" \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  --data-binary @- << EOM
{
    "vehicleState": "OFFLINE",
    "supportedTripTypes": ["EXCLUSIVE"],
    "maximumCapacity": 4,
    "vehicleType": {"category": "AUTO"},
    "attributes": [{"key": "on_trip", "value": "false"}]
}
EOM

providers.vehicles.create का रेफ़रंस देखें.

आगे क्या करना है