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

מתקרב

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

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

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

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

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

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