Cập nhật vị trí giao hàng của xe

Phương pháp

Để có hiệu suất tốt nhất với Fleet Engine, hãy cung cấp cho Fleet Engine một luồng thông báo cập nhật vị trí của xe ít nhất một lần mỗi phút và tối đa một lần mỗi 5 giây. Hãy sử dụng một trong các cách sau để cung cấp những thông tin cập nhật này:

  • Sử dụng Driver SDK: Lựa chọn đơn giản nhất.
  • Sử dụng mã tuỳ chỉnh: hữu ích nếu vị trí được chuyển tiếp qua phần phụ trợ của bạn hoặc nếu bạn sử dụng các thiết bị không phải Android hoặc iOS. Tài liệu này đề cập đến phương pháp đó.

Bất kể bạn cung cấp thông báo cập nhật vị trí của xe như thế nào, phần phụ trợ của bạn có trách nhiệm cập nhật Fleet Engine khi xe giao hàng đang trên đường đến một điểm dừng và khi xe đến một điểm dừng. Điều này bao gồm cả chính kho hàng. Fleet Engine không tự động phát hiện các sự kiện này.

Ví dụ về cách cập nhật vị trí xe

Để cập nhật vị trí của xe trong Fleet Engine, bạn có thể sử dụng thư viện gRPC Java hoặc REST, như trong ví dụ sau. Để xem danh sách đầy đủ các ngôn ngữ được hỗ trợ, hãy xem bài viết Thư viện ứng dụng cho dịch vụ tác vụ theo lịch.

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

Thông tin chi tiết về yêu cầu

Nội dung yêu cầu phải chứa một thực thể DeliveryVehicle chỉ định các trường như sau:

  • Các trường bắt buộc:

    TrườngGiá trị
    lastLocation.supplementalLocation Vị trí của xe.
    lastLocation.supplementalLocationTime Dấu thời gian gần đây nhất xác định được xe ở vị trí này.
    lastLocation.supplementalLocationSensor Phải được điền bằng CUSTOMER_SUPPLIED_LOCATION.

  • Trường tuỳ chọn:

    TrườngGiá trị
    lastLocation.supplementalLocationAccuracy Độ chính xác của vị trí được cung cấp, tính bằng mét. 

  # 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

Bước tiếp theo