Prepara il veicolo

Questa sezione mostra come preparare il veicolo per le attività pianificate. Devi completare ciascuno dei seguenti passaggi prima che il tuo backend possa associare un veicolo a un'attività.

Configurare l'ascoltatore

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 transitoria (ad esempio BACKEND_CONNECTIVITY_ERROR) o causare l'interruzione definitiva degli aggiornamenti della posizione. Ad esempio, se ricevi un messaggio di errore VEHICLE_NOT_FOUND, indica un errore di configurazione.

L'esempio seguente 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());

Attivare gli aggiornamenti della posizione

Dopo aver creato un'istanza *VehicleReporter, attiva gli aggiornamenti della posizione come segue:

Java

DeliveryVehicleReporter reporter = ...;

reporter.enableLocationTracking();

Kotlin

val reporter = ...

reporter.enableLocationTracking()

(Facoltativo) Imposta l'intervallo di aggiornamento

Per impostazione predefinita, l'SDK Driver invia aggiornamenti sulla posizione a intervalli di 10 secondi. Ogni aggiornamento della posizione indica anche che il veicolo è online. Puoi modificare questo intervallo con reporter.setLocationReportingInterval(long, TimeUnit). L'intervallo di aggiornamento minimo supportato è di 5 secondi. Aggiornamenti più frequenti possono comportare richieste più lente e errori.