Chuẩn bị xe sẵn sàng

Phần này cho biết cách chuẩn bị xe cho các nhiệm vụ đã lên lịch. Bạn phải hoàn tất từng bước sau đây trước khi phần phụ trợ có thể so khớp một xe với một nhiệm vụ.

Thiết lập trình nghe

Vì SDK trình điều khiển thực hiện các thao tác ở chế độ nền, hãy sử dụng DriverStatusListener để kích hoạt thông báo khi một số sự kiện nhất định xảy ra, chẳng hạn như lỗi, cảnh báo hoặc thông báo gỡ lỗi. Lỗi có thể mang tính tạm thời (chẳng hạn như BACKEND_CONNECTIVITY_ERROR) hoặc có thể khiến quá trình cập nhật vị trí dừng vĩnh viễn. Ví dụ: nếu bạn nhận được lỗi VEHICLE_NOT_FOUND, thì đó là lỗi cấu hình.

Ví dụ sau đây cho thấy cách triển khai DriverStatusListener:

class MyStatusListener implements DriverStatusListener {
  /** Called when background status is updated, during actions such as location reporting. */
  @Override
  public void updateStatus(
      StatusLevel statusLevel, StatusCode statusCode, String statusMsg, @Nullable Throwable cause) {
    // Existing implementation

    if (cause != null && cause instanceof StatusRuntimeException) {
      if (Status.NOT_FOUND.getCode().equals(cause.getStatus().getCode())) {
        // NOT_FOUND gRPC exception thrown by Fleet Engine.
      }
    }
  }
}

DriverContextBuilder.setDriverStatusListener(new MyStatusListener());

Bật thông báo cập nhật vị trí

Sau khi bạn có một thực thể *VehicleReporter, hãy bật tính năng cập nhật vị trí như sau:

Java

DeliveryVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

(Không bắt buộc) Đặt khoảng thời gian cập nhật

Theo mặc định, SDK Trình điều khiển sẽ gửi thông tin cập nhật vị trí theo khoảng thời gian 10 giây. Mỗi lần cập nhật vị trí cũng cho biết rằng xe đang có kết nối mạng. Bạn có thể thay đổi khoảng thời gian này bằng reporter.setLocationReportingInterval(long, TimeUnit). Khoảng thời gian cập nhật tối thiểu được hỗ trợ là 5 giây. Việc cập nhật thường xuyên hơn có thể khiến các yêu cầu chậm hơn và gặp lỗi.