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: সেট-আপ
- যাচাইকরণ: JSON Web Token (JWT), API কী
- এছাড়াও চালু করুন: Fleet Engine পরিষেবা, Android-এর জন্য Maps SDK
- শুরু করা: Android-এর জন্য Consumer SDK সেট-আপ করা
- রেফারেন্স: Android-এর জন্য Consumer SDK রেফারেন্স
- নীতি: Android-এর জন্য Consumer SDK সংক্রান্ত নীতি
- রিলিজ নোট: Android-এর জন্য Consumer SDK-এর রিলিজ নোট
Android প্যাকেজের জন্য অফিসিয়াল Consumer SDK:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK for Android: সম্পর্কিত প্রোডাক্ট
- সাধারণত এগুলির সাথে ব্যবহার করা হয়: Fleet Engine পরিষেবা, Android-এর জন্য Driver SDK, Android-এর জন্য Maps SDK
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-এর সাহায্যে আপনি কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
- একটি কাস্টমাইজ করা যায় এমন, ইন্টার্যাক্টিভ ম্যাপ যোগ করুন যা Fleet Engine থেকে মোবাইল অ্যাপে ট্রিপের প্রোগ্রেস ট্র্যাক করে।
- ফ্লিট ইঞ্জিন থেকে ওয়েব পেজ বা মোবাইল অ্যাপের ম্যাপে ট্রিপ ট্র্যাক করে এমন রুট পলিলাইন যোগ করুন।
- Fleet Engine ট্রিপের জন্য ওয়েব পেজ বা মোবাইল অ্যাপে ম্যাপের কোনও রুটে ট্রিপের প্রগ্রেস আপডেট করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে রাস্তা, পলিলাইন ও পলিগনের স্টাইল পরিবর্তন করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের অগ্রগতি ট্র্যাক করে এমন ম্যাপে ম্যাপ ফিচার দেখান বা লুকান।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে আইকন ও টেক্সট লেবেলের স্টাইল পরিবর্তন করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রগ্রেস ট্র্যাক করে এমন ম্যাপে বিভিন্ন জুম লেভেলে বিভিন্ন ম্যাপ স্টাইল প্রয়োগ করুন।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে জায়গার ঘনত্ব পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে POI ডেনসিটি কন্ট্রোল হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে বিল্ডিংয়ের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে 3D এবং ফুটপ্রিন্ট বিল্ডিং স্টাইল কাস্টমাইজেশন হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ফ্লিট ইঞ্জিন থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে এমন ম্যাপে ল্যান্ডমার্কের স্টাইল পরিবর্তন করুন। এক্সপেরিমেন্টাল মনে রাখবেন: কনজিউমার SDK-তে ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং সংক্রান্ত সহায়তা হল GA, যেখানে ল্যান্ডমার্ক আইকন কাস্টমাইজেশন হল একটি এক্সপেরিমেন্টাল ক্লাউড-ভিত্তিক ম্যাপ স্টাইলিং ফিচার (শুধুমাত্র লাইট ম্যাপ স্টাইলে কাজ করে)।
- ম্যাপে এমন একটি মার্কার কাস্টমাইজ করুন যা Fleet Engine থেকে ট্রিপের প্রোগ্রেস ট্র্যাক করে।
- ম্যাপে রুট পলিলাইন কাস্টমাইজ করুন যা Fleet Engine থেকে ট্রিপের প্রগ্রেস ট্র্যাক করে।