В этом разделе показано, как подготовить автомобиль к выполнению запланированных задач. Вам необходимо выполнить каждый из следующих шагов, прежде чем ваш сервер сможет сопоставить автомобиль с задачей.
Настроить прослушиватель
Поскольку 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
включите обновления местоположения следующим образом:
Ява
DeliveryVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Котлин
val reporter = ...
reporter.enableLocationTracking()
(Необязательно) Установите интервал обновления
По умолчанию Driver SDK отправляет обновления местоположения с интервалом в 10 секунд. Каждое обновление местоположения также указывает на то, что автомобиль находится в сети. Вы можете изменить этот интервал с помощью reporter.setLocationReportingInterval(long, TimeUnit)
. Минимальный поддерживаемый интервал обновления составляет 5 секунд. Более частые обновления могут привести к замедлению запросов и возникновению ошибок.