وسیله نقلیه را آماده کنید

این بخش نحوه آماده‌سازی وسیله نقلیه برای سفرها را نشان می‌دهد. قبل از اینکه بخش پشتیبانی شما بتواند وسیله نقلیه را با سفر مطابقت دهد، باید هر یک از مراحل زیر را انجام دهید.

شنونده را تنظیم کنید

از آنجایی که درایور 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()

تنظیم فاصله زمانی به‌روزرسانی

به طور پیش‌فرض، درایور SDK به‌روزرسانی‌های موقعیت مکانی را در فواصل ۱۰ ثانیه‌ای، زمانی که وضعیت خودرو ONLINE است، ارسال می‌کند. می‌توانید این فاصله را با reporter.setLocationReportingInterval(long, TimeUnit) تغییر دهید. حداقل فاصله به‌روزرسانی پشتیبانی‌شده ۵ ثانیه است. به‌روزرسانی‌های مکرر ممکن است منجر به درخواست‌های کندتر و خطا شوند.

وضعیت خودرو را روی حالت آنلاین تنظیم کنید

وقتی به‌روزرسانی‌های موقعیت مکانی را فعال می‌کنید، می‌توانید وضعیت خودرو را روی ONLINE تنظیم کنید تا خودرو برای جستجوهای SearchVehicles در Fleet Engine در دسترس باشد. Driver SDK وضعیت به‌روز شده خودرو را همراه با به‌روزرسانی‌های موقعیت مکانی ارسال می‌کند.

شما می‌توانید وضعیت خودرو را مستقیماً در Driver SDK یا در سرور Fleet Engine تنظیم کنید. برای اطلاعات بیشتر، به Update a Vehicle مراجعه کنید.

مثال‌های زیر نحوه تنظیم وضعیت خودرو به صورت آنلاین در Driver SDK را نشان می‌دهند:

RidesharingVehicleReporter reporter = ...;

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

val reporter = ...

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

StatusListener همچنین هرگونه خطایی را که هنگام به‌روزرسانی وضعیت وسیله نقلیه رخ می‌دهد، گزارش می‌دهد.

قدم بعدی چیست؟

جزئیات سفر را تنظیم کنید