ภาพรวม
หากคุณไม่ใช่ผู้ให้บริการฟีด GTFS สำหรับ Google Maps การผสานรวมของคุณจะเป็นแบบหยุดเท่านั้น สำหรับการผสานรวมนี้ เราจำเป็นต้องทราบวิธีที่คุณระบุ ป้ายรถไฟหรือป้ายรถประจำทางต่างๆ
ข้อกำหนดทั่วไปของฟีด
เมื่อเริ่มการผสานรวม เราจะสร้างตัวระบุที่ไม่ซ้ำกันสำหรับการผสานรวมแต่ละรายการ เช่น ch_google_test (รหัสประเทศ ชื่อพาร์ทเนอร์ การผสานรวม) หรือ eu_google (รหัสภูมิภาค ชื่อพาร์ทเนอร์)
พาร์ทเนอร์จะระบุไฟล์ที่มีไฟล์ข้อความในรูปแบบ CSV ซึ่งใช้กับการผสานรวมแต่ละรายการ ไฟล์ CSV แต่ละไฟล์ต้องมีแถวส่วนหัวที่มีชื่อคอลัมน์ซึ่ง ตรงกับ "ชื่อฟิลด์" ที่ระบุไว้ในตารางข้อกำหนดของฟีดที่เกี่ยวข้อง
หากต้องการอนุญาตให้พาร์ทเนอร์อัปโหลดไฟล์ป้ายหยุดรถและไฟล์ตลาดเวอร์ชันใหม่ ทีมของเรา จะแชร์รายละเอียดดรอปบ็อกซ์ SFTP สำหรับไฟล์แต่ละประเภทในระหว่างกระบวนการ เริ่มต้นใช้งาน
ข้อกำหนดฟีดป้ายหยุดรถ (ต้องระบุ)
ไฟล์หยุดควรมีคอลัมน์ต่อไปนี้
| ชื่อช่อง | ประเภท (ดู GTFS) | คำอธิบาย |
|---|---|---|
stop_id |
รหัส (ต้องระบุ) | ตัวระบุที่ไม่ซ้ำกันซึ่งระบุป้ายจอดรถหรือสถานี สถานีขนาดใหญ่ควรมีรายการเดียวเท่านั้น ใช้เมื่อทำการเรียก API ของเซิร์ฟเวอร์พาร์ทเนอร์และใน Deep Link ของการออกตั๋ว |
stop_name |
ข้อความ (ต้องระบุ) | ชื่อที่มนุษย์อ่านได้สำหรับการแก้ไขข้อบกพร่องในการแมปป้ายหยุดรถ การเติมแคช และข้อมูลความถูกต้องของราคา |
stop_lat |
ละติจูด (ต้องระบุ) | ละติจูดของป้ายจอดรถ |
stop_lon |
ลองจิจูด (ต้องระบุ) | ลองจิจูดของป้ายจอดรถ |
เราจะใช้กระบวนการนำเข้าอัตโนมัติที่พาร์ทเนอร์สามารถให้ไฟล์ ZIP ที่อัปเดตได้อย่างต่อเนื่อง เมื่อข้อมูลที่มีการเปลี่ยนแปลง ตัวอย่างเช่น พาร์ทเนอร์อาจขยายพื้นที่โฆษณาที่ระบุโดยการขยายรายการจุดจอด อย่างไรก็ตาม stop_ids ควรมีความเสถียรเช่นเดียวกับ GTFS
ข้อกำหนดฟีดชุดตลาด (ไม่บังคับ)
เมื่อมีป้ายที่แมปแล้ว เราจะสร้างชุดตลาดสำหรับการผสานรวมนี้ (รายการที่มีคู่ต้นทาง / ปลายทางยอดนิยม) จากนั้นคุณจะมีตัวเลือก ในการลดชุดตลาดนี้โดยการระบุฟีดชุดตลาด
ชุดตลาดทำหน้าที่เป็นรายการที่อนุญาตสำหรับบริการการเติมแคชของเรา โดยค่าเริ่มต้น หากไม่ได้ระบุชุดตลาด ระบบจะเปิดใช้ทุกตลาด หากคุณระบุชุดตลาด ระบบจะค้นหาเฉพาะตลาดที่รวมอยู่ในรายการ หากผู้ใช้ค้นหาตลาดที่อยู่นอกรายการที่อนุญาตนี้ ระบบของเราจะยังคงส่งการค้นหาแบบเรียลไทม์สำหรับตลาดและวันที่ที่เฉพาะเจาะจงที่ขอ แต่เราจะไม่พยายามแคชข้อมูลดังกล่าวล่วงหน้า
ไฟล์ชุดตลาดควรมีคอลัมน์ต่อไปนี้
| ชื่อช่อง | ประเภท (ดู GTFS) | คำอธิบาย |
|---|---|---|
origin_stop_id |
รหัส (ต้องระบุ) | ต้นทางstop_idของตลาด |
destination_stop_id |
รหัส (ต้องระบุ) | stop_idปลายทางของตลาด |
การกำหนดค่าพาร์ทเนอร์
เมื่อใช้การผสานรวมแบบหยุดเท่านั้น เราจะขอข้อมูลเพิ่มเติมสำหรับการกำหนดค่าพาร์ทเนอร์แบบคงที่ตามที่ระบุไว้ในส่วนการกำหนดค่าพาร์ทเนอร์
ข้อกำหนดของลิงก์สำหรับแนะนำบอกต่อ
รูปแบบและพารามิเตอร์ของลิงก์การจอง (หรือที่เรียกว่า Ticketing link) มี
คำจำกัดความในลิงก์
การจำหน่ายตั๋ว
พารามิเตอร์ Partner API
พารามิเตอร์ SegmentKeys สำหรับ Partner API
(GetBulkTripOptionsRequest)
อิงตามข้อกำหนดของ Deep Link เราใช้
SegmentKeys ซึ่งรวมถึง
เฉพาะ from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date,
boarding_time และ arrival_time โดยปล่อยให้ ticketing_trip_id ว่างไว้ เราจะระบุเส้นทางทั้งหมด รวมถึงการเปลี่ยนเครื่องบินทั้งหมดโดยการระบุ
SegmentKey หลายรายการ โดยระบุ 1 รายการต่อ 1 ส่วน