کیت توسعه نرمافزار راننده برای 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: راهاندازی
- اصالتسنجی: کلید میانای برنامهسازی کاربردی، JSON Web Token (JWT)
- این مورد را هم فعال کنید: کیت توسعه نرمافزار Google Maps برای Android
- شروع به کار: راهاندازی Driver SDK برای Android
- مرجع: مرجع کیت توسعه نرمافزار Driver برای Android
- خطمشیها: خطمشیهای کیت توسعه نرمافزار راننده برای Android
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار Driver برای Android
بستههای رسمی کیت توسعه نرمافزار Driver برای Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
کیت توسعه نرمافزار راننده برای Android: محصولات مرتبط
- اغلب با این موارد استفاده میشود: کیت توسعه نرمافزار پیمایش برای Android، سرویس Fleet Engine
کیت توسعه نرمافزار راننده برای 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)در نسخه ۳.۰ برداشته شده است. راهنمای انتقال را ببینید. AuthTokenContextServiceType: از کار افتاده از ۲۰۲۱-۱۱-۲۹. جایگزینی: ادعاهای مربوط به شناسه خودرو و شناسه تکلیف موجود. نشانه: در نسخه ۴.۰.۰ برداشته شد:ServiceTypeوgetServiceType()ازAuthTokenContext، وsetServiceTypeازAuthTokenContext.Builder. راهنمای انتقال را ببینید.- خصوصیت
TaskparentId: منسوخشده از ۲۰۲۲/۰۴/۲۸. جایگزین:trackingId. نشانه: در نسخه ۴.۱.۰ تغییر نام داده است؛ خصوصیت قدیمی هنوز وجود دارد اما منسوخ شده است.
کارهایی که میتوانید با «کیت توسعه نرمافزار راننده» برای Android انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- موقعیت همزمان خودرو را به سرویس Fleet Engine گزارش کنید.
- مختصات طول/عرض جغرافیایی نقاطمسیر سفر خودرو را از Navigation SDK به سرویس Fleet Engine گزارش کنید.
- فاصله باقیمانده خودرو تا نقطهمسیر بعدی را به سرویس Fleet Engine گزارش کنید.
- زمان برآوردی ورود خودرو به نقطهمسیر بعدی را به سرویس Fleet Engine گزارش کنید.
- مسیر ارائهشده برای خودرو توسط Navigation SDK را به سرویس Fleet Engine گزارش دهید.