डिलीवरी करने वाले वाहन की जगह की जानकारी अपडेट करना

तरीके

Fleet Engine की मदद से बेहतर परफ़ॉर्मेंस पाने के लिए, इसे वाहन की जगह की जानकारी के अपडेट की स्ट्रीम दें. यह अपडेट, कम से कम हर मिनट में एक बार और ज़्यादा से ज़्यादा हर पांच सेकंड में एक बार दिया जाना चाहिए. ये अपडेट देने के लिए, इनमें से कोई एक तरीका अपनाएं:

  • Driver SDK का इस्तेमाल करना: यह सबसे आसान विकल्प है.
  • कस्टम कोड का इस्तेमाल करना: यह विकल्प तब काम आता है, जब जगह की जानकारी आपके बैकएंड से रिले की जाती है या Android या iOS के अलावा अन्य डिवाइसों का इस्तेमाल किया जाता है. इस दस्तावेज़ में उस तरीके के बारे में बताया गया है.

वाहन की जगह की जानकारी के अपडेट देने का तरीका चाहे जो भी हो, आपका बैकएंड, Fleet Engine को अपडेट करने के लिए ज़िम्मेदार होता है. ऐसा तब होता है, जब डिलीवरी वाहन किसी स्टॉप पर जा रहा हो और जब वह किसी स्टॉप पर पहुंचता है. इसमें डिपो भी शामिल है. Fleet Engine, इन इवेंट का पता अपने-आप नहीं लगाता.

वाहन की जगह की जानकारी अपडेट करने के उदाहरण

Fleet Engine में किसी वाहन की जगह की जानकारी अपडेट करने के लिए, Java gRPC लाइब्रेरी या REST का इस्तेमाल किया जा सकता है. इसके बारे में यहां दिए गए उदाहरण में बताया गया है. जिन भाषाओं में यह सुविधा उपलब्ध है उनकी पूरी सूची देखने के लिए, शेड्यूल किए गए टास्क की सेवाओं के लिए क्लाइंट लाइब्रेरी लेख पढ़ें.

Java

  static final String PROJECT_ID = "my-delivery-co-gcp-project";
  static final String VEHICLE_ID = "vehicle-8241890";

  DeliveryServiceBlockingStub deliveryService =
    DeliveryServiceGrpc.newBlockingStub(channel);

  // Vehicle settings
  String vehicleName = "providers/" + PROJECT_ID + "/deliveryVehicles/" + VEHICLE_ID;
  DeliveryVehicle myDeliveryVehicle = DeliveryVehicle.newBuilder()
      .setLastLocation(DeliveryVehicleLocation.newBuilder()
          .setSupplementalLocation(LatLng.newBuilder()
              .setLatitude(37.3382)
              .setLongitude(121.8863))
          .setSupplementalLocationTime(now())
          .setSupplementalLocationSensor(DeliveryVehicleLocationSensor.CUSTOMER_SUPPLIED_LOCATION)
          .setSupplementalLocationAccuracy(DoubleValue.of(15.0)))  // Optional
      .build();

  // DeliveryVehicle request
  UpdateDeliveryVehicleRequest updateDeliveryVehicleRequest =
    UpdateDeliveryVehicleRequest.newBuilder()  // No need for the header
        .setName(vehicleName)
        .setDeliveryVehicle(myDeliveryVehicle)
        .setUpdateMask(FieldMask.newBuilder()
            .addPaths("last_location"))
        .build();

  try {
    DeliveryVehicle updatedDeliveryVehicle =
        deliveryService.updateDeliveryVehicle(updateDeliveryVehicleRequest);
  } catch (StatusRuntimeException e) {
    Status s = e.getStatus();
    switch (s.getCode()) {
       case NOT_FOUND:
         break;
       case PERMISSION_DENIED:
         break;
    }
    return;
  }

आराम का समय

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/deliveryVehicles/<id>?updateMask=last_location

अनुरोध की जानकारी

अनुरोध के मुख्य हिस्से में, DeliveryVehicle इकाई होनी चाहिए. इसमें फ़ील्ड की जानकारी इस तरह दी गई हो:

  • ज़रूरी फ़ील्ड:

    फ़ील्डवैल्यू
    lastLocation.supplementalLocation वाहन की जगह की जानकारी.
    lastLocation.supplementalLocationTime वह आखिरी टाइमस्टैंप जब वाहन इस जगह पर था.
    lastLocation.supplementalLocationSensor CUSTOMER_SUPPLIED_LOCATION से भरा होना चाहिए.

  • ये फ़ील्ड ज़रूरी नहीं हैं:

    फ़ील्डवैल्यू
    lastLocation.supplementalLocationAccuracy दी गई जगह की सटीक जानकारी, मीटर में. 

  # Set JWT, PROJECT_ID, VEHICLE_ID, TASK1_ID, and TASK2_ID in the local
  # environment
  curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/deliveryVehicles/${VEHICLE_ID}?updateMask=remainingVehicleJourneySegments" \
    -H "Content-type: application/json" \
    -H "Authorization: Bearer ${JWT}" \
    --data-binary @- << EOM
  {
    "lastLocation": {
      "supplementalLocation": {"latitude": 12.1, "longitude": 14.5},
      "supplementalLocationTime": "$(date -u --iso-8601=seconds)",
      "supplementalLocationSensor": "CUSTOMER_SUPPLIED_LOCATION",
      "supplementalLocationAccuracy": 15
    }
  }
  EOM

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