Prepara il veicolo

Questa sezione mostra come preparare il veicolo per i percorsi. Devi completare ciascuno dei seguenti passaggi prima che il tuo backend possa abbinare un veicolo a una corsa.

Configura il listener

Poiché l'SDK Driver esegue azioni in background, utilizza DriverStatusListener per attivare le notifiche quando si verificano determinati eventi, ad esempio errori, avvisi o messaggi di debug. Gli errori possono essere di natura temporanea (ad esempio BACKEND_CONNECTIVITY_ERROR) o possono causare l'interruzione permanente degli aggiornamenti della posizione. Ad esempio, se ricevi un errore VEHICLE_NOT_FOUND, significa che si è verificato un errore di configurazione.

Il seguente esempio mostra un'implementazione di 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());

Attiva gli aggiornamenti della posizione

Dopo aver configurato il listener, attiva gli aggiornamenti della posizione nel seguente modo:

RidesharingVehicleReporter reporter = ...;

reporter.enableLocationTracking();

val reporter = ...

reporter.enableLocationTracking()

Imposta l'intervallo di aggiornamento

Per impostazione predefinita, l'SDK Driver invia aggiornamenti della posizione a intervalli di 10 secondi quando lo stato del veicolo è ONLINE. Puoi modificare questo intervallo con reporter.setLocationReportingInterval(long, TimeUnit). L'intervallo di aggiornamento minimo supportato è di 5 secondi. Aggiornamenti più frequenti potrebbero comportare richieste più lente ed errori.

Imposta lo stato del veicolo su online

Quando attivi gli aggiornamenti della posizione, puoi impostare lo stato del veicolo su ONLINE per renderlo disponibile per le query SearchVehicles in Fleet Engine. L'SDK Driver invia lo stato del veicolo aggiornato insieme agli aggiornamenti della posizione.

Puoi impostare lo stato del veicolo direttamente nell'SDK Driver o nel server Fleet Engine. Per saperne di più, consulta Aggiorna un veicolo.

I seguenti esempi mostrano come impostare lo stato del veicolo su online nell'SDK Driver:

RidesharingVehicleReporter reporter = ...;

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

val reporter = ...

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

StatusListener segnala anche eventuali errori che si verificano durante l'aggiornamento dello stato del veicolo.

Passaggi successivi

Imposta i dettagli della corsa