Android-এর জন্য Consumer SDK-এর দ্রুত রেফারেন্স

Android-এর জন্য Consumer SDK হল অন-ডিমান্ড ট্রিপের জন্য Fleet Engine-এর অংশ। এটি এমন ইন্টারফেস প্রদান করে যা ট্রিপ ডেটা মডেল করে এবং Fleet Engine-এ ট্রিপ ফলো করে এবং ক্লাস প্রদান করে যা ম্যাপ-ভিত্তিক ডিসপ্লে তৈরি করে যা Android অ্যাপে গ্রাহকদের সাথে ট্রিপের প্রোগ্রেস (গাড়ির লোকেশন, রুট, ETA, বাকি দূরত্ব, ট্রাফিক) শেয়ার করে।

Android-এর জন্য Consumer SDK: গুরুত্বপূর্ণ তথ্য

  • প্রোডাক্ট: Android-এর জন্য Consumer SDK
  • এছাড়াও এই নামে পরিচিত: Android Consumer SDK, Consumer SDK, Mobility Services On-demand Trips Android Consumer SDK
  • বিভাগ: রুট
  • প্ল্যাটফর্ম: Android
  • এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • এক নজরে: Android-এর জন্য Consumer SDK এক নজরে

Android-এর জন্য Consumer SDK: কখন ব্যবহার করবেন

Android-এর জন্য Consumer SDK ব্যবহার করুন যখন:

  • আপনার Android অ্যাপে গ্রাহকদের অন-ডিমান্ড ট্রিপ (রাইড, অর্ডার বা ডেলিভারি) ফলো করতে হবে যা আপনার ব্যাকএন্ড Fleet Engine-এ ট্র্যাক করে।
  • আপনাকে Android কনজিউমার অ্যাপে ম্যাপে কোনও গাড়ির প্রায় রিয়েল-টাইম, রোড-স্ন্যাপ করা লোকেশন ও রুট দেখাতে হবে।
  • Android-এ Fleet Engine ট্রিপের জন্য আপনাকে পিক-আপ ও ড্রপ-অফের ETA, বাকি দূরত্ব ও লাইভ ট্রাফিক দেখাতে হবে।
  • Android-এ জার্নি-শেয়ারিং ম্যাপের জন্য আপনাকে ট্রিপ মার্কার, রুট পলিলাইন বা ম্যাপ স্টাইলিং কাস্টমাইজ করতে হবে।

Android-এর জন্য Consumer SDK ব্যবহার করবেন না যখন:

  • iOS অ্যাপে অন-ডিমান্ড ট্রিপের জন্য আপনাকে জার্নি শেয়ার করতে হবে। এর পরিবর্তে iOS-এর জন্য Consumer SDK ব্যবহার করুন।
  • আপনার কোনও ওয়েব পেজে জার্নি শেয়ারিং বা শিপমেন্টের মতো শিডিউল করা টাস্কের গ্রাহক ট্র্যাকিং প্রয়োজন। পরিবর্তে JavaScript Consumer SDK ব্যবহার করুন।
  • আপনাকে ড্রাইভারের Android অ্যাপ থেকে ড্রাইভারের লোকেশন এবং ট্রিপের প্রগ্রেস রিপোর্ট করতে হবে। এর পরিবর্তে Android-এর জন্য Driver SDK ব্যবহার করুন।

Android-এর জন্য Consumer SDK: সেট-আপ

Android প্যাকেজের জন্য অফিসিয়াল Consumer SDK:

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

Android-এর জন্য Consumer SDK: সাধারণ ভুল

  • সমস্যা: Maps SDK ডিপেন্ডেন্সি কোনও নির্দিষ্ট ভার্সনে সেট করা না থাকলে, Consumer SDK ন্যূনতম প্রয়োজনীয় Maps SDK ভার্সন ব্যবহার করে, যার ফলে Maps SDK-এর পরবর্তী ভার্সনের ফিচারের উপর নির্ভর করে এমন অ্যাপ কাজ করা বন্ধ করে দিতে পারে। সমাধান: Gradle বা Maven-এ transportation-consumer-এর পাশাপাশি স্পষ্টভাবে উল্লেখ করা play-services-maps ভার্সন ঘোষণা করুন। /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project দেখুন।
  • সমস্যা: ট্রিপ শেষ হওয়ার পরে জার্নি শেয়ারিং বন্ধ না করলে, Fleet Engine-এ অপ্রয়োজনীয় নেটওয়ার্ক রিকোয়েস্ট পাঠানো হয় এবং মেমরি লিক হয়। সমাধান: ট্রিপের আর প্রয়োজন না থাকলে JourneySharingSession.stop() কল করুন, যেমন onDestroy()-এ অথবা ট্রিপ COMPLETE হলে। /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey দেখুন।
  • সমস্যা: ConsumerApi.initialize()-এ API ইনস্ট্যান্স আগে থেকেই থাকলে (2.0.0 এবং পরবর্তী ভার্সন) ব্যতিক্রম দেখায়। সমাধান: প্রথমে ConsumerApi.getInstance() কল করুন এবং কোনও ইনস্ট্যান্স আগে থেকেই আছে কিনা তা নির্ধারণ করতে, ফেরত আসা Task চেক করুন। /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android দেখুন।
  • সমস্যা: Consumer SDK v3 এবং তার আগের ভার্সনে সম্পূর্ণ R8 মোড কাজ করে না; AGP 8.0+ টার্গেট করা অ্যাপে বিল্ড বা রানটাইম সংক্রান্ত সমস্যা হতে পারে। সমাধান: AGP 8.0+ টার্গেট করার সময় android.enableR8.fullMode=false সেট করুন এবং Consumer SDK 3.0+-এর জন্য Kotlin 2.0-এর সাথে AGP 7.3+ ব্যবহার করুন। /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3 দেখুন।

Android-এর জন্য Consumer SDK: পুরনো এবং বন্ধ হয়ে যাওয়া ফিচার

  • 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 SDK-এর সাথে শেয়ার করা হয়েছে)। লক্ষণ: কনজিউমার SDK প্রতিটি মার্কার বা পলিলাইন টাইপ অনুযায়ী নিজস্ব ডিফল্ট স্টাইল প্রয়োগ করে, MarkerOptions ডিফল্ট নয়। মাইগ্রেশন গাইড দেখুন।
  • ব্যক্তিগত রিপোজিটরি ডিস্ট্রিবিউশন চ্যানেল: বন্ধ করা হয়েছে। বিকল্প: Google Maven রিপোজিটরি (ভার্সন 2.1.0 এবং তার পরবর্তী)। মাইগ্রেশন গাইড দেখুন।

Android-এর জন্য Consumer SDK-এর সাহায্যে আপনি কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।