คู่มือนี้อธิบายวิธีผสานรวมกับ Google เพื่อมอบประสบการณ์การค้นหาการเดินทางที่ราบรื่นให้แก่ผู้ใช้ในแพลตฟอร์มต่างๆ ของ Google ซึ่งรวมถึง Google Maps และ Google Search ในระดับสูง ข้อกำหนดการผสานรวมหลักๆ มีดังนี้
- คุณมี 2 ตัวเลือกในการระบุข้อมูลแบบคงที่ ดังนี้
- การผสานรวมที่อิงตาม GTFS: การระบุฟีด GTFS ที่มีส่วนขยายการจำหน่ายตั๋ว ในกรณีที่คุณเป็น ผู้ให้บริการข้อมูลตารางเวลา เรามี ข้อกำหนด เพิ่มเติมสำหรับการผสานรวมที่อิงตาม GTFS
- การผสานรวมแบบหยุดเท่านั้น: การระบุเพียงรายชื่อป้ายหยุด สำหรับกรณีที่ Google มีข้อมูลตารางเวลาจากแหล่งที่มาอื่นอยู่แล้ว
- ข้อกำหนด Partner API สำหรับการระบุข้อมูลแบบไดนามิก
- การกำหนดค่าพาร์ทเนอร์: การให้ข้อมูลพาร์ทเนอร์ เช่น การสร้างแบรนด์และรายละเอียดการติดต่อ
- เซิร์ฟเวอร์ พาร์ทเนอร์: การติดตั้งใช้งานเซิร์ฟเวอร์ที่รองรับ Partner Server APIs
ขั้นตอนการผสานรวมกับ Travel Transport
ต่อไปนี้เป็นภาพรวมของขั้นตอนที่จำเป็นในการสร้างและทดสอบระบบแบบครบวงจรเพื่อรองรับฟีเจอร์การเดินทางของ Google การผสานรวมมี 3 ขั้นตอนหลักๆ ดังนี้
- ตรวจสอบข้อกำหนด ในการเข้าร่วม
- การจัดเตรียมฟีดข้อมูลแบบคงที่ให้ Google
- รองรับ Travel Transport API เพื่อเปิดใช้การค้นหาแบบไดนามิกของข้อมูลที่มีการเปลี่ยนแปลงอย่างรวดเร็ว เช่น ราคาและความพร้อมให้บริการ API ใช้ตัวระบุที่ฟีดข้อมูลแบบคงที่จากขั้นตอนที่ 1 ระบุ เช่น
ticketing_stop_id
เพื่อระบุป้ายรถเมล์
1. ข้อกำหนดในการเข้าร่วม
หน่วยฟีเจอร์การเดินทางของ Google จะแสดงแผนการเดินทางและตัวเลือกการจองพร้อม ราคา หากต้องการแสดงข้อเสนอในรายการ คุณต้องมีลิงก์คุณภาพดีและราคา สุดท้ายที่ตรงกัน ดูรายละเอียดเพิ่มเติมได้ที่ข้อกำหนด ในการเข้าร่วม
2. การระบุฟีดข้อมูลแบบคงที่
คุณให้ข้อมูลแบบคงที่ได้ 2 วิธี โดยแต่ละวิธีจะใช้ได้ในบางกรณี เกณฑ์หลักในการตัดสินใจว่าจะใช้ตัวเลือกใดคือคุณเป็นผู้ให้บริการข้อมูลตารางเวลาสำหรับการเชื่อมต่อระบบขนส่งที่คุณต้องการเสนอฟังก์ชันการจองหรือไม่ วิธีที่ง่ายที่สุดในการตรวจสอบว่า Google มีข้อมูลตารางเวลาอยู่แล้วหรือไม่ คือการลองค้นหาการเชื่อมต่อสำหรับผู้ให้บริการรายใดรายหนึ่งใน Google Maps
ฟีเจอร์ | การผสานรวมที่อิงตาม GTFS | การผสานรวมแบบหยุดเท่านั้น |
---|---|---|
กรณีการใช้งาน | คุณระบุ GTFS พร้อมข้อมูลตารางเวลาและการจำหน่ายตั๋วอยู่แล้ว | Google มีข้อมูลตารางเวลาของผู้ให้บริการจากแหล่งที่มาอื่นอยู่แล้ว |
ข้อมูลที่จำเป็น | รหัส GTFS | รายการรหัสป้ายรถเมล์พร้อมพิกัดทางภูมิศาสตร์ |
ความพยายาม | ต่ำ | ปานกลาง |
ตัวเลือกที่ 1 จะใช้ได้ในกรณีที่คุณเป็นผู้ให้บริการฟีด GTFS สำหรับผู้ให้บริการ ในกรณีนี้ คุณต้องตั้งค่าฟีด GTFS เพื่อระบุข้อมูลตารางเวลาให้ Google ก่อนด้วย จากนั้นทำตามวิธีการในส่วนการผสานรวมที่อิงตาม GTFS
ตัวเลือกที่ 2 จะใช้ได้ในกรณีที่ Google ได้รับข้อมูลตารางเวลาสำหรับผู้ให้บริการจากแหล่งที่มาอื่นอยู่แล้ว ในกรณีนี้ เราไม่จำเป็นต้องใช้ข้อมูลตารางเวลาทั้งหมด แต่ยังคงต้องใช้รายการรหัสป้ายหยุดรถที่คุณใช้ใน Travel Transport API (ดูด้านล่าง) ได้ หากต้องการระบุรายการป้ายจอดรถ ให้ทำตาม วิธีการในส่วนการผสานรวมป้ายจอดรถเท่านั้น
3. การรองรับ Travel Transport API
หากต้องการแสดงเป็นพาร์ทเนอร์การจองที่มีราคาในหน่วยการเดินทาง Google ต้องดึงข้อมูลราคาและความพร้อมให้บริการล่าสุดจาก พาร์ทเนอร์ได้ หากต้องการเปิดใช้ฟีเจอร์นี้ พาร์ทเนอร์จะต้องให้บริการที่ ใช้ API ของเซิร์ฟเวอร์พาร์ทเนอร์
3.1 การติดตั้งใช้งาน Partner Server API
ดูรายละเอียดเกี่ยวกับวิธีติดตั้งใช้งาน Partner Server API ได้ในการอ้างอิง API และในคู่มือเซิร์ฟเวอร์พาร์ทเนอร์ API ช่วยให้ Google ได้รับข้อมูลราคาและความพร้อมจำหน่ายสินค้าล่าสุด จากพาร์ทเนอร์ และ Google จะเรียกใช้ API เพื่อดำเนินการต่อไปนี้
- สร้างแคชสำหรับราคาที่กลับมาอย่างรวดเร็ว
- ดูราคาล่าสุดเมื่อผู้ใช้คลิกเข้าไปดูแผนการเดินทางที่เฉพาะเจาะจง
คุณต้องใช้ Partner Server API หากต้องการให้ Google แสดงราคา
3.2 การตรวจสอบและการทดสอบ API
เมื่อการติดตั้งใช้งาน API ใกล้เสร็จสมบูรณ์และบริการที่ติดตั้งใช้งาน API พร้อมใช้งานแล้ว โปรดติดต่อ transport-help@google.com พร้อมข้อมูลเซิร์ฟเวอร์ เพื่อให้เราเริ่มตรวจสอบการติดตั้งใช้งานได้
ในอนาคตเราวางแผนที่จะนำเสนอเครื่องมืออัตโนมัติสำหรับการตรวจสอบการติดตั้งใช้งาน API แต่ยังไม่พร้อมให้บริการในตอนนี้