เตรียมยานพาหนะให้พร้อม

ส่วนนี้จะแสดงวิธีเตรียมรถให้พร้อมสําหรับงานที่กําหนดเวลาไว้ คุณต้อง ดำเนินการตามแต่ละขั้นตอนต่อไปนี้ให้เสร็จสิ้น ก่อนที่แบ็กเอนด์ของคุณจะจับคู่ยานพาหนะกับ งาน

ตั้งค่า Listener

เนื่องจาก Driver SDK ดําเนินการในเบื้องหลัง ให้ใช้ DriverStatusListener เพื่อทริกเกอร์การแจ้งเตือนเมื่อเกิดเหตุการณ์บางอย่าง เช่น ข้อผิดพลาด คําเตือน หรือข้อความแก้ไขข้อบกพร่อง ข้อผิดพลาดอาจเกิดขึ้นชั่วคราว (เช่น BACKEND_CONNECTIVITY_ERROR) หรืออาจทําให้อัปเดตตําแหน่งหยุดลงอย่างถาวร เช่น หากได้รับข้อผิดพลาด VEHICLE_NOT_FOUND แสดงว่ามีข้อผิดพลาดในการกําหนดค่า

ตัวอย่างต่อไปนี้แสดงการใช้งาน 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());

เปิดใช้การอัปเดตตำแหน่ง

เมื่ออินสแตนซ์ *VehicleReporter พร้อมใช้งานแล้ว ให้เปิดใช้การอัปเดตตำแหน่งโดยทำดังนี้

Java

DeliveryVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

(ไม่บังคับ) กำหนดช่วงเวลาการอัปเดต

โดยค่าเริ่มต้น Driver SDK จะส่งการอัปเดตตำแหน่งทุกๆ 10 วินาที ชิ้น การอัปเดตตำแหน่งยังระบุว่ารถออนไลน์อยู่ คุณสามารถเปลี่ยนแปลง ช่วงเวลาร่วมกับ reporter.setLocationReportingInterval(long, TimeUnit) ค่าต่ำสุดที่รองรับ ช่วงเวลาการอัปเดตคือ 5 วินาที การอัปเดตบ่อยขึ้นอาจส่งผลให้คำขอช้าลงและเกิดข้อผิดพลาด