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

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

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

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

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

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

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

স্টপ ফিড স্পেসিফিকেশন (প্রয়োজনীয়)

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

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

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

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

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

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

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

ক্ষেত্রের নাম	টাইপ করুন ( GTFS দেখুন)	বিবরণ
origin_stop_id	আইডি (প্রয়োজনীয়)	বাজারের মূল stop_id ।
destination_stop_id	আইডি (প্রয়োজনীয়)	বাজারের গন্তব্য stop_id ।

পার্টনার কনফিগারেশন

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

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

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

পার্টনার এপিআই প্যারামিটার

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