車両の準備

このセクションでは、スケジュールされたタスクの準備を車両で行う方法について説明します。バックエンドで車両をタスクに照合するには、次の各手順を完了する必要があります。

リスナーを設定する

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 秒です。更新頻度が高いと、リクエストの遅延やエラーが発生する可能性があります。