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

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

גישות

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

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

ללא קשר לאופן שבו אתם מספקים עדכונים לגבי מיקום הרכב, הקצה העורפי שלכם אחראי לעדכן את Fleet Engine כשרכב מסירה בדרך לתחנה וכשהוא מגיע לתחנה. כולל המאגר עצמו. מערכת Fleet Engine לא מזהה את האירועים האלה באופן אוטומטי.

דוגמאות לעדכון מיקום הרכב

אפשר להשתמש בספריית gRPC של Java כדי לעדכן את המיקום של רכב ב-Fleet Engine, או להשתמש ב-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

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

• קבלת רכב להעברת מוצרים