স্টপ-ওনলি ইন্টিগ্রেশন

সংক্ষিপ্ত বিবরণ

আপনি যদি গুগল ম্যাপসের জন্য জিটিএফএস ফিডের প্রদানকারী না হন, তাহলে আপনার ইন্টিগ্রেশনটি শুধুমাত্র স্টপ-ভিত্তিক হবে। এই ইন্টিগ্রেশনের জন্য, আপনি কীভাবে বিভিন্ন ট্রেন বা বাস স্টপ শনাক্ত করেন, তা আমাদের বুঝতে হবে।

সাধারণ ফিড স্পেসিফিকেশন

ইন্টিগ্রেশন শুরু করার সময়, আমরা প্রতিটি ইন্টিগ্রেশনের জন্য একটি অনন্য শনাক্তকারী তৈরি করি, যেমন: ch_google_test (দেশের কোড, পার্টনারের নাম, ইন্টিগ্রেশন) অথবা eu_google (অঞ্চলের কোড, পার্টনারের নাম)।

অংশীদাররা CSV ফরম্যাটে টেক্সট ফাইল সম্বলিত একটি ফাইল সরবরাহ করে যা প্রতিটি ইন্টিগ্রেশনের জন্য প্রয়োগ করা হয়। প্রতিটি CSV ফাইলে অবশ্যই একটি হেডার সারি থাকতে হবে যার কলামের নামগুলো সংশ্লিষ্ট ফিড স্পেসিফিকেশন টেবিলে নির্দিষ্ট করা "ফিল্ড নেম"-এর সাথে মিলতে হবে।

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

ফিড বন্ধ করার নির্দিষ্টকরণ (প্রয়োজনীয়)

স্টপ ফাইলে নিম্নলিখিত কলামগুলো থাকা উচিত:

ক্ষেত্রের নাম	টাইপ করুন ( জিটিএফএস দেখুন)	বর্ণনা
stop_id	পরিচয়পত্র (প্রয়োজনীয়)	একটি স্টপ বা স্টেশনকে শনাক্ত করার অনন্য শনাক্তকারী। বড় স্টেশনগুলিতে কেবল একটিই এন্ট্রি থাকা উচিত। আপনার পার্টনার সার্ভার এপিআই-তে কল করার সময় এবং টিকেটিং ডিপ লিঙ্কে এটি ব্যবহৃত হয়।
stop_name	পাঠ্য (প্রয়োজনীয়)	স্টপ ম্যাপিং, ক্যাশে ফিলিং এবং মূল্যের নির্ভুলতার ডেটা ডিবাগ করার জন্য একটি সহজে পাঠযোগ্য নাম।
stop_lat	অক্ষাংশ (প্রয়োজনীয়)	থামার অক্ষাংশ।
stop_lon	দ্রাঘিমাংশ (প্রয়োজনীয়)	বিরতির দ্রাঘিমাংশ।

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

বাজার সেট ফিড স্পেসিফিকেশন (ঐচ্ছিক)

ম্যাপ করা স্টপগুলো ব্যবহার করে আমরা এই ইন্টিগ্রেশনের জন্য মার্কেট সেট তৈরি করি (জনপ্রিয় উৎস/গন্তব্য জোড়াগুলোর একটি তালিকা)। সেখান থেকে, একটি মার্কেট সেট ফিড প্রদান করে আপনি এই মার্কেট সেটটি ছোট করার সুযোগ পাবেন।

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

মার্কেট সেট ফাইলে নিম্নলিখিত কলামগুলো থাকা উচিত:

ক্ষেত্রের নাম	টাইপ করুন ( জিটিএফএস দেখুন)	বর্ণনা
origin_stop_id	পরিচয়পত্র (প্রয়োজনীয়)	বাজারটির উৎস stop_id ।
destination_stop_id	পরিচয়পত্র (প্রয়োজনীয়)	মার্কেটটির গন্তব্য stop_id ।

অংশীদার কনফিগারেশন

শুধুমাত্র-স্টপ ইন্টিগ্রেশন ব্যবহার করার সময়, পার্টনার কনফিগারেশন বিভাগে বর্ণিত স্ট্যাটিক পার্টনার কনফিগারেশনের জন্য আমাদের অতিরিক্ত তথ্যের প্রয়োজন হয়।

রেফারেল লিঙ্ক স্পেসিফিকেশন

বুকিং লিঙ্কের (যাকে Ticketing link বলা হয়) ফরম্যাট এবং প্যারামিটারগুলো টিকেটিং লিঙ্কস -এ সংজ্ঞায়িত করা হয়েছে।

অংশীদার এপিআই প্যারামিটার

পার্টনার এপিআই ( GetBulkTripOptionsRequest )-এর জন্য SegmentKeys প্যারামিটারগুলো ডিপ লিঙ্ক স্পেসিফিকেশনের উপর ভিত্তি করে তৈরি। আমরা ticketing_trip_id খালি রেখে শুধুমাত্র from_ticketing_stop_time_id , to_ticketing_stop_time_id , service_date , boarding_time এবং arrival_time অন্তর্ভুক্ত করে SegmentKeys ব্যবহার করি। আমরা প্রতিটি সেগমেন্টের জন্য একটি করে একাধিক SegmentKeys উল্লেখ করার মাধ্যমে সমস্ত ট্রান্সফার সহ রুটটি সম্পূর্ণরূপে নির্দিষ্ট করব।