請上車

本節說明如何準備車輛，以便接單。後端必須完成下列每個步驟，才能將車輛與行程配對。

設定接聽程式

由於 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());

啟用位置資訊更新

設定監聽器後，請按照下列步驟啟用位置資訊更新：

Java

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

注意： 撥打電話 reporter.enableLocationTracking() 不會自動將車輛狀態設為 ONLINE。您必須明確設定車輛狀態。詳情請參閱「將車輛狀態設為上線」。

設定更新間隔

根據預設，當車輛狀態為 ONLINE 時，Driver SDK 會以 10 秒間隔傳送位置更新。如要變更間隔，請使用 reporter.setLocationReportingInterval(long, TimeUnit)。支援的更新間隔最短為 5 秒。更頻繁的更新可能會導致要求速度變慢和發生錯誤。

將車輛狀態設為「線上」

開啟位置資訊更新功能後，您可以將車輛狀態設為 ONLINE，讓車輛可供 Fleet Engine 進行 SearchVehicles 查詢。Driver SDK 會傳送更新後的車輛狀態和位置資訊更新。

您可以直接在 Driver SDK 或 Fleet Engine 伺服器中設定車輛狀態。詳情請參閱「更新車輛」。

下列範例說明如何在 Driver SDK 中將車輛狀態設為「上線」：

Java

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);

Kotlin

val reporter = ...

reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)

注意： 你必須先開啟位置資訊更新，才能將車輛設為上線。如果嘗試在關閉位置資訊更新功能時執行這項操作，系統會顯示 IllegalStateException 錯誤訊息。

StatusListener 也會回報更新車輛狀態時發生的任何錯誤。

後續步驟

設定行程詳細資料