עדכון מיקום הרכב למשלוח

הערה: לפני שיוצרים בקשה לרכב, קראו את הדרישות בקטע בקשות לרכב במבוא.

גישות

כדי ליהנות מהביצועים הטובים ביותר של Fleet Engine, מומלץ לספק לו עדכונים לגבי מיקום הרכב לפחות פעם בדקה, ולא יותר מפעם ב-5 שניות. אפשר להשתמש באחת מהדרכים הבאות כדי לספק את העדכונים האלה:

• להשתמש ב-Driver SDK: האפשרות הכי פשוטה.
• שימוש בקוד מותאם אישית: שימושי אם המיקומים מועברים דרך הקצה העורפי, או אם אתם משתמשים במכשירים שאינם Android או iOS. במסמך הזה נתמקד בגישה הזו.

לא משנה איך אתם מספקים עדכונים לגבי מיקום הרכב, ה-backend שלכם אחראי לעדכן את 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;
  }

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

המאמרים הבאים

• השגת רכב משלוחים