এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে ব্যবহারকারীদের Google মানচিত্র এবং Google অনুসন্ধান সহ বিভিন্ন Google পৃষ্ঠে নির্বিঘ্ন পরিবহন অনুসন্ধানের অভিজ্ঞতা প্রদান করতে Google-এর সাথে একীভূত করা যায়। একটি উচ্চ স্তরে, প্রধান ইন্টিগ্রেশন স্পেসিফিকেশন অন্তর্ভুক্ত:
- স্ট্যাটিক ডেটা প্রদানের জন্য দুটি বিকল্প:
- GTFS-ভিত্তিক ইন্টিগ্রেশন : টিকিটিং এক্সটেনশন সহ একটি GTFS ফিড প্রদান করা, যেখানে আপনি সময়সূচী ডেটা প্রদানকারী। GTFS-ভিত্তিক ইন্টিগ্রেশনের জন্য আমাদের কিছু অতিরিক্ত প্রয়োজনীয়তা রয়েছে।
- স্টপ-অনলি ইন্টিগ্রেশন : শুধুমাত্র স্টপের একটি তালিকা প্রদান করা, এমন ক্ষেত্রে যেখানে Google এর কাছে ইতিমধ্যেই অন্য উৎস থেকে নির্ধারিত ডেটা রয়েছে।
- গতিশীল ডেটা প্রদানের জন্য একটি অংশীদার API স্পেসিফিকেশন:
- অংশীদার কনফিগারেশন : ব্র্যান্ডিং এবং যোগাযোগের বিবরণের মতো অংশীদারের তথ্য প্রদান করা।
- অংশীদার সার্ভার : অংশীদার সার্ভার API সমর্থন করে এমন সার্ভার বাস্তবায়ন করা।
ট্রাভেল ট্রান্সপোর্টের সাথে একীভূত করার পদক্ষেপ
Google-এর পরিবহন বৈশিষ্ট্যগুলিকে সমর্থন করার জন্য একটি এন্ড-টু-এন্ড সিস্টেম তৈরি এবং পরীক্ষা করার জন্য প্রয়োজনীয় পদক্ষেপগুলির একটি সংক্ষিপ্ত বিবরণ নীচে দেওয়া হল৷ ইন্টিগ্রেশনের তিনটি প্রধান ধাপ রয়েছে:
- অংশগ্রহণের প্রয়োজনীয়তা পর্যালোচনা করা হচ্ছে।
- Google-এ স্ট্যাটিক ডেটার একটি ফিড প্রদান করা।
- ট্রাভেল ট্রান্সপোর্ট API-কে সমর্থন করে দাম এবং প্রাপ্যতার মতো দ্রুত পরিবর্তনশীল ডেটার গতিশীল প্রশ্নগুলি সক্ষম করতে। API ধাপ 1 থেকে স্ট্যাটিক ডেটা ফিড দ্বারা প্রদত্ত শনাক্তকারী ব্যবহার করে, উদাহরণস্বরূপ স্টপ শনাক্ত করার জন্য
ticketing_stop_id।
1. অংশগ্রহণের প্রয়োজনীয়তা
Google-এর ট্রান্সপোর্ট ফিচার ইউনিট মূল্য সহ ভ্রমণপথ এবং বুকিং বিকল্পগুলি প্রদর্শন করে৷ তালিকায় আপনার অফার প্রদর্শন করার জন্য, একটি ভাল মানের লিঙ্ক এবং একটি ম্যাচিং চূড়ান্ত মূল্য প্রত্যাশিত৷ আরো বিস্তারিত জানার জন্য, আমাদের অংশগ্রহণের প্রয়োজনীয়তা পর্যালোচনা করুন।
2. স্ট্যাটিক ডেটার একটি ফিড প্রদান করা
স্ট্যাটিক ডেটা প্রদানের জন্য দুটি বিকল্প রয়েছে, প্রতিটি নির্দিষ্ট পরিস্থিতিতে প্রযোজ্য। আপনি যে ট্রানজিট সংযোগগুলির জন্য বুকিং কার্যকারিতা অফার করতে চান তার জন্য আপনি সময়সূচী ডেটা সরবরাহকারী কিনা তা সিদ্ধান্ত নেওয়ার প্রধান মানদণ্ড কোন বিকল্পটি ব্যবহার করবেন৷ Google-এর কাছে ইতিমধ্যেই সময়সূচী ডেটা আছে কিনা তা পরীক্ষা করার সবচেয়ে সহজ উপায় হল Google Maps-এ একটি নির্দিষ্ট অপারেটরের সংযোগ খোঁজার চেষ্টা করা৷
| বৈশিষ্ট্য | GTFS-ভিত্তিক ইন্টিগ্রেশন | স্টপ-ওনলি ইন্টিগ্রেশন |
|---|---|---|
| কেস ব্যবহার করুন | আপনি ইতিমধ্যেই সময়সূচী এবং টিকিটের তথ্য সহ GTFS প্রদান করেছেন। | Google এর কাছে ইতিমধ্যেই অন্য উত্স থেকে অপারেটরের জন্য সময়সূচী ডেটা রয়েছে৷ |
| প্রয়োজনীয় তথ্য | জিটিএফএস আইডি। | আপনার স্টপ আইডিগুলির একটি তালিকা, তাদের জিও স্থানাঙ্ক সহ। |
| প্রচেষ্টা | কম | মাঝারি |
আপনি যদি অপারেটরের জন্য GTFS ফিড প্রদানকারী হন তাহলে বিকল্প 1 প্রযোজ্য। এই ক্ষেত্রে, প্রথমে Google-এর জন্য সময়সূচী তথ্য সরবরাহ করার জন্য আপনাকে একটি GTFS ফিড সেটআপ করতে হবে। তারপর GTFS-ভিত্তিক ইন্টিগ্রেশন বিভাগে নির্দেশাবলী অনুসরণ করুন।
বিকল্প 2 প্রযোজ্য যদি Google ইতিমধ্যেই একটি ভিন্ন উৎস থেকে অপারেটরের জন্য সময়সূচী ডেটা পায়। এই ক্ষেত্রে, আমাদের সম্পূর্ণ সময়সূচীর তথ্যের প্রয়োজন নেই, তবে আমাদের এখনও আপনার স্টপ আইডিগুলির একটি তালিকা প্রয়োজন যা আমরা ট্রাভেল ট্রান্সপোর্ট API (নীচে দেখুন) ব্যবহার করতে পারি। স্টপের তালিকা প্রদান করতে শুধুমাত্র-স্টপ ইন্টিগ্রেশন বিভাগে নির্দেশাবলী অনুসরণ করুন।
3. ট্রাভেল ট্রান্সপোর্ট API-কে সমর্থন করা
ট্রান্সপোর্ট ইউনিটে দামের সাথে বুকিং পার্টনার হিসেবে তালিকাভুক্ত হতে, Google-কে অংশীদারদের কাছ থেকে সাম্প্রতিক মূল্য এবং উপলব্ধতার তথ্য আনতে সক্ষম হতে হবে। এটি সক্ষম করার জন্য, অংশীদারদের একটি পরিষেবা প্রদান করতে হবে যা অংশীদার সার্ভার APIs প্রয়োগ করে৷
3.1। পার্টনার সার্ভার এপিআই বাস্তবায়ন করা
পার্টনার সার্ভার এপিআই কীভাবে বাস্তবায়ন করবেন তার বিশদ বিবরণ API রেফারেন্স এবং অংশীদার সার্ভার গাইডে পাওয়া যাবে। এপিআই Google-কে অংশীদারদের কাছ থেকে সবচেয়ে আপ-টু-ডেট মূল্য এবং প্রাপ্যতার তথ্য পেতে দেয় এবং Google এর দ্বারা কল করবে:
- দ্রুত দাম ফেরত দেওয়ার জন্য একটি ক্যাশে তৈরি করুন।
- একজন ব্যবহারকারী একটি নির্দিষ্ট ভ্রমণপথে ক্লিক করলে সর্বশেষ মূল্য পান।
পার্টনার সার্ভার API প্রয়োগ করা প্রয়োজন যদি অংশীদার Google-এর দ্বারা মূল্য প্রকাশ করতে চায়।
3.2। API যাচাইকরণ এবং পরীক্ষা
একবার আপনার API বাস্তবায়ন সমাপ্তির কাছাকাছি হয়ে গেলে এবং এটিকে বাস্তবায়নকারী পরিষেবাটি চালু হয়ে গেলে, দয়া করে সার্ভারের তথ্য সহ transport-help@google.com- এর সাথে যোগাযোগ করুন যাতে আমরা আপনার বাস্তবায়ন যাচাই করা শুরু করতে পারি।
ভবিষ্যতে, আমরা আপনার API বাস্তবায়ন যাচাই করার জন্য স্বয়ংক্রিয় টুলিং অফার করার পরিকল্পনা করছি, কিন্তু এটি এখনও উপলব্ধ নয়।