ภาพรวม
หากคุณไม่ใช่ผู้ให้บริการฟีด GTFS สำหรับ Google Maps การผสานรวมของคุณจะเป็นป้ายจอดรถเท่านั้น ในการผสานรวมนี้ เราจำเป็นต้องทำความเข้าใจวิธีที่คุณระบุป้ายรถเมล์หรือรถไฟต่างๆ
ข้อกำหนดทั่วไปของฟีด
เมื่อเริ่มการผสานรวม เราจะสร้างตัวระบุที่ไม่ซ้ำกันสำหรับการผสานรวมแต่ละรายการ เช่น ch_google_test (รหัสประเทศ ชื่อพาร์ทเนอร์ การผสานรวม) หรือ eu_google (รหัสภูมิภาค ชื่อพาร์ทเนอร์)
พาร์ทเนอร์สามารถส่งไฟล์ ZIP ที่มีไฟล์ข้อความในรูปแบบ CSV ซึ่งมีผลทั่วโลกหรือตามการผสานรวม
ตัวอย่างที่ 1
- ch_google_test_stops.txt
- ch_google_test_markets.txt
ตัวอย่างที่ 2
- stops.txt (ใช้กับการผสานรวมทั้งหมด)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
ข้อกำหนดฟีดสิ้นสุด (ต้องระบุ)
ไฟล์หยุดควรมีคอลัมน์ต่อไปนี้
| ชื่อช่อง | ประเภท (ดู GTFS) | คำอธิบาย |
|---|---|---|
stop_id |
รหัส (ต้องระบุ) | ตัวระบุที่ไม่ซ้ำกันซึ่งระบุป้ายจอดรถหรือสถานี สถานีขนาดใหญ่ควรมีรายการเดียวเท่านั้น ข้อมูลนี้ใช้เมื่อเรียกใช้ Partner Server API และใน Deep Link สำหรับการจองตั๋ว |
stop_name |
ข้อความ (ต้องระบุ) | ชื่อที่อ่านออกได้สำหรับการแก้ไขข้อบกพร่องการหยุดการแมป การคลายแคช และข้อมูลความถูกต้องของราคา |
stop_lat |
ละติจูด (ต้องระบุ) | ละติจูดของป้ายจอดรถ |
stop_lon |
ลองจิจูด (ต้องระบุ) | ลองจิจูดของป้ายจอดรถ |
เราจะใช้กระบวนการนำเข้าอัตโนมัติที่พาร์ทเนอร์สามารถส่งไฟล์ ZIP ที่อัปเดตอย่างต่อเนื่องได้เมื่อมีการเปลี่ยนแปลงข้อมูลในไฟล์ เช่น พาร์ทเนอร์อาจขยายพื้นที่โฆษณาที่ระบุโดยเพิ่มรายการจุดจอด อย่างไรก็ตาม stop_ids ควรมีการเปลี่ยนแปลงน้อยมากเช่นเดียวกับ GTFS
ข้อกำหนดฟีดชุดตลาด (ไม่บังคับ)
เมื่อจับคู่ป้ายจอดรถแล้ว เราจะสร้างชุดตลาดสำหรับการผสานรวมนี้ (รายการที่มีคู่ต้นทาง / ปลายทางยอดนิยม) จากตรงนั้น คุณจะมีตัวเลือกในการลดจำนวนตลาดชุดนี้โดยการส่งฟีดชุดตลาด
ชุดตลาดจะทําหน้าที่เป็นรายการที่อนุญาต หากไม่ได้ระบุชุดตลาด ระบบจะเปิดใช้ตลาดทั้งหมดในการผสานรวม หากระบุชุดตลาดไว้ ระบบจะปิดใช้ตลาดที่ไม่ได้อยู่ในรายการ
ไฟล์ชุดตลาดควรมีคอลัมน์ต่อไปนี้
| ชื่อช่อง | ประเภท (ดู GTFS) | คำอธิบาย |
|---|---|---|
origin_stop_id |
รหัส (ต้องระบุ) | stop_id ต้นทางของตลาด |
destination_stop_id |
รหัส (ต้องระบุ) | ปลายทาง stop_id ของตลาด |
การกำหนดค่าพาร์ทเนอร์
เมื่อใช้การผสานรวมแบบหยุดเท่านั้น เราต้องการข้อมูลเพิ่มเติมสำหรับการกําหนดค่าพาร์ทเนอร์แบบคงที่ตามที่ระบุไว้ในส่วนการกําหนดค่าพาร์ทเนอร์
Deep Link สำหรับการซื้อตั๋ว
รูปแบบและพารามิเตอร์ของ Deep 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 รายการต่อกลุ่ม