В этом разделе показано, как подготовить автомобиль к поездкам. Вам необходимо выполнить каждый из следующих шагов, прежде чем ваш сервер сможет сопоставить транспортное средство с поездкой.
Настройка прослушивателя
Поскольку 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());
Включить обновление местоположений
После настройки прослушивателя включите обновления местоположений следующим образом:
Джава
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
Котлин
val reporter = ...
reporter.enableLocationTracking()
Установите интервал обновления
По умолчанию Driver SDK отправляет обновления местоположения с интервалом в 10 секунд, когда транспортное средство находится в режиме ONLINE . Вы можете изменить этот интервал с помощью reporter.setLocationReportingInterval(long, TimeUnit) . Минимальный поддерживаемый интервал обновления составляет 5 секунд. Более частые обновления могут привести к замедлению запросов и ошибкам.
Установить состояние автомобиля в онлайн-режиме
Когда вы включаете обновление местоположения, вы можете установить состояние транспортного средства в ONLINE , чтобы сделать транспортное средство доступным для запросов SearchVehicles в Fleet Engine. Driver SDK отправляет обновленное состояние автомобиля вместе с обновлениями местоположения.
Вы можете установить состояние автомобиля непосредственно в Driver SDK или на сервере Fleet Engine. Дополнительную информацию см. в разделе «Обновление автомобиля» .
В следующих примерах показано, как установить онлайн-состояние автомобиля в Driver SDK:
Джава
RidesharingVehicleReporter reporter = ...;
reporter.enableLocationTracking();
reporter.setVehicleState(VehicleState.ONLINE);
Котлин
val reporter = ...
reporter.enableLocationTracking()
reporter.setVehicleState(VehicleState.ONLINE)
StatusListener также сообщает обо всех ошибках, возникающих при обновлении состояния автомобиля.