ভোক্তা SDK অন-ডিমান্ড ট্রিপ ওভারভিউ

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

Consumer app following a trip

কনজিউমার এসডিকে (Consumer SDK) বলতে কী বোঝায়?

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

কনজিউমার এসডিকে-এর প্ল্যাটফর্ম-নির্দিষ্ট এপিআইগুলো আপনাকে আপনার অ্যাপ্লিকেশনগুলোতে নেটিভভাবে জার্নি শেয়ার করার সক্ষমতা তৈরি করতে দেয়। কনজিউমার এসডিকে নিম্নলিখিত প্ল্যাটফর্মগুলোর জন্য উপলব্ধ:

কনজিউমার এসডিকে কেন ব্যবহার করবেন?

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

কনজিউমার এসডিকে দিয়ে আপনি কী করতে পারেন?

আপনি ড্রাইভার এসডিকে এবং ফ্লিট ইঞ্জিন থেকে প্রাপ্ত তথ্য ব্যবহার করে নিম্নলিখিত বৈশিষ্ট্যগুলি সহ কাস্টমাইজড গ্রাহক অভিজ্ঞতা তৈরি করতে পারেন:

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

  • যানবাহনটি পথ ধরে এগিয়ে যাওয়ার সময় তার বর্তমান অবস্থান অনুসরণ করুন, যার অবস্থান পর্যায়ক্রমে হালনাগাদ করা হবে।

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

  • অবশিষ্ট দূরত্ব দেখান।

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

কনজিউমার এসডিকে কীভাবে কাজ করে

উচ্চ স্তরে, কনজিউমার এসডিকে নিম্নলিখিত প্রক্রিয়াগুলোর উপর নির্ভর করে:

  • যথাযথ ফ্লিট ইঞ্জিন রোল থাকা, যাতে একটি প্রমাণীকৃত অ্যাপ গ্রাহকের অর্ডারের সাথে যুক্ত ট্রিপটি অনুসরণ করতে পারে।
  • আপনার ব্যাকএন্ড সিস্টেম দ্বারা গ্রাহক এবং ট্রিপের মধ্যে একটি সংযোগ স্থাপন করা হয়।
  • TripModel এবং JourneySharingSession SDK ক্লাসগুলো কনজিউমার অ্যাপে ট্রিপ ডেটা মডেল করে এবং ট্রিপ সেশন শেয়ার করে।

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

how the Consumer SDK works

এই সারণিতে একটি গ্রাহক অ্যাপ দ্বারা অনুসরণ করা ভ্রমণের প্রবাহ দেখানো হয়েছে।

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

কনজিউমার এসডিকে কীভাবে ব্যবহার করবেন

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

অ্যান্ড্রয়েড

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

আইওএস

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

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

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

উপাদান

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

ঐচ্ছিকভাবে, আপনি এই উপাদানগুলির সাহায্যে আপনার গ্রাহক অভিজ্ঞতাকে নিজের পছন্দ মতো সাজিয়ে নিতে পারেন:

প্রমাণীকরণ টোকেন সংগ্রহকারী

ফ্লিট ইঞ্জিনে সংরক্ষিত অবস্থান ডেটার অ্যাক্সেস নিয়ন্ত্রণ করতে, আপনাকে নিম্নলিখিতগুলি করতে হবে:

  1. আপনার সার্ভারে ফ্লিট ইঞ্জিনের জন্য একটি JSON ওয়েব টোকেন (JWT) তৈরির পরিষেবা চালু করুন। আরও তথ্যের জন্য, Issue JWTs দেখুন।

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

মানচিত্র দৃশ্য এবং ভ্রমণ ট্র্যাকার

ট্রিপ অনুসরণ করার মধ্যে যানবাহন ও ওয়েপয়েন্টগুলোর ভিজ্যুয়ালাইজেশনের উপাদান, সেইসাথে চালকের আনুমানিক পৌঁছানোর সময় (ETA) বা গাড়ি চালানোর জন্য অবশিষ্ট দূরত্বের কাঁচা ডেটা ফিড অন্তর্ভুক্ত থাকে।

নিম্নলিখিত সারণিতে এই উপাদানগুলো বর্ণনা করা হয়েছে:

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

ট্র্যাক করা অবস্থান বস্তু

অবস্থান প্রদানকারী নিম্নলিখিত সারণীতে বর্ণিত ওয়েপয়েন্ট এবং যানবাহনের মতো বস্তুগুলোর অবস্থান ট্র্যাক করে।

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

আপনার মানচিত্রগুলো সাজান

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

ট্র্যাক করা অবস্থানগুলির দৃশ্যমানতা নিয়ন্ত্রণ করুন

ফ্লিট ইঞ্জিনের পূর্বনির্ধারিত লোকেশন প্রোভাইডারগুলো ম্যাপে ট্র্যাক করা লোকেশন অবজেক্টগুলোর জন্য এই ভিজিবিলিটি নিয়মগুলো অনুসরণ করে। আপনি যদি একটি কাস্টম বা ডিরাইভড লোকেশন প্রোভাইডার তৈরি করেন, তবে আপনি ভিজিবিলিটি নিয়মগুলো পরিবর্তন করতে পারেন।

  • যানবাহন শুধুমাত্র ট্রিপ চলাকালীনই দেখা যায় : একটি ট্রিপের যানবাহন, সেটিকে ট্রিপে বরাদ্দ করার সময় থেকে শুরু করে গন্তব্যে পৌঁছে দেওয়ার সময় পর্যন্ত দৃশ্যমান থাকে। যদি ট্রিপটি বাতিল করা হয়, তবে যানবাহনটি আর দেখা যায় না।

  • অন্যান্য সমস্ত অবস্থান নির্দেশক সর্বদা দৃশ্যমান থাকে : উৎস, গন্তব্য এবং ওয়েপয়েন্টের জন্য অন্যান্য সমস্ত অবস্থান নির্দেশক সর্বদা মানচিত্রে দেখানো হয়। উদাহরণস্বরূপ, একটি ট্রিপের শেষে নামার স্থান বা একটি চালান বিতরণের স্থান, ট্রিপ বা ডেলিভারির অবস্থা নির্বিশেষে, সর্বদা মানচিত্রে দেখানো হয়।

এরপর কী?

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