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

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

কনজিউমার SDK কী?

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

কনজিউমার SDK প্ল্যাটফর্ম-নির্দিষ্ট API গুলি আপনাকে আপনার অ্যাপ্লিকেশনগুলিতে স্থানীয়ভাবে ভ্রমণ ভাগ করে নেওয়ার ক্ষমতা তৈরি করতে দেয়। কনজিউমার SDK নিম্নলিখিত প্ল্যাটফর্মগুলির জন্য উপলব্ধ:

• অ্যান্ড্রয়েড
• আইওএস
• জাভাস্ক্রিপ্ট

কেন কনজিউমার SDK ব্যবহার করবেন?

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

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

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

• আপনার ব্র্যান্ডিং চাহিদা অনুসারে মানচিত্রের UI কাস্টমাইজ করুন।

• পথে চলার সময় গাড়ির বর্তমান অবস্থান অনুসরণ করুন, এবং এর অবস্থান পর্যায়ক্রমে আপডেট করা হবে।

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

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

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

কনজিউমার SDK কীভাবে কাজ করে

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

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

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

এই টেবিলটি একটি ট্রিপের প্রবাহ দেখায় এবং তারপরে একটি গ্রাহক অ্যাপ দেখায়।

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

কনজিউমার SDK কীভাবে ব্যবহার করবেন

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

উপাদান

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

• প্রমাণীকরণ টোকেন ফেচার ।
• মানচিত্র দৃশ্য এবং ট্রিপ ট্র্যাকার ।

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

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

প্রমাণীকরণ টোকেন ফেচার

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

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

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

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

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

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

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

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

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

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

আপনার মানচিত্র স্টাইল করুন

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

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

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

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

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

এরপর কি?

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

• অ্যান্ড্রয়েড
• আইওএস
• জাভাস্ক্রিপ্ট