Trang này được dịch bởi Cloud Translation API.

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 Công cụ quản lý đội xe, hãy cung cấp cho công cụ này một luồng thông tin cập nhật vị trí của xe ít nhất một lần mỗi phút và nhiều nhất một lần mỗi 5 giây. Bạn có thể sử dụng một trong những cách sau để cung cấp thông tin cập nhật này:

Sử dụng SDK trình điều khiển: Cách đơ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ợ 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 trình bày phương pháp đó.

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

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

Bạn có thể sử dụng thư viện gRPC Java để cập nhật vị trí của xe trong Công cụ quản lý đội xe hoặc sử dụng 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

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ường	Giá trị
`lastLocation.supplementalLocation`	Vị trí của xe.
`lastLocation.supplementalLocationTime`	Dấu thời gian gần đây nhất xác định được là xe ở vị trí này.
`lastLocation.supplementalLocationSensor`	Phải được điền bằng `CUSTOMER_SUPPLIED_LOCATION`.

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

Trường Giá trị

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

Trường	Giá 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

Mua xe giao hàng