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

کیت توسعه نرم‌افزار مصرف‌کننده برای 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 استفاده نکنید:

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

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

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

کیت توسعه نرم‌افزار مصرف‌کننده برای 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 انجام دهید

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