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

तरीके

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

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

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

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

Fleet में किसी वाहन की जगह की जानकारी अपडेट करने के लिए, 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;
  }

REST

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

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