Consumer SDK অন-ডিমান্ড ট্রিপের ওভারভিউ

আপনার প্রদান করা অর্ডার, রাইড বা অন্যান্য পরিষেবার জন্য ট্রিপ ফলো করার অনুমতি দিয়ে গ্রাহকদের অন-ডিমান্ড ট্রিপের অভিজ্ঞতা কাস্টমাইজ করুন।

গ্রাহক SDK কী?

Consumer SDK হল অন-ডিমান্ড ট্রিপের জন্য Fleet Engine-এর একটি অংশ। এটি এমন ইন্টারফেস প্রদান করে যা ট্রিপ ডেটা মডেল করে এবং Fleet Engine-এ ট্রিপ ফলো করে এবং এটি এমন ক্লাস প্রদান করে যা আপনি আপনার গ্রাহক ব্যবহারকারীদের সাথে যাত্রা শেয়ার করার জন্য একটি সমৃদ্ধ, মানচিত্র-ভিত্তিক ডিসপ্লে তৈরি করতে ব্যবহার করেন। আপনি নিজের অ্যাপে Consumer SDK ইন্টিগ্রেট করেন এবং এই গ্রাহক অভিজ্ঞতা তৈরি করতে Fleet Engine-এর মধ্যে উপযুক্ত ভূমিকা প্রোফাইল সেট করেন।

Consumer SDK প্ল্যাটফর্ম-নির্দিষ্ট API আপনাকে আপনার অ্যাপ্লিকেশনে নেটিভভাবে যাত্রা শেয়ার করার ক্ষমতা তৈরি করতে দেয়। Consumer SDK নিম্নলিখিত প্ল্যাটফর্মের জন্য উপলভ্য:

• Android
• iOS
• JavaScript

Consumer SDK কেন ব্যবহার করবেন?

আপনার অন-ডিমান্ড ট্রিপ অ্যাপ্লিকেশনে Consumer SDK ইন্টিগ্রেট করলে, আপনি গ্রাহকদের প্রায় রিয়েল-টাইম লোকেশন আপডেট ও রোড-স্ন্যাপড পজিশন সহ একটি সামগ্রিক অভিজ্ঞতা প্রদান করতে পারবেন। আপনার গ্রাহকরা ম্যাপের উপরে ওভারলে করা গাড়ির রুট দেখতে পাবেন, যার মধ্যে প্রগ্রেসের বিবরণও অন্তর্ভুক্ত থাকে, যা তাদের বুঝতে সাহায্য করে যে তাদের রাইড বা ডেলিভারি কোথায় আছে।

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

আপনি Driver SDK এবং Fleet Engine থেকে তথ্য ব্যবহার করে নিম্নলিখিত ফিচার সহ কাস্টমাইজ করা গ্রাহক অভিজ্ঞতা তৈরি করতে পারবেন:

• আপনার ব্র্যান্ডিংয়ের প্রয়োজন অনুযায়ী ম্যাপ UI কাস্টমাইজ করুন।

• গাড়িটি রুট ধরে এগিয়ে যাওয়ার সাথে সাথে তার বর্তমান লোকেশন ফলো করুন, গাড়ির পজিশন নির্দিষ্ট সময় অন্তর আপডেট করা হয়।

• পিক-আপ ও ড্রপ-অফ লোকেশনে পৌঁছানোর আনুমানিক সময় (ETA) দেখানো।

• বাকি দূরত্ব দেখান।

• রুটে লাইভ ট্রাফিক দেখুন।

Consumer SDK কীভাবে কাজ করে

উচ্চ স্তরে, কনজিউমার SDK নিম্নলিখিত মেকানিজমের উপর নির্ভর করে:

• উপযুক্ত Fleet Engine ভূমিকা থাকা যাতে যাচাই করা অ্যাপ গ্রাহকের অর্ডারের সাথে যুক্ত ট্রিপ ফলো করতে পারে।
• আপনার ব্যাকএন্ড সিস্টেমের মাধ্যমে প্রদান করা গ্রাহক ও ট্রিপের মধ্যে সম্পর্ক।
• TripModel এবং JourneySharingSession SDK ক্লাস যা ট্রিপ ডেটা মডেল করে এবং গ্রাহক অ্যাপে ট্রিপ সেশন শেয়ার করে।

এছাড়াও, Consumer SDK অন্যান্য ইন্টারফেস ও ক্লাস প্রদান করে যাতে আপনি ট্রাফিক, ম্যাপ মার্কার, ETA ও রুট ডেটার মতো বিবরণ সহ একটি সমৃদ্ধ অ্যাপ অভিজ্ঞতা তৈরি করতে পারেন।

এই সারণীতে গ্রাহক অ্যাপের মাধ্যমে ট্রিপের ফ্লো দেখানো হয়েছে।

১	গ্রাহক অ্যাপ ট্রিপের অনুরোধ করে	আপনার ব্যাকএন্ড সার্ভার অন-ডিমান্ড ট্রিপের অনুরোধ পায় এবং নিম্নলিখিত কাজগুলি করে: Fleet Engine-এ ট্রিপ তৈরি করে। কোনও গাড়ির জন্য ট্রিপ অ্যাসাইন করে।
২	ড্রাইভার ট্রিপ গ্রহণ করেন	ড্রাইভার অ্যাপ ট্রিপ আইডি ও ট্রিপ সম্পর্কিত তথ্য পায় এবং ড্রাইভার ট্রিপ গ্রহণ করে।
৩	ট্রিপ ফলো করার জন্য কনজিউমার অ্যাপ অ্যাক্সেসের অনুরোধ করে	কনজিউমার অ্যাপ আপনার ব্যাকএন্ড থেকে ট্রিপ আইডি পায় এবং ট্রিপ ফলো করা শুরু করার জন্য অনুরোধ করে।
৪	ড্রাইভার ট্রিপ শুরু করেন	ট্রিপ শুরু হয়েছে তা বোঝাতে ড্রাইভার যখন ড্রাইভার অ্যাপ ব্যবহার করেন, তখন অ্যাপটি Driver SDK-এর মাধ্যমে আপনার ব্যাকএন্ড সার্ভারকে বিজ্ঞপ্তি পাঠায়। যেমন, ড্রাইভার যখন রেস্তোরাঁ থেকে বের হতে চলেছেন বা পিক-আপ লোকেশনের দিকে গাড়ি চালাচ্ছেন।
৫	Fleet Engine ট্রিপ সংক্রান্ত তথ্য পাঠানো শুরু করে	Fleet Engine ট্রিপ ট্র্যাক করা শুরু করে এবং গ্রাহক অ্যাপের সাথে এর প্রগ্রেস শেয়ার করে।
৬	গ্রাহক অ্যাপ ট্রিপের তথ্য দেখায়	গ্রাহক অ্যাপ গ্রাহককে বিজ্ঞপ্তি পাঠায় এবং তাকে ট্রিপের তথ্য দেখাতে শুরু করে, ট্রিপের অগ্রগতি অনুযায়ী ট্রিপ আপডেট করে।
৭	ট্রিপ বাতিল বা সম্পূর্ণ হয়ে গেছে	ড্রাইভার ট্রিপ বাতিল বা সম্পূর্ণ করলে, ড্রাইভার অ্যাপ লোকেশন ট্র্যাকিং বন্ধ করে দেয় এবং আপনার ব্যাকএন্ড সার্ভার Fleet Engine-কে ট্রিপটি বাতিল বা সম্পূর্ণ হিসেবে চিহ্নিত করতে বলে।
৮	গ্রাহক অ্যাপ ট্রিপ ফলো করা বন্ধ করে দেয়	ট্রিপটি বাতিল বা সম্পূর্ণ হয়েছে হিসেবে দেখানো হয়েছে।
9	পরবর্তী ট্রিপের জন্য এই প্রসেস আবার করা হয়	একটি নতুন ট্রিপ তৈরি করা হয় এবং প্রসেসটি আবার শুরু হয়।

Consumer SDK কীভাবে ব্যবহার করবেন

আপনার গ্রাহক অ্যাপে কীভাবে ট্রিপ ফলো করা শুরু করবেন তা দেখতে আপনার প্ল্যাটফর্ম বেছে নিন।

উপাদানগুলি

এই বিভাগে ট্রিপ ফলো করার জন্য দুটি প্রয়োজনীয় কম্পোনেন্টের সারসংক্ষেপ দেওয়া হয়েছে:

• যাচাইকরণ টোকেন ফেচার।
• ম্যাপ ভিউ ও ট্রিপ ট্র্যাকার।

এছাড়াও, আপনি এইসব কম্পোনেন্টের মাধ্যমে আপনার গ্রাহকের অভিজ্ঞতা কাস্টমাইজ করতে পারবেন:

• আপনার ম্যাপ স্টাইল করুন।
• ট্র্যাক করা লোকেশনের দৃশ্যমানতা নিয়ন্ত্রণ করুন।

যাচাইকরণ টোকেন ফেচার

Fleet Engine-এ স্টোর করা লোকেশন ডেটার অ্যাক্সেস নিয়ন্ত্রণ করতে, আপনাকে নিম্নলিখিত কাজগুলি করতে হবে:

1. আপনার সার্ভারে Fleet Engine-এর জন্য JSON ওয়েব টোকেন (JWT) তৈরি করার পরিষেবা প্রয়োগ করুন। আরও তথ্যের জন্য, JWT ইস্যু করা দেখুন।

2. লোকেশন ডেটা অ্যাক্সেস যাচাই করতে আপনার ওয়েব বা মোবাইল অ্যাপে একটি যাচাইকরণ টোকেন ফেচার বাস্তবায়ন করুন। টোকেন ফেচার সেট-আপ করার ব্যাপারে আরও তথ্যের জন্য, Android, iOS অথবা JavaScript-এর জন্য সেট-আপ গাইড দেখুন।

ম্যাপ ভিউ ও ট্রিপ ট্র্যাকার

ট্রিপ ফলো করার মধ্যে গাড়ি ও ওয়েপয়েন্ট ভিজ্যুয়ালাইজ করার কম্পোনেন্ট এবং ড্রাইভারের ETA বা গন্তব্যে পৌঁছাতে আর কতটা দূরত্ব বাকি আছে সেই সংক্রান্ত র ডেটা ফিড অন্তর্ভুক্ত থাকে।

নিচের সারণীতে এইসব কম্পোনেন্টের বিবরণ দেওয়া হয়েছে:

কম্পোনেন্ট	বিবরণ
গ্রাহকের ম্যাপ ভিউ	ম্যাপ ভিউ ট্রিপের লাইফসাইকেল ম্যানেজ করে, ট্রিপের অগ্রগতি অনুযায়ী গাড়ির লোকেশনের জন্য ওয়েপয়েন্ট দেখায়। কোনও গাড়ির রুট জানা থাকলে, ম্যাপ ভিউতে গাড়ির রুট পলিলাইন আপডেট করা হয় যাতে রুটে গাড়ির প্রোগ্রেস দেখানো যায়।
জাভাস্ক্রিপ্টে ট্রিপ লোকেশন প্রোভাইডার	JavaScript ওয়েব অ্যাপের জন্য, ট্রিপ লোকেশন প্রোভাইডার শেয়ার করা ট্রিপ ম্যাপে ট্র্যাক করা অবজেক্টের জন্য লোকেশন সংক্রান্ত তথ্য ফিড করে। আরও তথ্যের জন্য, ট্রিপ লোকেশন প্রোভাইডার ইনস্ট্যানশিয়েট করুন দেখুন। আপনি ট্রিপ লোকেশন প্রদানকারী ব্যবহার করে ট্রিপের জন্য নিম্নলিখিত বিবরণ ট্র্যাক করতে পারবেন: কোনও ট্রিপের পিক-আপ বা ড্রপ-অফ লোকেশন। ট্রিপের জন্য অ্যাসাইন করা গাড়ির লোকেশন ও রুট।

ট্র্যাক করা লোকেশন অবজেক্ট

লোকেশন প্রদানকারী, ওয়েপয়েন্ট ও গাড়ির মতো অবজেক্টের লোকেশন ট্র্যাক করে, যা নিম্নলিখিত সারণীতে বর্ণনা করা হয়েছে।

ট্র্যাক করা লোকেশন	বিবরণ
পিক-আপ করার জায়গা	পিক-আপ লোকেশন হল সেই লোকেশন যেখান থেকে ট্রিপ শুরু হয়।
গন্তব্যের লোকেশন	গন্তব্যের লোকেশন হল সেই লোকেশন যেখানে ট্রিপ শেষ হয়। এটি ড্রপ-অফ লোকেশন চিহ্নিত করে।
ওয়েপয়েন্ট লোকেশন	ট্র্যাক করা ট্রিপের রুটে যেকোনও মধ্যবর্তী লোকেশনকে ওয়েপয়েন্ট লোকেশন বলা হয়। টেকনিক্যালি বলতে গেলে, ওয়েপয়েন্টের মধ্যে পিক-আপ ও ড্রপ-অফ লোকেশন অন্তর্ভুক্ত থাকতে পারে, তবে সাধারণত ওয়েপয়েন্ট বলতে রুটের মধ্যে থাকা মধ্যবর্তী স্টপকে বোঝায়। যেমন, ডেলিভারি রুটে পিক-আপ ও গন্তব্য লোকেশনের মধ্যে স্টপগুলি হল ওয়েপয়েন্ট লোকেশন। আরও তথ্যের জন্য, Fleet Engine ডকুমেন্টেশনে ট্রিপের ওয়েপয়েন্ট দেখুন।
গাড়ির লোকেশন	গাড়ির লোকেশন হল কোনও গাড়ির রিপোর্ট করা লোকেশন। আরও তথ্যের জন্য, Fleet Engine ডকুমেন্টেশনে গাড়ির লোকেশন দেখুন।

আপনার ম্যাপ স্টাইল করুন

মার্কার ও পলিলাইন স্টাইল ম্যাপে ট্র্যাক করা লোকেশন অবজেক্টের লুক ও ফিল নির্ধারণ করে। আপনার ওয়েব অ্যাপ্লিকেশনের স্টাইলের সাথে ম্যাচ করতে আপনি কাস্টম স্টাইলিং বিকল্প ব্যবহার করতে পারবেন।

ট্র্যাক করা লোকেশনের দৃশ্যমানতা নিয়ন্ত্রণ করুন

Fleet Engine-এ আগে থেকে নির্ধারিত লোকেশন প্রোভাইডার ম্যাপে ট্র্যাক করা লোকেশন অবজেক্টের জন্য এইসব দৃশ্যমানতা সংক্রান্ত নিয়ম অনুসরণ করে। আপনি কাস্টম বা ডেরাইভড লোকেশন প্রোভাইডার তৈরি করলে, দৃশ্যমানতার নিয়ম পরিবর্তন করতে পারেন।

• ট্রিপ চলাকালীনই শুধু গাড়ি দেখা যায়: ট্রিপের জন্য গাড়ি অ্যাসাইন করা থেকে শুরু করে ড্রপ অফ করা পর্যন্ত সেটি দেখা যায়। ট্রিপ বাতিল করা হলে, গাড়ি আর দেখা যায় না।

• অন্য সব লোকেশন মার্কার সবসময় দেখা যায়: শুরু, গন্তব্য ও ওয়েপয়েন্টের জন্য অন্য সব লোকেশন মার্কার সবসময় ম্যাপে দেখানো হয়। যেমন, ট্রিপ বা ডেলিভারির স্ট্যাটাস যাই হোক না কেন, ট্রিপের ড্রপ অফ লোকেশন বা শিপমেন্ট ডেলিভারির লোকেশন সবসময় ম্যাপে দেখানো হয়।

এর পরে কী করতে হবে

আপনি যে প্ল্যাটফর্মে ট্রিপ ফলো করতে চান সেটির ডকুমেন্টেশন দেখুন:

• Android
• iOS
• JavaScript