مرجع سریع کیت توسعه نرم‌افزار Driver برای Android

کیت توسعه نرم‌افزار راننده برای Android یک جعبه‌ابزار تلفن همراه برای برنامه‌های راننده است که مکان خودرو، مسیر، مسافت باقی‌مانده، و به‌روزرسانی‌های زمان تخمینی رسیدن را از کیت توسعه نرم‌افزار ناوبری به موتور ناوگان ارسال می‌کند. این برنامه هم از سفرهای درخواستی و هم از تکالیف زمان‌بندی‌شده پشتیبانی می‌کند.

کیت توسعه نرم‌افزار راننده برای Android: حقایق کلیدی

  • محصول: کیت توسعه نرم‌افزار Driver برای Android
  • با این نام‌ها نیز شناخته می‌شود: کیت توسعه نرم‌افزار راننده، کیت توسعه نرم‌افزار راننده برای سفرهای درخواستی، کیت توسعه نرم‌افزار راننده برای کارهای زمان‌بندی‌شده
  • دسته: مسیرها
  • پلاتفرم: Android
  • اجرا در: کارخواه (کد برنامه یا مرورگر)
  • مرحله راه‌اندازی: GA
  • چرخه حیات: فعال
  • نمای کلی: نمای کلی کیت توسعه نرم‌افزار راننده برای Android

کیت توسعه نرم‌افزار راننده برای Android: زمان استفاده از آن

در موارد زیر از «کیت توسعه نرم‌افزار راننده» برای Android استفاده کنید:

  • برای ارسال مکان هم‌زمان خودرو و به‌روزرسانی‌های مسیر به Fleet Engine، به برنامه راننده Android نیاز دارید.
  • برای دریافت فاصله باقی‌مانده و زمان تخمینی رسیدن به نقطه‌مسیر بعدی از Navigation SDK، به Fleet Engine نیاز دارید.
  • به یک برنامه راننده نیاز دارید که هم سفرهای درخواستی واگذارشده یا تکالیف زمان‌بندی‌شده را مدیریت کند و هم ناوبری ارائه دهد.

در موارد زیر از «کیت توسعه نرم‌افزار راننده» برای Android استفاده نکنید:

  • فقط به ناوبری گام‌به‌گام در برنامه‌تان نیاز دارید و از Fleet Engine استفاده نمی‌کنید. درعوض از کیت توسعه نرم‌افزار ناوبری برای Android استفاده کنید.
  • باید به‌روزرسانی‌های داده‌های خودرو را به‌غیراز مکان، مسیر، فاصله، و زمان تخمینی ورود ارسال کنید (این موارد ازطریق پس‌بخش شما ارسال می‌شوند). درعوض از سرویس Fleet Engine استفاده کنید.
  • برنامه راننده را برای iOS می‌سازید. درعوض از کیت توسعه نرم‌افزار Driver برای iOS استفاده کنید.

کیت توسعه نرم‌افزار راننده برای Android: راه‌اندازی

بسته‌های رسمی کیت توسعه نرم‌افزار Driver برای Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-driver
  • maven: com.google.android.libraries.navigation:navigation

کیت توسعه نرم‌افزار راننده برای Android: اشتباهات رایج

  • مشکل: اگر وابستگی‌های ساخت نسخه Driver SDK را مشخص نکنند، IDE جدیدترین نسخه را بار می‌کند؛ از نسخه ۷.۰.۰، ساخت‌های جدید دیگر از Android 6 و 7 (میانای برنامه‌سازی کاربردی ۲۳-۲۵) پشتیبانی نمی‌کنند. راه‌حل: نسخه Driver SDK for Android را به‌طور صریح در وابستگی‌های ساخت خود مشخص کنید تا بتوانید زمان تغییر حداقل سیستم‌عامل پشتیبانی‌شده را کنترل کنید. /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android را ببینید.
  • مشکل: Driver SDK به Navigation SDK وابسته است؛ بدون نسخه سنجاق‌شده Navigation SDK، پروژه همیشه جدیدترین Navigation SDK را در نسخه عمده بارگیری می‌کند. رفع مشکل: وابستگی‌های Driver SDK و Navigation SDK را اضافه کنید. اگر «کیت توسعه نرم‌افزار ناوبری» را سنجاق می‌کنید، نسخه‌ای را در محدوده فهرست‌شده در یادداشت‌های انتشار برای نسخه «کیت توسعه نرم‌افزار راننده» خود انتخاب کنید (برای مثال، [7.0, 8.0) برای «کیت توسعه نرم‌افزار راننده» نسخه 7.1). /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project را ببینید.
  • مشکل: کیت توسعه نرم‌افزار توکن‌های مجوز را ازطریق AuthTokenFactory در زمان به‌روزرسانی مکان درخواست می‌کند؛ اگر سرور شما نتواند توکن‌های وب JSON صادر کند، به‌روزرسانی‌های Fleet Engine نمی‌توانند مجوز دریافت کنند. راه‌حل: مطمئن شوید که پیاده‌سازی سمت سرور شما می‌تواند قبل‌از مقداردهی اولیه کیت توسعه نرم‌افزار، کد صادر کند و تا زمانی که کدها منقضی نشده‌اند، از آن‌ها مجدداً استفاده کند. /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate را ببینید.
  • مشکل: ساخت‌های ProGuard می‌تواند برای کلاس‌های com.google، io.grpc، و okio هشدار تولید کند. اصلاح: -dontwarn com.google.**، -dontwarn io.grpc.**، و -dontwarn okio.** را به پیکربندی ProGuard اضافه کنید. /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies را ببینید.

کیت توسعه نرم‌افزار راننده برای Android: ویژگی‌های قدیمی و منسوخ‌شده

  • StatusListener میانای: از کار افتاده از ۲۰۲۴-۱۱-۲۵. جایگزین: DriverStatusListener. نشانه: در Driver SDK برای Android نسخه ۶.۰.۰ برداشته شده است. راهنمای انتقال را ببینید.
  • کیت توسعه نرم‌افزار Nav/Driver برای Android نسخه ۱.x (باینری ترکیبی): از ۲۰۲۲/۰۶/۲۱ از رده خارج شده است. جایگزین: باینری‌های جداگانه Driver SDK v3+‎ و Navigation SDK. نشانه: از ۲۰۲۱/۰۶/۲۱ منسوخ شده است و پس‌از ۲۰۲۲/۰۶/۲۱ نگهداری نمی‌شود؛ روش‌هایی مانند Waypoint#fromLatLng و Navigator#startGuidance(resumeIntent) در نسخه ۳.۰ برداشته شده است. راهنمای انتقال را ببینید.
  • AuthTokenContext ServiceType: از کار افتاده از ۲۰۲۱-۱۱-۲۹. جایگزینی: ادعاهای مربوط به شناسه خودرو و شناسه تکلیف موجود. نشانه: در نسخه ۴.۰.۰ برداشته شد: ServiceType و getServiceType() از AuthTokenContext، و setServiceType از AuthTokenContext.Builder. راهنمای انتقال را ببینید.
  • خصوصیت Task parentId: منسوخ‌شده از ۲۰۲۲/۰۴/۲۸. جایگزین: trackingId. نشانه: در نسخه ۴.۱.۰ تغییر نام داده است؛ خصوصیت قدیمی هنوز وجود دارد اما منسوخ شده است.

کارهایی که می‌توانید با «کیت توسعه نرم‌افزار راننده» برای Android انجام دهید

برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیت‌ها با یکدیگر مقایسه کنید.