รูปแบบลิงก์ค้นหา

สำหรับลิงก์การค้นหา พาร์ทเนอร์จะระบุ URL ฐานเฉพาะการค้นหา (ดูการกำหนดค่าพาร์ทเนอร์) เรารองรับพารามิเตอร์การค้นหาต่อไปนี้

ชื่อช่อง รายละเอียด
from_stop_id

(ทำซ้ำได้) ตัวระบุของป้ายที่การเดินทางอาจเริ่มต้น

ค่าของ stop_id ของสถานีต้นทาง
to_stop_id

(ซ้ำได้) ตัวระบุของป้ายที่การเดินทางอาจสิ้นสุด

ค่าของ stop_id ของสถานีปลายทาง
search_date

(วันที่) วันที่ให้บริการของการเดินทาง

ฟิลด์นี้มีวันที่ที่มีสตริงรูปแบบต่อไปนี้

YYYYMMDD
lang

(IETF BCP 47, ไม่บังคับ) ฟิลด์ที่ใช้เพื่อระบุภาษาที่เลือกของเว็บไซต์การจอง

ค่าของฟิลด์นี้เป็นไปตาม IETF BCP 47 เช่น en-US

หากภาษาที่เลือกไม่พร้อมใช้งานหรือไม่ได้ส่งฟิลด์ เว็บไซต์การจองควรใช้ภาษาสำรอง
cur

(ISO 4217, ไม่บังคับ) ฟิลด์ที่ใช้เพื่อระบุสกุลเงินที่ควรแสดงราคา

ค่าของฟิลด์นี้เป็นไปตาม ISO 4217 เช่น USD

หากแสดงสกุลเงินที่เลือกไม่ได้หรือไม่ได้ส่งฟิลด์ เว็บไซต์การจองควรใช้สกุลเงินสำรอง
utm_source

(สตริง ไม่บังคับ) ฟิลด์ที่ใช้ระบุเว็บไซต์ระดับสูงที่ส่งการเข้าชม

ค่าที่เป็นไปได้คือ google_search และ google_maps

พารามิเตอร์ที่ทำซ้ำได้ทั้งหมดจะระบุเป็นอาร์เรย์ JSON สำหรับ from_stop_id และ to_stop_id ค่าหลายค่าแสดงถึงสถานีหลายแห่งในต้นทาง และปลายทาง

ตัวอย่าง

ในตัวอย่างนี้ ผู้ใช้ค้นหารถไฟจาก locality1 ไปยัง locality2

  • locality1 แมปกับสถานีที่มี stop_id f1 และ f2
  • locality2 แมปกับสถานีที่มี stop_id t1 และ t2
  • วันที่รับบริการคือ 20190716

ในตัวอย่างนี้ URL ฐานคือ https://example.com

เมื่อพิจารณาข้อมูลทั้งหมดนี้ ให้ใช้ค่าต่อไปนี้สำหรับพารามิเตอร์

ชื่อช่อง รายละเอียด
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

ต่อไปนี้คือ URI สุดท้ายหลังจากการเข้ารหัส

https://example.com?from_stop_id=%5B%22f1%22,%22f2%22%5D&to_stop_id=%5B%22t1%22,%22t2%22%5D&search_date=20190716

ในหน้า Landing Page ผู้ใช้จะดูแผนการเดินทางที่ออกจากสถานี f1 และ f2 ในวันที่ 20190716 และเดินทางถึง t1 และ t2 ได้ ระบบรองรับการผสมสถานีทุกรูปแบบ ดังนี้

  • จาก f1 เป็น t1
  • จาก f1 เป็น t2
  • จาก f2 เป็น t1
  • จาก f2 เป็น t2