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

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

কোনও ট্রিপ ফলো করা কনজিউমার অ্যাপ

গ্রাহক SDK কী?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

এই সারণীটি একটি ট্রিপের ফ্লো দেখায় যা একটি কনজিউমার অ্যাপ অনুসরণ করে।

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

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

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

Android

১ Android-এ Consumer SDK সেট-আপ করা আপনার অ্যাপে অন-ডিমান্ড ট্রিপ ফলো করতে, কনজিউমার SDK সেট-আপ করুন। আরও তথ্যের জন্য, Android Consumer SDK পান দেখুন।
২ ভিজ্যুয়াল ইন্টারফেস সেট-আপ করা আপনার গ্রাহক অভিজ্ঞতা সেট-আপ করতে, একটি ম্যাপ নির্ধারণ করুন এবং ভেক্টর ম্যাপের জন্য সহায়তা যোগ করুন। আরও তথ্যের জন্য, মানচিত্র সেট-আপ করুন দেখুন।
৩ ট্রিপ ফলো করা আপনার গ্রাহকের সাথে উপযুক্ত গাড়ির লোকেশন শেয়ার করতে ট্রিপ ফলো করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করা দেখুন।
৫ ট্রিপের অগ্রগতি আপডেট করা ও ট্রিপ সংক্রান্ত সমস্যার সমাধান করা ট্রিপের বিবরণ আপডেট করা, যেমন, ভ্রমণের দূরত্ব ও পৌঁছানোর আনুমানিক সময় এবং ট্রিপ চলাকালীন কোনও সমস্যা হলে তা সমাধান করা। আরও তথ্যের জন্য, ট্রিপের অগ্রগতি আপডেট করুন এবং ট্রিপ সংক্রান্ত সমস্যা সমাধান করুন বিকল্প দেখুন।
৫ ট্রিপ সম্পূর্ণ হয়ে গেলে, ফলো করা বন্ধ করুন আপনার গ্রাহকের সাথে গাড়ির লোকেশন শেয়ার করা বন্ধ করতে, ট্রিপ ফলো করা বন্ধ করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করা বন্ধ করুন দেখুন।

iOS

১ iOS-এ Consumer SDK সেট-আপ করা আপনার অ্যাপে অন-ডিমান্ড ট্রিপ ফলো করতে, কনজিউমার SDK সেট-আপ করুন। আরও তথ্যের জন্য, iOS Consumer SDK ডাউনলোড করুন।
২ ভিজ্যুয়াল ইন্টারফেস সেট-আপ করা আপনার গ্রাহকের অভিজ্ঞতা সেট-আপ করতে ম্যাপ ভিউ শুরু করুন এবং ম্যাপ ইভেন্ট ম্যানেজ করুন। আরও তথ্যের জন্য, মানচিত্র সেট-আপ করুন দেখুন।
৩ ট্রিপ ফলো করা আপনার গ্রাহকের সাথে উপযুক্ত গাড়ির লোকেশন শেয়ার করতে ট্রিপ ফলো করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করুন দেখুন।
৫ ট্রিপের অগ্রগতি আপডেট করা ও ট্রিপ সংক্রান্ত সমস্যার সমাধান করা ট্রিপের বিবরণ আপডেট করা, যেমন, ভ্রমণের দূরত্ব ও পৌঁছানোর আনুমানিক সময় এবং ট্রিপ চলাকালীন কোনও সমস্যা হলে তা সমাধান করা। আরও তথ্যের জন্য, ট্রিপের অগ্রগতি আপডেট করুন এবং ট্রিপ সংক্রান্ত সমস্যার সমাধান করুন বিকল্প দেখুন।
৫ ট্রিপ সম্পূর্ণ হয়ে গেলে, ফলো করা বন্ধ করুন আপনার গ্রাহকের সাথে কোনও গাড়ির লোকেশন শেয়ার করা বন্ধ করতে, ট্রিপ ফলো করা বন্ধ করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করা বন্ধ করুন দেখুন।

জাভাস্ক্রিপ্ট

১ জাভাস্ক্রিপ্টে Consumer SDK সেট-আপ করা আপনার অ্যাপে অন-ডিমান্ড ট্রিপ ফলো করতে, কনজিউমার SDK সেট-আপ করুন। আরও তথ্যের জন্য, JavaScript Consumer SDK সেট-আপ করুন।
২ ম্যাপ লোড ও কাস্টমাইজ করা গ্রাহকের অভিজ্ঞতা সেট-আপ করতে Maps JavaScript API চালু করুন এবং অথরাইজেশন সেট-আপ করুন। আরও তথ্যের জন্য, ম্যাপ সেট-আপ করুন দেখুন।
৩ ট্রিপ ফলো করা আপনার গ্রাহকের সাথে উপযুক্ত গাড়ির লোকেশন শেয়ার করতে ট্রিপ ফলো করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করুন দেখুন।
৫ ট্রিপের প্রোগ্রেস আপডেট করা এবং ট্রিপ সংক্রান্ত সমস্যার সমাধান করা আপনার ট্রিপের বিবরণ আপডেট করুন, যেমন ভ্রমণের দূরত্ব এবং পৌঁছানোর আনুমানিক সময় এবং ট্রিপে কোনও সমস্যা হলে তা সমাধান করুন। আরও তথ্যের জন্য, ট্রিপের প্রোগ্রেস আপডেট করা ও ফলো করা এবং ট্রিপ সংক্রান্ত সমস্যা ম্যানেজ করা দেখুন।
৫ ট্রিপ সম্পূর্ণ হয়ে গেলে, ফলো করা বন্ধ করুন আপনার গ্রাহকের সাথে গাড়ির লোকেশন শেয়ার করা বন্ধ করতে, ট্রিপ ফলো করা বন্ধ করুন। আরও তথ্যের জন্য, ট্রিপ ফলো করা বন্ধ করুন দেখুন।

উপাদানগুলি

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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