This guide explains how to integrate with Google to provide users a seamless transport search experience on various Google surfaces, including Google Maps and Google Search. At a high level, the main integration specifications include:
- স্ট্যাটিক ডেটা প্রদানের জন্য দুটি বিকল্প:
- GTFS-ভিত্তিক ইন্টিগ্রেশন : টিকিটিং এক্সটেনশন সহ একটি GTFS ফিড প্রদান করা, যেখানে আপনি সময়সূচী ডেটা সরবরাহকারী। GTFS-ভিত্তিক ইন্টিগ্রেশনের জন্য আমাদের কিছু অতিরিক্ত প্রয়োজনীয়তা রয়েছে।
- শুধুমাত্র স্টপ-ইনটিগ্রেশন : শুধুমাত্র স্টপগুলির একটি তালিকা প্রদান করা হচ্ছে, যেখানে গুগল ইতিমধ্যেই অন্য উৎস থেকে সময়সূচী ডেটা পেয়েছে।
- গতিশীল ডেটা প্রদানের জন্য একটি অংশীদার API স্পেসিফিকেশন:
- অংশীদার কনফিগারেশন : ব্র্যান্ডিং এবং যোগাযোগের বিবরণের মতো অংশীদার তথ্য প্রদান করা।
- পার্টনার সার্ভার : পার্টনার সার্ভার API সমর্থন করে এমন সার্ভার বাস্তবায়ন করা।
ভ্রমণ পরিবহনের সাথে একীভূত করার পদক্ষেপ
গুগলের পরিবহন বৈশিষ্ট্যগুলিকে সমর্থন করার জন্য একটি এন্ড-টু-এন্ড সিস্টেম তৈরি এবং পরীক্ষা করার জন্য প্রয়োজনীয় পদক্ষেপগুলির একটি সারসংক্ষেপ নীচে দেওয়া হল। ইন্টিগ্রেশনের তিনটি প্রধান ধাপ রয়েছে:
- অংশগ্রহণের প্রয়োজনীয়তা পর্যালোচনা করা।
- গুগলকে স্ট্যাটিক ডেটার একটি ফিড প্রদান করা।
- মূল্য এবং প্রাপ্যতার মতো দ্রুত পরিবর্তনশীল ডেটার গতিশীল অনুসন্ধান সক্ষম করার জন্য ট্র্যাভেল ট্রান্সপোর্ট এপিআই সমর্থন করে। এপিআই ধাপ ১ থেকে স্ট্যাটিক ডেটা ফিড দ্বারা প্রদত্ত শনাক্তকারী ব্যবহার করে, উদাহরণস্বরূপ
ticketing_stop_idস্টপগুলি সনাক্ত করতে।
১. অংশগ্রহণের প্রয়োজনীয়তা
গুগলের পরিবহন বৈশিষ্ট্য ইউনিট ভ্রমণপথ এবং বুকিং বিকল্পগুলি মূল্য সহ প্রদর্শন করে। তালিকায় আপনার অফারটি প্রদর্শনের জন্য, একটি ভাল মানের লিঙ্ক এবং একটি মিলিত চূড়ান্ত মূল্য আশা করা হচ্ছে। আরও বিস্তারিত জানার জন্য, আমাদের অংশগ্রহণের প্রয়োজনীয়তাগুলি পর্যালোচনা করুন।
2. স্ট্যাটিক ডেটার একটি ফিড প্রদান করা
স্ট্যাটিক ডেটা প্রদানের জন্য দুটি বিকল্প রয়েছে, প্রতিটি নির্দিষ্ট পরিস্থিতিতে প্রযোজ্য। কোন বিকল্পটি ব্যবহার করবেন তা নির্ধারণের প্রধান মানদণ্ড হল আপনি যে ট্রানজিট সংযোগগুলির জন্য বুকিং কার্যকারিতা অফার করতে চান তার সময়সূচী ডেটা সরবরাহকারী কিনা। গুগলের কাছে ইতিমধ্যেই সময়সূচী ডেটা আছে কিনা তা পরীক্ষা করার সবচেয়ে সহজ উপায় হল গুগল ম্যাপে একটি নির্দিষ্ট অপারেটরের জন্য সংযোগ খুঁজে বের করার চেষ্টা করা।
| বৈশিষ্ট্য | GTFS-ভিত্তিক ইন্টিগ্রেশন | স্টপ-ওনলি ইন্টিগ্রেশন |
|---|---|---|
| ব্যবহারের ধরণ | আপনি ইতিমধ্যেই GTFS-কে সময়সূচী এবং টিকিটের তথ্য প্রদান করেছেন। | গুগলের কাছে ইতিমধ্যেই অন্য উৎস থেকে অপারেটরের সময়সূচীর তথ্য রয়েছে। |
| প্রয়োজনীয় তথ্য | GTFS আইডি। | আপনার স্টপ আইডিগুলির একটি তালিকা, তাদের জিও স্থানাঙ্ক সহ। |
| প্রচেষ্টা | কম | মাঝারি |
যদি আপনি কোনও অপারেটরের জন্য GTFS ফিডের সরবরাহকারী হন তবে বিকল্প ১ প্রযোজ্য। এই ক্ষেত্রে, আপনাকে প্রথমে Google-এর জন্য সময়সূচী তথ্য সরবরাহ করার জন্য একটি GTFS ফিড সেটআপ করতে হবে। তারপর GTFS-ভিত্তিক ইন্টিগ্রেশন বিভাগে নির্দেশাবলী অনুসরণ করুন।
যদি Google ইতিমধ্যেই অন্য কোনও উৎস থেকে অপারেটরের জন্য সময়সূচীর ডেটা পেয়ে থাকে, তাহলে বিকল্প ২ প্রযোজ্য। এই ক্ষেত্রে, আমাদের সম্পূর্ণ সময়সূচীর তথ্যের প্রয়োজন নেই, তবে আমাদের এখনও আপনার স্টপ আইডিগুলির একটি তালিকা প্রয়োজন যা আমরা ট্র্যাভেল ট্রান্সপোর্ট API-তে ব্যবহার করতে পারি (নীচে দেখুন)। স্টপগুলির তালিকা প্রদান করতে স্টপ-অনলি ইন্টিগ্রেশন বিভাগের নির্দেশাবলী অনুসরণ করুন।
৩. ভ্রমণ পরিবহন API সমর্থন করা
ট্রান্সপোর্ট ইউনিটে দাম সহ বুকিং পার্টনার হিসেবে তালিকাভুক্ত হতে হলে, Google-কে পার্টনারদের কাছ থেকে সর্বশেষ মূল্য এবং প্রাপ্যতা তথ্য সংগ্রহ করতে সক্ষম হতে হবে। এটি সক্ষম করার জন্য, পার্টনারদের এমন একটি পরিষেবা প্রদান করতে হবে যা পার্টনার সার্ভার API গুলি বাস্তবায়ন করে।
৩.১. পার্টনার সার্ভার API বাস্তবায়ন করা
পার্টনার সার্ভার API কীভাবে বাস্তবায়ন করবেন তার বিশদ বিবরণ API রেফারেন্স এবং পার্টনার সার্ভার গাইডে পাওয়া যাবে। API Google-কে পার্টনারদের কাছ থেকে সবচেয়ে হালনাগাদ মূল্য এবং প্রাপ্যতা সম্পর্কিত তথ্য পেতে দেয় এবং Google-এর পক্ষ থেকে নিম্নলিখিত বিষয়গুলিতে ডাকা হবে:
- দ্রুত দাম ফেরত দেওয়ার জন্য একটি ক্যাশে তৈরি করুন।
- কোনও ব্যবহারকারী যখন কোনও নির্দিষ্ট তারিখে এমন কোনও রুট অনুসন্ধান করেন যেখানে আমাদের ক্যাশে কোনও মূল্য ছাড়াই ভ্রমণপথ দেখানো হয়, তখন সর্বশেষ মূল্য পান।
যদি পার্টনার চান যে দাম Google-এর মাধ্যমে প্রকাশ করা হোক, তাহলে পার্টনার সার্ভার API বাস্তবায়ন করা আবশ্যক।
৩.২. API যাচাইকরণ এবং পরীক্ষা
আপনার API বাস্তবায়ন প্রায় শেষ হয়ে গেলে এবং এটি বাস্তবায়নকারী পরিষেবাটি চালু হয়ে গেলে, সার্ভারের তথ্য সহ transport-help@google.com এ যোগাযোগ করুন যাতে আমরা আপনার বাস্তবায়ন যাচাই শুরু করতে পারি।
ভবিষ্যতে, আমরা আপনার API বাস্তবায়ন যাচাই করার জন্য স্বয়ংক্রিয় টুলিং অফার করার পরিকল্পনা করছি, কিন্তু এটি এখনও উপলব্ধ নয়।