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

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

Consumer app following a trip

ভোক্তা SDK কি?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

how the Consumer SDK works

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

1 ভোক্তা অ্যাপ একটি ভ্রমণের অনুরোধ করে আপনার ব্যাকএন্ড সার্ভার একটি অন-ডিমান্ড ট্রিপ অনুরোধ পায় এবং নিম্নলিখিতগুলি করে:
  • ফ্লিট ইঞ্জিনে একটি ট্রিপ তৈরি করে।
  • একটি যানবাহন ট্রিপ বরাদ্দ.
2 ড্রাইভার ট্রিপ গ্রহণ ড্রাইভার অ্যাপটি ট্রিপ আইডি এবং ট্রিপের তথ্য পায় এবং ড্রাইভার ট্রিপ গ্রহণ করে।
3 উপভোক্তা অ্যাপ ট্রিপ অনুসরণ করার জন্য অ্যাক্সেসের অনুরোধ করে ভোক্তা অ্যাপ আপনার ব্যাকএন্ড থেকে ট্রিপ আইডি পায় এবং ট্রিপ অনুসরণ করা শুরু করার অনুরোধ করে।
4 ড্রাইভার যাত্রা শুরু করে ড্রাইভার যখন ট্রিপ শুরু হয়েছে তা নির্দেশ করতে ড্রাইভার অ্যাপ ব্যবহার করে, অ্যাপটি ড্রাইভার SDK-এর মাধ্যমে আপনার ব্যাকএন্ড সার্ভারকে অবহিত করে। উদাহরণস্বরূপ, যখন ড্রাইভার রেস্তোরাঁ থেকে বের হতে চলেছে বা পিকআপ লোকেশনে গাড়ি চালাচ্ছে।
5 ফ্লিট ইঞ্জিন ভ্রমণের তথ্য পাঠাতে শুরু করে ফ্লিট ইঞ্জিন ট্রিপ ট্র্যাক করা শুরু করে এবং গ্রাহক অ্যাপের সাথে এর অগ্রগতি শেয়ার করে।
6 ভোক্তা অ্যাপ ভ্রমণের তথ্য প্রদর্শন করে ভোক্তা অ্যাপটি ভোক্তাকে অবহিত করে এবং তাদের কাছে ভ্রমণের তথ্য প্রদর্শন করা শুরু করে, ট্রিপটি অগ্রসর হওয়ার সাথে সাথে আপডেট করে।
7 ট্রিপ বাতিল বা সম্পন্ন হয়েছে ড্রাইভার যখন ট্রিপ বাতিল করে বা সম্পূর্ণ করে, তখন ড্রাইভার অ্যাপ লোকেশন ট্র্যাকিং অক্ষম করে, এবং আপনার ব্যাকএন্ড সার্ভার ফ্লিট ইঞ্জিনকে বলে ট্রিপটিকে বাতিল বা সম্পূর্ণ হিসাবে চিহ্নিত করতে।
8 কনজিউমার অ্যাপ ট্রিপ অনুসরণ করা বন্ধ করে দেয় ট্রিপটি বাতিল বা সম্পূর্ণ হিসাবে দেখায়।
9 পরবর্তী ট্রিপের জন্য প্রক্রিয়াটি পুনরাবৃত্তি হয় একটি নতুন ট্রিপ তৈরি করা হয় এবং প্রক্রিয়াটি পুনরাবৃত্তি হয়।

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

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

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

1 অ্যান্ড্রয়েডে কনজিউমার এসডিকে সেট আপ করুন আপনার অ্যাপে অন-ডিমান্ড ট্রিপ অনুসরণ করতে, কনজিউমার SDK সেট-আপ করুন। আরও তথ্যের জন্য, Android গ্রাহক SDK পান দেখুন।
2 ভিজ্যুয়াল ইন্টারফেস সেট আপ করুন একটি মানচিত্র সংজ্ঞায়িত করুন এবং আপনার ভোক্তা অভিজ্ঞতা সেট আপ করতে ভেক্টর মানচিত্রের জন্য সমর্থন যোগ করুন। আরও তথ্যের জন্য, একটি মানচিত্র সেট আপ দেখুন।
3 একটি ট্রিপ অনুসরণ করুন আপনার ভোক্তার সাথে উপযুক্ত গাড়ির অবস্থান শেয়ার করতে একটি ট্রিপ অনুসরণ করুন। আরও তথ্যের জন্য, একটি ট্রিপ অনুসরণ করুন দেখুন।
5 ট্রিপের অগ্রগতি আপডেট করুন এবং ট্রিপের ত্রুটিগুলি পরিচালনা করুন৷ আপনার ভ্রমণের বিশদ আপডেট করুন যেমন ভ্রমণের দূরত্ব এবং আগমনের আনুমানিক সময়, এবং ট্রিপের সময় যেকোন ত্রুটিগুলি পরিচালনা করুন। আরও তথ্যের জন্য, ট্রিপের অগ্রগতি আপডেট করুন এবং ট্রিপ ত্রুটিগুলি পরিচালনা করুন দেখুন।
5 একটি ট্রিপ সম্পূর্ণ হলে, অনুসরণ করা বন্ধ করুন আপনার ভোক্তার সাথে গাড়ির অবস্থান শেয়ার করা বন্ধ করতে একটি ট্রিপ অনুসরণ করা বন্ধ করুন। আরও তথ্যের জন্য, একটি ট্রিপ অনুসরণ করা বন্ধ করুন দেখুন।

iOS

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

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

1 জাভাস্ক্রিপ্টে কনজিউমার SDK সেট আপ করুন আপনার অ্যাপে অন-ডিমান্ড ট্রিপ অনুসরণ করতে, কনজিউমার SDK সেট-আপ করুন। আরও তথ্যের জন্য, জাভাস্ক্রিপ্ট কনজিউমার SDK সেট আপ দেখুন।
2 একটি মানচিত্র লোড এবং কাস্টমাইজ করুন মানচিত্র জাভাস্ক্রিপ্ট API সক্ষম করুন এবং আপনার ভোক্তা অভিজ্ঞতা সেট আপ করতে অনুমোদন সেট আপ করুন৷ আরও তথ্যের জন্য, একটি মানচিত্র সেট আপ দেখুন।
3 একটি ট্রিপ অনুসরণ করুন আপনার ভোক্তার সাথে উপযুক্ত গাড়ির অবস্থান শেয়ার করতে একটি ট্রিপ অনুসরণ করুন। আরও তথ্যের জন্য, একটি ট্রিপ অনুসরণ করুন দেখুন।
5 ট্রিপের অগ্রগতি আপডেট করুন এবং ট্রিপের ত্রুটিগুলি পরিচালনা করুন৷ আপনার ভ্রমণের বিশদ আপডেট করুন যেমন ভ্রমণের দূরত্ব এবং আগমনের আনুমানিক সময়, এবং ট্রিপে যেকোন ত্রুটিগুলি পরিচালনা করুন। আরও তথ্যের জন্য, আপডেট দেখুন এবং ট্রিপের অগ্রগতি অনুসরণ করুন এবং ট্রিপ ত্রুটিগুলি পরিচালনা করুন ।
5 একটি ট্রিপ সম্পূর্ণ হলে, অনুসরণ করা বন্ধ করুন আপনার ভোক্তার সাথে গাড়ির অবস্থান শেয়ার করা বন্ধ করতে একটি ট্রিপ অনুসরণ করা বন্ধ করুন। আরও তথ্যের জন্য, একটি ট্রিপ অনুসরণ করা বন্ধ করুন দেখুন।

উপাদান

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

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

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

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

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

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

ম্যাপ ভিউ এবং ট্রিপ ট্র্যাকার

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

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

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

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

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

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

আপনার মানচিত্র শৈলী

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

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

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

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

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

এরপর কি

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