อภิธานศัพท์

อภิธานศัพท์นี้ให้คำจำกัดความของคำศัพท์สำคัญที่ใช้ในเอกสารประกอบการผสานรวมพาร์ทเนอร์การขนส่ง

โทเค็นการจอง: สตริงที่พาร์ทเนอร์สร้างขึ้นซึ่งไม่บังคับ และสามารถส่งใน Deep Link ของการจำหน่ายตั๋วเพื่อช่วยรักษาความสอดคล้องของราคาและแผนการเดินทางระหว่างผลการค้นหาของ Google กับหน้าการจองของพาร์ทเนอร์

การแมป JSON ที่เป็นมาตรฐาน: ชุดกฎที่เฉพาะเจาะจงซึ่งกำหนดโดย Protocol Buffers สำหรับการแปลงข้อความ Proto เป็นออบเจ็กต์ JSON การผสานรวมนี้ต้องใช้ การแมปนี้กับตัวเลือกที่เฉพาะเจาะจงเพื่อให้คำขอและการตอบกลับมีรูปแบบที่ถูกต้อง

GTFS (ข้อกำหนดทั่วไปของฟีดขนส่งสาธารณะ): รูปแบบข้อมูลมาตรฐานที่หน่วยงานขนส่งมวลชนใช้เพื่อระบุข้อมูลตารางเวลา เส้นทาง และค่าโดยสารแก่ผู้โดยสาร ในการผสานรวมนี้ การระบุข้อมูลแบบคงที่ให้แก่ Google เป็นหนึ่งใน 2 วิธี

การผสานรวมที่อิงตาม GTFS: วิธีการผสานรวมสำหรับพาร์ทเนอร์ที่ให้ข้อมูลตารางเวลาของตนเองแก่ Google ในฟีด GTFS ใช้ในกรณีที่ Google ยังไม่มีตารางเวลาของผู้ให้บริการ

known_itineraries: ตัวเลือกในการกำหนดค่าพาร์ทเนอร์ที่อนุญาตให้ พาร์ทเนอร์รับรายการแผนการเดินทางที่ทราบจาก Google เพื่อเพิ่มประสิทธิภาพ การตอบกลับ

ชุดตลาด: (สำหรับการผสานรวมแบบหยุดเท่านั้น) ฟีดที่ไม่บังคับซึ่งพาร์ทเนอร์ระบุเพื่อกำหนดรายการคู่ต้นทาง-ปลายทาง (ตลาด) ที่เฉพาะเจาะจงซึ่งพาร์ทเนอร์จะระบุราคาให้ หากระบุไว้ จะถือเป็นรายการที่อนุญาต

Partner API / Partner Server API: ชุด API ที่พาร์ทเนอร์ต้อง ใช้เพื่อระบุข้อมูลแบบไดนามิก เช่น ราคาแบบเรียลไทม์และ ห้องว่าง ให้กับ Google

การทดสอบคุณภาพราคา: กระบวนการที่ดำเนินการอย่างต่อเนื่องซึ่ง Crawler ของ Google จะสุ่มตัวอย่างแผนการเดินทางในเว็บไซต์ของพาร์ทเนอร์เพื่อยืนยันว่าราคาที่แสดงต่อผู้ใช้ตรงกับราคาที่ระบุผ่าน Partner API

QPS (คำค้นหาต่อวินาที): อัตราเฉลี่ยที่ Google ส่งคำขอ (การค้นหา 1 ครั้งคือคำขอ 1 รายการ) ไปยังเซิร์ฟเวอร์ API ของพาร์ทเนอร์ อัตรานี้อาจผันผวน โดยอาจมีการเข้าชมสูงหรือต่ำกว่าเล็กน้อย

SegmentKey: ออบเจ็กต์ที่ใช้ใน Partner API เพื่อระบุการเดินทางขาเดียว ที่ไม่ซ้ำกัน ซึ่งรวมถึงต้นทาง ปลายทาง และวันที่/เวลาของบริการ

service_date: วันที่ที่เฉพาะเจาะจงซึ่งบริการขนส่งดำเนินการ โดยจัดรูปแบบเป็น YYYYMMDD โดยใช้ร่วมกับตัวระบุอื่นๆ เพื่อ ระบุอินสแตนซ์การเดินทางที่ไม่ซ้ำ

การผสานรวมแบบหยุดเท่านั้น: วิธีการผสานรวมสำหรับพาร์ทเนอร์ที่ไม่ใช่แหล่งที่มาของข้อมูลตารางเวลา ใช้ในกรณีที่ Google ได้รับตารางเวลาของผู้ให้บริการจากแหล่งที่มาอื่นอยู่แล้ว พาร์ทเนอร์เพียงต้องระบุรายการ รหัสป้ายรถเมล์

ticketing_stop_id: ตัวระบุที่ไม่ซ้ำกันของพาร์ทเนอร์สำหรับป้ายจอดรถหรือสถานี รหัสนี้มีให้ในฟีดข้อมูลแบบคงที่ (GTFS หรือฟีดป้ายหยุดรถเท่านั้น) และใช้ใน Partner API และ Deep Link ของการจำหน่ายตั๋ว

ticketing_trip_id: (สำหรับการผสานรวมที่อิงตาม GTFS) ตัวระบุที่ไม่ซ้ำกันของพาร์ทเนอร์สำหรับ การเดินทางที่เฉพาะเจาะจง ซึ่งระบุไว้ในไฟล์ trips.txt ของฟีด GTFS การผสานรวมที่อิงตาม GTFS เท่านั้น

Deep Link ของการออกตั๋ว: URL ที่เปลี่ยนเส้นทางผู้ใช้จากผลการค้นหาของ Google ไปยังเว็บไซต์ของพาร์ทเนอร์เพื่อจองแผนการเดินทางที่เฉพาะเจาะจง URL มีรายละเอียดที่เข้ารหัส เกี่ยวกับการเดินทางที่เลือก

TripOptionsErrorType: ชุดประเภทข้อผิดพลาดที่เฉพาะเจาะจงซึ่งอาจแสดงผล ใน Partner API เพื่อให้ข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับสาเหตุที่คำขอ ไม่สำเร็จ

UNSPECIFIED ค่า Enum: ค่าแรกที่ต้องระบุ (มีค่าตัวเลขเป็น 0) ในคำจำกัดความ enum เมื่อใช้ Protocol Buffers โดยจะทำหน้าที่เป็นค่าเริ่มต้น และโดยทั่วไปควรถือว่าเป็นข้อผิดพลาดหากได้รับในคำขอ