ওভারভিউ
আপনি যদি Google Maps-এর জন্য GTFS ফিড প্রদানকারী না হন, তাহলে আপনার ইন্টিগ্রেশন শুধুমাত্র-স্টপ । এই ইন্টিগ্রেশনের জন্য আমাদের বুঝতে হবে আপনি কীভাবে বিভিন্ন ট্রেন বা বাস স্টপকে চিহ্নিত করেন।
সাধারণ ফিড স্পেসিফিকেশন
ইন্টিগ্রেশন শুরু করার সময়, আমরা প্রতিটি ইন্টিগ্রেশনের জন্য একটি অনন্য শনাক্তকারী তৈরি করি, উদাহরণস্বরূপ: ch_google_test
(দেশের কোড, অংশীদারের নাম, ইন্টিগ্রেশন) বা eu_google
(অঞ্চল কোড, অংশীদারের নাম)।
অংশীদাররা CSV ফর্ম্যাটে টেক্সট ফাইল সমন্বিত একটি জিপ ফাইল প্রদান করতে পারে যা বিশ্বব্যাপী বা প্রতি ইন্টিগ্রেশনে প্রয়োগ করা হয়:
উদাহরণ 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
উদাহরণ 2:
- stops.txt (সমস্ত ইন্টিগ্রেশনে প্রযোজ্য)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
স্টপ ফিড স্পেসিফিকেশন (প্রয়োজনীয়)
স্টপ ফাইলে নিম্নলিখিত কলামগুলি থাকা উচিত:
ক্ষেত্রের নাম | প্রকার ( GTFS দেখুন) | বর্ণনা |
---|---|---|
stop_id | আইডি (প্রয়োজনীয়) | অনন্য শনাক্তকারী যা একটি স্টপ বা স্টেশন সনাক্ত করে। বড় স্টেশনগুলিতে শুধুমাত্র একটি এন্ট্রি থাকা উচিত। এটি আপনার পার্টনার সার্ভার API এ কল করার সময় এবং টিকিটিং ডিপ লিঙ্কে ব্যবহৃত হয়। |
stop_name | পাঠ্য (প্রয়োজনীয়) | স্টপ ম্যাপিং, ক্যাশে ফিলিং এবং মূল্য নির্ভুলতা ডেটা ডিবাগ করার জন্য একটি মানব পাঠযোগ্য নাম। |
stop_lat | অক্ষাংশ (প্রয়োজনীয়) | স্টপের অক্ষাংশ। |
stop_lon | দ্রাঘিমাংশ (প্রয়োজনীয়) | স্টপের দ্রাঘিমাংশ। |
আমরা একটি স্বয়ংক্রিয় ইনজেশন প্রক্রিয়া ব্যবহার করব যেখানে অংশীদাররা ক্রমাগত আপডেট করা জিপ ফাইলগুলি সরবরাহ করতে পারে যখন এতে থাকা তথ্য পরিবর্তন হয়। উদাহরণস্বরূপ, একজন অংশীদার স্টপের তালিকা প্রসারিত করে প্রদত্ত ইনভেন্টরি প্রসারিত করতে পারে। যাইহোক, GTFS এর মত, stop_ids স্থিতিশীল হওয়া উচিত।
বাজার সেট ফিড স্পেসিফিকেশন (ঐচ্ছিক)
ম্যাপ করা স্টপগুলির সাথে, আমরা এই ইন্টিগ্রেশনের জন্য বাজার সেট তৈরি করি (জনপ্রিয় উত্স / গন্তব্য জোড়া ধারণকারী একটি তালিকা)। সেখান থেকে, আপনার কাছে একটি বাজার সেট ফিড প্রমাণ করে বাজারের এই সেটটি হ্রাস করার বিকল্প রয়েছে।
বাজার সেট একটি অনুমোদিত তালিকা হিসাবে কাজ করে: যদি কোন বাজার সেট প্রদান না করা হয়, সমস্ত বাজার একীকরণে সক্ষম করা হয়। যদি একটি বাজার সেট প্রদান করা হয়, তালিকায় নেই এমন কোনো বাজার অক্ষম করা হয়।
মার্কেট সেট ফাইলে নিম্নলিখিত কলাম থাকা উচিত:
ক্ষেত্রের নাম | প্রকার ( GTFS দেখুন) | বর্ণনা |
---|---|---|
origin_stop_id | আইডি (প্রয়োজনীয়) | বাজারের মূল stop_id । |
destination_stop_id | আইডি (প্রয়োজনীয়) | বাজারের গন্তব্য stop_id . |
অংশীদার কনফিগারেশন
স্টপ-অনলি ইন্টিগ্রেশন ব্যবহার করার সময়, অংশীদার কনফিগারেশন বিভাগে বর্ণিত স্ট্যাটিক অংশীদার কনফিগারেশনের জন্য আমাদের অতিরিক্ত তথ্যের প্রয়োজন হয়।
টিকেট গভীর লিঙ্ক
একটি গভীর লিঙ্কের বিন্যাস এবং পরামিতিগুলি টিকিটিং লিঙ্কগুলিতে সংজ্ঞায়িত করা হয়েছে৷
অংশীদার API পরামিতি
অংশীদার API ( GetBulkTripOptionsRequest ) এর জন্য SegmentKeys প্যারামিটারগুলি গভীর লিঙ্কের স্পেসিফিকেশনের উপর ভিত্তি করে। আমরা সেগমেন্টকি ব্যবহার করি শুধুমাত্র from_ticketing_stop_time_id
, to_ticketing_stop_time_id
, service_date
, boarding_time
এবং arrival_time
, ticketing_trip_id
খালি রেখে। আমরা প্রতি সেগমেন্টে একটি করে একাধিক সেগমেন্টকি উল্লেখ করে সমস্ত স্থানান্তর সহ রুটটি সম্পূর্ণরূপে নির্দিষ্ট করব।