ট্রিপ ডেটা ম্যানেজ করা

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

ডেটা পেলোড পড়ুন

ড্রাইভার নেভিগেট করা শুরু করলে, রুট বরাবর নির্দিষ্ট সময় অন্তর (ডিফল্ট হিসেবে প্রতি ৬০ সেকেন্ডে) এবং ড্রাইভার গন্তব্যে পৌঁছালে, Google Maps বা Waze, Navigation Connect সার্ভারে ট্রিপ ডেটা পেলোড পাঠায়। প্রতিটি JSON মেসেজে ট্রিপ সংক্রান্ত প্রাসঙ্গিক ডেটা থাকে, যার মধ্যে ড্রাইভারের রোড-স্ন্যাপড কোঅর্ডিনেট, অতিক্রম করা দূরত্ব এবং পৌঁছানোর আনুমানিক সময় (ETA) অন্তর্ভুক্ত। এইসব আপডেট ড্রাইভারের অ্যাক্টিভ, রিয়েল-টাইম রুট দেখায়, তাই আপনার ব্যাকএন্ডের মাধ্যমে আগে থেকে হিসেব করা রুটের থেকে আলাদা হতে পারে (প্রায়শই জিজ্ঞাসিত প্রশ্ন দেখুন)।

নিম্নলিখিত কোড স্যাম্পেল থেকে বোঝা যায় যে, কোনও ড্রাইভার King's Cross থেকে Central St. Giles পর্যন্ত ট্রিপের জন্য নেভিগেশন শুরু করলে, ট্রিপ ডেটা পেলোড কেমন হয়।

{
  "name": "projects/123456/trips/221B9CD6-4146-4CBF-9556-853817654938",
  "state": "ENROUTE",
  "execution": {
    "origin": {
      "point": {
        "latitude": 51.5333329,
        "longitude": -0.1265845
      }
    },
    "destination": {
      "point": {
        "latitude": 51.515598,
        "longitude": -0.1277623
      }
    },
    "location": {
      "point": {
        "latitude": 51.5333329,
        "longitude": -0.1265845
      },
      "sourceTime": "2025-05-30T12:37:26Z",
      "serverTime": "2025-05-30T12:37:26.221069Z"
    },
    "traveledDuration": "0s",
    "remainingDuration": "990s",
    "traveledDistanceMeters": 0,
    "remainingDistanceMeters": 2879,
    "stopAddedInRoute": false
  }
}

অ্যাক্টিভ ট্রিপের স্ট্যাটাস মনিটর করা

সফলভাবে শুরু হয়েছে কিনা তা কনফার্ম করতে এবং প্রগ্রেস মনিটর করতে, প্রতিটি পেলোডে state ফিল্ড মূল্যায়ন করুন।

স্ট্যাটাস বিবরণ
NEW ট্রিপ তৈরি করা হয়েছে, কিন্তু ড্রাইভার এখনও নেভিগেট করা শুরু করেননি।
ENROUTE ড্রাইভার সক্রিয়ভাবে গন্তব্যে নেভিগেট করছেন। ট্রিপ যাচাই করা হয়েছে এবং সফলভাবে শুরু হয়েছে তা কনফার্ম করতে এই স্ট্যাটাস ব্যবহার করুন।

যোগ করা স্টপ ম্যানেজ করুন

নেভিগেশনের সময় ড্রাইভাররা তাদের রুটে স্টপ যোগ করতে পারবেন। যদি তা হয়, তাহলে Navigation Connect, JSON ডেটা পেলোডে execution.stopAddedInRoute ফিল্ডকে true হিসেবে সেট করে। Navigation Connect API আসল গন্তব্যের দিকে ড্রাইভারকে ট্র্যাক করা চালিয়ে যায়। পৌঁছানোর আনুমানিক সময় (ETA), দূরত্ব ও সময়সীমার মতো মেট্রিক যোগ করা স্টপ অন্তর্ভুক্ত করার জন্য বৃদ্ধি পায়।

স্টপ যোগ করার আচরণ নেভিগেশন অ্যাপের উপর নির্ভর করে এবং এর স্ট্যান্ডার্ড কার্যকারিতার সাথে ম্যাচ করে:

  • Google Maps: ড্রাইভাররা তাদের রুটে একাধিক স্টপ যোগ করতে পারেন।
  • Waze: ড্রাইভাররা শুধুমাত্র একটি স্টপ যোগ করতে পারবেন। কোনও ড্রাইভার আরেকটি স্টপ যোগ করার চেষ্টা করলে, Waze তাকে বর্তমান রুটে স্টপ যোগ করার পরিবর্তে নতুন নেভিগেশন সেশন শুরু করার জন্য প্রম্পট করে।

এই ফিচার কাজ করার জন্য আপনাকে ব্যাকএন্ড ইনপুট অ্যাডজাস্ট করতে হবে না।

যাচাইকরণ ও শুরু করা সংক্রান্ত সমস্যার সমাধান করা

আপনি ENROUTE স্ট্যাটাস না পেলে, সম্ভবত যাচাইকরণ সংক্রান্ত সমস্যা হয়েছে। সাধারণত API প্যারামিটারের বানান ভুল হলে বা ট্রিপ টোকেনের মেয়াদ শেষ হয়ে গেলে এটি হয়। আপনার প্রাথমিক CreateTrip উত্তরে টোকেনের মেয়াদ শেষ হওয়ার সময় চেক করুন।

স্ট্যাটাস NEW থেকে ENROUTE-এ পরিবর্তন না হলে, ড্রাইভারের ডিভাইস হয়ত যাচাইকরণে বাধা দিচ্ছে। এইসব ক্ষেত্রে Navigation Connect কোনও ত্রুটি মেসেজ পাঠায় না। নিম্নলিখিত বিষয়গুলি যাচাই করুন:

  • ড্রাইভারের ডিভাইসে Waze-এর 5.15.5 বা তার পরবর্তী যেকোনও ভার্সন অথবা Google Maps-এর 26.14 বা তার পরবর্তী যেকোনও ভার্সন ইনস্টল করা আছে।
  • ড্রাইভার Android Auto বা Apple CarPlay ব্যবহার করছেন না।
  • ড্রাইভারের ইন্টারনেট কানেকশন চালু আছে।

বাকি রুট ডেটা ম্যানেজ করা

ট্রিপ তৈরি করার সময় আপনি বাকি থাকা রুটের রিপোর্টিং চালু করে থাকলে, আপনার ব্যাকএন্ড বাকি থাকা রুটের পলিলাইন এবং ড্রাইভারের বর্তমান লোকেশন থেকে তার গন্তব্য পর্যন্ত রিয়েল-টাইম ট্রাফিক পরিস্থিতি সংক্রান্ত তথ্য পায়। ড্রাইভারদের Android-এ Waze ভার্সন 5.20.0.2 বা তার পরবর্তী যেকোনও ভার্সন, iOS-এ 5.20.0.1 বা তার পরবর্তী যেকোনও ভার্সন অথবা Android-এর জন্য Google Maps ভার্সন 26.27 বা তার পরবর্তী যেকোনও ভার্সন থাকতে হবে।

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

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

আপনি Google Cloud Pub/Sub ব্যবহার করে GetTrip অনুরোধ পাঠান বা ইভেন্ট-চালিত আপডেট পান, execution.remainingRoute ফিল্ডে নেভিগেশন কানেক্ট বাকি রুটের বিবরণ রিটার্ন করে। তবে, পেলোড কীভাবে এই ডেটা ফর্ম্যাট ও স্ট্রাকচার করে তা আপনার ব্যবহার করা রিট্রিভাল পদ্ধতির উপর নির্ভর করে।

GetTripটি পদ্ধতি

আপনি GetTrip মেথড কল করলে, পলিলাইনের জন্য উত্তরের ফর্ম্যাট আপনার অনুরোধে উল্লেখ করা routePolylineFormat প্যারামিটারের উপর নির্ভর করে। আরও তথ্যের জন্য, পলিলাইন ফর্ম্যাট কাস্টমাইজ করুন দেখুন।

সব পলিলাইন ফর্ম্যাটের জন্য, Navigation Connect, execution.remainingRoute.trafficInformation ফিল্ডে SpeedReadingInterval অবজেক্টের আলাদা তালিকা হিসেবে ট্রাফিক রিটার্ন করে। এই অবজেক্টগুলি নিম্নলিখিত ভ্যালু ব্যবহার করে ট্রাফিক বিভাগকে পলিলাইন ইনডেক্সে ম্যাপ করে:

  • startPolylinePointIndex: পলিলাইনে ট্রাফিক ইন্টারভ্যালের শুরুর ইনডেক্স।
  • endPolylinePointIndex: ট্রাফিক ইন্টারভ্যালের শেষ ইনডেক্স।
  • speed: এই সেগমেন্টের জন্য ট্রাফিক ক্যাটেগরি: NORMAL, SLOW, বা TRAFFIC_JAM।

Google Cloud Pub/Sub আপডেট

আপনি যখন Pub/Sub-এর মাধ্যমে ট্রিপ ডেটা ফিরিয়ে আনেন, তখন আপডেট সবসময় execution.remainingRoute ফিল্ডে FeatureCollection-এর ইউনিফায়েড GeoJSON-এ বাকি থাকা রুটের ডেটা ফিরিয়ে আনে।

এই ফর্ম্যাটটি ট্রাফিক গতির সাথে সরাসরি পলিলাইন জিওমেট্রিকে একত্রিত করে, ম্যানুয়ালি ইন্ডেক্স ম্যাপ করার প্রয়োজনীয়তা দূর করে।

একটি উদাহরণ Pub/Sub পেলোড দেখুন

নিম্নলিখিত কোড স্যাম্পেল, Pub/Sub মেসেজের updatedTrip অবজেক্টের মধ্যে execution.remainingRoute ফিল্ডে ফেরত আসা GeoJSON স্ট্রাকচার দেখায়:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.3934, 37.7955],
          [-122.4010, 37.7980]
        ]
      },
      "properties": {
        "speed": "SLOW"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-122.4010, 37.7980],
          [-122.4058, 37.8025],
          [-122.4187, 37.8021]
        ]
      },
      "properties": {
        "speed": "NORMAL"
      }
    }
  ]
}
    

পে-লোডের সাইজ অপ্টিমাইজ করুন

কোঅর্ডিনেট অ্যারে বড় হওয়ার কারণে, আপনার Pub/Sub মেসেজে বাকি থাকা রুটের ডেটা যোগ করলে, পে-লোডের সাইজ উল্লেখযোগ্যভাবে বেড়ে যেতে পারে (প্রতি মেসেজে ১৩-১৪ কেবি পর্যন্ত)। আপনি যদি ঘন ঘন আপডেট পান, তাহলে এই ভলিউম ব্যাকএন্ড প্রসেসিং লোড এবং ব্যবহারের খরচ বাড়িয়ে দিতে পারে।

আপনার স্ট্রিম অপ্টিমাইজ করতে, ট্রিপ তৈরি করার সময় আপনার TripConfig অবজেক্টে pubsubFieldMask প্যারামিটার ব্যবহার করুন যাতে ভারী ফিল্ড বাদ দেওয়া যায়। আরও জানতে, ঐচ্ছিক কনফিগারেশন দেখুন।

রুট ডেভিয়েশন ম্যানেজ করা (শুধুমাত্র Waze)

ড্রাইভারদের Waze-এর 5.22 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

ট্রিপ তৈরি করার সময় আপনি রুট ডেভিয়েশন রিপোর্টিং চালু করে থাকলে, ড্রাইভার রুট থেকে সরে গেলে, API রুট ডেভিয়েশন মেটাডেটা রিটার্ন করে। আপনি নিম্নলিখিত উপায়ে এই ডেটা অ্যাক্সেস করতে পারবেন:

  • চাহিদা অনুযায়ী: GetTrip মেথড কল করুন। সার্ভার শেষ জানা বিচ্যুতি অবস্থা বজায় রাখে।
  • রিয়েল-টাইম: Google Cloud Pub/Sub সাবস্ক্রাইব করুন। পরিষেবাটি শনাক্ত করার ৫ সেকেন্ডের মধ্যে আগে থেকে থাকা updated_trip ইভেন্ট ব্যবহার করে ডেভিয়েশন আপডেট প্রকাশ করে।

ডেভিয়েশন পেলোড পড়ুন

ইভেন্ট বিশ্লেষণ করতে আপনাকে সাহায্য করার জন্য last_route_deviation অবজেক্ট নিম্নলিখিত মেটাডেটা প্রদান করে।

ফিল্ড ধরন বিবরণ
location LatLng ক্লায়েন্ট ডিভাইস যেখানে বিচ্যুতি রেকর্ড করেছে সেখানকার অক্ষাংশ ও দ্রাঘিমাংশ স্থানাঙ্ক।
source TriggerSource বিচ্যুতির কারণ। ড্রাইভার কোনও অপ্রত্যাশিত অ্যাকশন নিয়েছেন কিনা বা সিস্টেমের নির্দেশিকা অনুসরণ করেছেন কিনা তা নির্ধারণ করতে এটি ব্যবহার করুন:
  • DRIVER_INITIATED_REROUTE: ড্রাইভার সক্রিয়ভাবে কোনও বিকল্প বেছে নিয়েছেন (যেমন, ভুল দিকে ঘুরে যাওয়া বা ম্যানুয়ালি নতুন কোনও পথ বেছে নেওয়া)।
  • SYSTEM_INITIATED_REROUTE: নেভিগেশন অ্যাপ নতুন রুট গণনা করেছে (যেমন, ট্রাফিক পরিস্থিতি পরিবর্তন বা রাস্তা বন্ধ থাকার কারণে)।
client_timestamp Timestamp ক্লায়েন্ট ডিভাইস যে সময়ে বিচ্যুতি শনাক্ত করেছে।
server_timestamp Timestamp সার্ভার যে সময়ে ডেভিয়েশন আপডেট প্রসেস করেছে।

ট্রিপ শেষ হওয়ার স্ট্যাটাস ম্যানেজ করুন

ড্রাইভার গন্তব্যে পৌঁছালে বা নেভিগেট করা বন্ধ করলে, পেলোড নিম্নলিখিত শেষ অবস্থার একটি ফিরিয়ে দেয়। আপনার অ্যাপে উপযুক্ত পরবর্তী ধাপ ট্রিগার করতে এইসব স্ট্যাটাস ব্যবহার করুন।

স্ট্যাটাস বিবরণ প্রস্তাবিত অ্যাকশন
ARRIVED ড্রাইভার গন্তব্যে পৌঁছে গেছেন। remainingDistanceMeters চেক করুন। ড্রাইভার যদি কাছাকাছি পার্ক করেন কিন্তু সঠিক কোঅর্ডিনেটে না করেন, তাহলে আপনার অ্যাপে হাঁটার দিকনির্দেশ প্রদান করার কথা বিবেচনা করুন।
SUSPENDED গন্তব্যে পৌঁছানোর আগে ড্রাইভার ম্যানুয়ালি ধাপে ধাপে নেভিগেশন বন্ধ করে দিয়েছেন।
কারণ, কোনও সেশন আগে শেষ হয়ে গেলে, Google Maps বা Waze অটোমেটিক ড্রাইভারদের আপনার অ্যাপে ফিরিয়ে আনে না, তাই ড্রাইভারকে ম্যানুয়ালি ফিরে আসার বোতামে ট্যাপ করতে হবে।
ড্রাইভারদের যাত্রা সম্পূর্ণ করতে সাহায্য করার জন্য, গন্তব্যের সাথে execution.location তুলনা করুন। যদি দূরত্ব বাকি থাকে, তাহলে ট্রিপ আবার শুরু করতে বা হাঁটার মোডে পরিবর্তন করতে একটি বোতাম বা লিঙ্ক প্রদান করুন।
FAILED টেকনিক্যাল সমস্যার কারণে কানেকশন বিঘ্নিত হয়েছে। অ্যাপটি রুট গণনা করতে না পারলে বা নিরাপত্তা সংক্রান্ত সতর্কতা দেখালে এটি ঘটে। ড্রাইভার হয়ত এখনও নেভিগেট করছেন, তবে আপনি আপডেট পাবেন না। আপনার অ্যাপে ম্যানুয়াল স্ট্যাটাস ট্র্যাকিংয়ে ফিরে যান।
CLIENT_ERROR নিম্নলিখিত কারণগুলির মধ্যে কোনও একটির জন্য এই স্ট্যাটাস দেখানো হয়:
  • ড্রাইভার সম্মতি প্রত্যাহার করে নেন।
  • ড্রাইভার এমন প্ল্যাটফর্ম ব্যবহার করেন যা কাজ করে না, যেমন Android Auto বা Apple CarPlay।
  • আপনার অ্যাপ আলাদা আলাদা ট্রিপে একটি ট্রিপ টোকেন আবার ব্যবহার করে। যেমন, নেভিগেশন কানেক্ট সেইসব অনুরোধ বাতিল করে দেয় যেগুলি ট্রিপের গন্তব্য পরিবর্তন করে বা সম্পূর্ণ হয়ে যাওয়া ট্রিপ আপডেট করে।
  • ট্রিপ চলাকালীন যেকোনও সময় ড্রাইভার মার্কিন যুক্তরাষ্ট্রে থাকলে, কিন্তু আপনি সেট-আপের সময় আপনার অ্যাপ যাচাই করার সময় মার্কিন যুক্তরাষ্ট্রে ডেটা শেয়ারিং চালু না করলে।
আপনার অ্যাপে ম্যানুয়াল স্ট্যাটাস ট্র্যাকিংয়ে ফিরে যান।