کیت توسعه نرمافزار مصرفکننده برای Android بخشی از Fleet Engine برای سفرهای درخواستی است. این SDK میاناهایی ارائه میدهد که دادههای سفر را مدلسازی میکنند و سفرها را در Fleet Engine دنبال میکنند، و کلاسهایی برای ساختن نمایشگر مبتنی بر نقشه که پیشرفت سفر (مکان خودرو، مسیر، زمان تخمینی رسیدن، مسافت باقیمانده، ترافیک) را با مصرفکنندگان در برنامه Android همرسانی میکند.
کیت توسعه نرمافزار مصرفکننده برای Android: حقایق کلیدی
- محصول: کیت توسعه نرمافزار مصرفکننده برای Android
- با این نامها نیز شناخته میشود: کیت توسعه نرمافزار مصرفکننده Android، کیت توسعه نرمافزار مصرفکننده، کیت توسعه نرمافزار مصرفکننده Android برای سفرهای درخواستی خدمات جابهجایی
- دسته: مسیرها
- پلاتفرم: Android
- اجرا در: کارخواه (کد برنامه یا مرورگر)
- مرحله راهاندازی: GA
- چرخه حیات: فعال
- نمای کلی: نمای کلی کیت توسعه نرمافزار مصرفکننده برای Android
کیت توسعه نرمافزار مصرفکننده برای Android: زمان استفاده از آن
در موارد زیر از «کیت توسعه نرمافزار مصرفکننده» برای Android استفاده کنید:
- شما به مصرفکنندگان در برنامه Android خود نیاز دارید تا یک سفر درخواستی (سواری، سفارش، یا تحویل) را که باطن شما در Fleet Engine ردیابی میکند، دنبال کنند.
- باید مکان و مسیر خودرو را تقریباً همزمان و منطبق با جاده روی نقشه در برنامه مصرفکننده Android نشان دهید.
- باید زمان تخمینی رسیدن برای سوار کردن و پیاده کردن، فاصله باقیمانده، و ترافیک زنده را برای سفر Fleet Engine در Android نشان دهید.
- باید نشانگرهای سفر، چندخطیهای مسیر، یا سبک نقشه را برای نقشه همرسانی سفر در Android سفارشیسازی کنید.
در موارد زیر از «کیت توسعه نرمافزار مصرفکننده» برای Android استفاده نکنید:
- برای سفرهای درخواستی در برنامه iOS به همرسانی سفر نیاز دارید. درعوض از کیت توسعه نرمافزار مصرفکننده برای iOS استفاده کنید.
- به همرسانی مسیر در صفحه وب یا ردگیری مصرفکننده برای کارهای زمانبندیشده مثل محمولهها نیاز دارید. درعوض از کیت توسعه نرمافزار مصرفکننده جاوا اسکریپت استفاده کنید.
- باید مکان راننده و پیشرفت سفر را از برنامه Android راننده گزارش کنید. بهجای آن، از کیت توسعه نرمافزار راننده برای Android استفاده کنید.
کیت توسعه نرمافزار مصرفکننده برای Android: راهاندازی
- اصالتسنجی: JSON Web Token (JWT)، کلید میانای برنامهسازی کاربردی
- این موارد را نیز فعال کنید: سرویس Fleet Engine، کیت توسعه نرمافزار Google Maps برای Android
- شروع به کار: راهاندازی Consumer SDK برای Android
- مرجع: مرجع کیت توسعه نرمافزار مصرفکننده برای Android
- خطمشیها: خطمشیهای کیت توسعه نرمافزار مصرفکننده برای Android
- یادداشتهای انتشار: یادداشتهای انتشار کیت توسعه نرمافزار مصرفکننده برای Android
بستههای رسمی کیت توسعه نرمافزار مصرفکننده برای Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
کیت توسعه نرمافزار مصرفکننده برای Android: محصولات مرتبط
- اغلب با این موارد استفاده میشود: سرویس Fleet Engine، کیت توسعه نرمافزار Driver برای Android، کیت توسعه نرمافزار Maps برای Android
کیت توسعه نرمافزار مصرفکننده برای Android: اشتباهات رایج
- مشکل: اگر وابستگی Maps SDK روی نسخه صریحی تنظیم نشده باشد، Consumer SDK از حداقل نسخه Maps SDK موردنیاز استفاده میکند که میتواند برنامههایی را که به ویژگیهای نسخههای جدیدتر Maps SDK متکی هستند خراب کند. اصلاح: نسخه
play-services-mapsرا بهطور صریح درکنارtransportation-consumerدر Gradle یا Maven اعلام کنید. /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project را ببینید. - مشکل: اگر همرسانی مسیر پساز پایان سفر متوقف نشود، درخواستهای شبکه غیرضروری به Fleet Engine ارسال میشود و نشت حافظه رخ میدهد. اصلاح: وقتی دیگر به سفر نیازی نیست، مثلاً در
onDestroy()یا وقتی سفرCOMPLETEاست،JourneySharingSession.stop()را فراخوانی کنید. /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey را ببینید. - مشکل:
ConsumerApi.initialize()اگر نمونه میانای برنامهسازی کاربردی ازقبل وجود داشته باشد، استثنایی را ایجاد میکند (نسخه ۲.۰.۰ و بالاتر). اصلاح: ابتداConsumerApi.getInstance()را فراخوانی کنید وTaskبرگرداندهشده را بررسی کنید تا مشخص شود آیا نمونهای ازقبل وجود دارد یا نه. /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android را ببینید. - مشکل: Consumer SDK نسخه ۳ و پایینتر از حالت Full R8 پشتیبانی نمیکند؛ برنامههایی که AGP 8.0+ را هدف قرار میدهند ممکن است با مشکلات ساخت یا زمان اجرا مواجه شوند. اصلاح: هنگام هدفیابی AGP نسخه ۸.۰ و بالاتر،
android.enableR8.fullMode=falseرا تنظیم کنید و از AGP نسخه ۷.۳ و بالاتر با Kotlin نسخه ۲.۰ برای Consumer SDK نسخه ۳.۰ و بالاتر استفاده کنید. /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3 را ببینید.
کیت توسعه نرمافزار مصرفکننده برای Android: ویژگیهای قدیمی و منسوخشده
ConsumerTrip،ConsumerTripCallback،ConsumerTripManager،ConsumerTripOptions: از ۲۰۲۳/۰۹/۱۵ از رده خارج شده است. جایگزین:TripModel،TripModelCallback،TripModelManager،TripModelOptions. راهنمای انتقال را ببینید.- کلاس
Tripو حاشیهنویسیهایTrip.TripStatus/Trip.TripType(وTripInfo#getTripStatus()،TripInfo#getTripType()،TripModelCallback#onTripStatusUpdated): از ۲۰۲۳/۰۹/۱۵ منسوخ شده است. جایگزین:TripInfo.TripStatus/TripInfo.TripType،TripInfo#getCurrentTripStatus()،TripInfo#getCurrentTripType()،TripModelCallback#onTripStatusUpdate. راهنمای انتقال را ببینید. MarkerStyleOptionsوPolylineStyleOptions: از ۲۰۲۱/۱۱/۳۰ از رده خارج شده است. جایگزین:MarkerOptionsوPolylineOptions(همرسانیشده با کیت توسعه نرمافزار Maps). نشانه: «کیت توسعه نرمافزار مصرفکننده» سبک پیشفرض خودش را برای هر نوع نشانگر یا چندخطی اعمال میکند، نه پیشفرضهایMarkerOptions. راهنمای انتقال را ببینید.- کانال توزیع مخزن خصوصی: منسوخشده. جایگزین: مخزن Google Maven (نسخه ۲.۱.۰ و بالاتر). راهنمای انتقال را ببینید.
کارهایی که میتوانید با «کیت توسعه نرمافزار مصرفکننده» برای Android انجام دهید
برای هر تکلیف، راهنماهای پیوندشده در زیر را ببینید یا محصولات را در کاوشگر قابلیتها با یکدیگر مقایسه کنید.
- نقشه تعاملی و قابلسفارشیسازی اضافه کنید که پیشرفت سفر را از Fleet Engine به برنامه تلفن همراه ردیابی میکند.
- چندخطی مسیری را که سفر را از Fleet Engine به نقشهای در صفحه وب یا برنامه تلفن همراه ردیابی میکند اضافه کنید.
- پیشرفت سفر را درطول مسیر در نقشهای در صفحه وب یا برنامه تلفن همراه برای سفر Fleet Engine بهروز کنید.
- سبک جادهها، چندخطیها، و چندضلعیها را در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند تغییر دهید.
- نمایش یا پنهان کردن ویژگیهای نقشه در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر سبک نمادها و برچسبهای نوشتاری در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- اعمال سبکهای مختلف نقشه در سطوح بزرگنمایی مختلف روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- تغییر دادن تراکم مکانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در Consumer SDK بهصورت GA است، درحالیکه کنترل تراکم نقطه موردعلاقه یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک ساختمانها در نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی سبک ساختمان سهبعدی و ردپا یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- تغییر سبک نشانهای روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند. آزمایشی توجه: پشتیبانی از «سبکپردازی نقشه بااستفاده از فضای ابری» در «کیت توسعه نرمافزار مصرفکننده» بهصورت GA است، درحالیکه سفارشیسازی نماد نشان اختصاصی یک ویژگی آزمایشی «سبکپردازی نقشه بااستفاده از فضای ابری» است (فقط در سبکهای نقشه روشن پشتیبانی میشود).
- سفارشیسازی نشانگر روی نقشه که پیشرفت سفر را از Fleet Engine ردیابی میکند.
- سفارشیسازی چندخطی مسیر روی نقشهای که پیشرفت سفر را از Fleet Engine ردیابی میکند.