รูปแบบลิงก์การจำหน่ายตั๋ว

สำหรับ Deep Link พาร์ทเนอร์จะระบุ URL ฐาน (ดูการกำหนดค่าพาร์ทเนอร์) พารามิเตอร์การค้นหาที่เราเพิ่มลงใน URL จะเป็นไปตาม ส่วนขยายการจำหน่ายตั๋ว Google ขนส่งสาธารณะ โดยมีชุดพารามิเตอร์ที่แก้ไขแล้วดังนี้

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

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

สำหรับเวลาหยุดที่เฉพาะเจาะจง ค่านี้คือค่าของ stop_id ของสถานีต้นทาง

to_ticketing_stop_time_id

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

สำหรับเวลาหยุดที่เฉพาะเจาะจง ค่านี้คือค่าของ stop_id ของสถานีปลายทาง

service_date

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

ฟิลด์นี้จะจัดรูปแบบเป็นอาร์เรย์ JSON ซึ่งมีวันที่ที่มีสตริงรูปแบบต่อไปนี้

YYYYMMDD

boarding_time

(ISO 8601, ทำซ้ำได้) วันที่และเวลาออกเดินทาง (departure_time) ของ stop_time ที่เริ่มการเดินทาง

ค่าเวลาของฟิลด์นี้เป็นไปตาม ISO 8601 โดยมีสตริงรูปแบบดังนี้

YYYY-MM-DDThh:mm:ss±hh:mm

arrival_time

(ISO 8601, ทำซ้ำได้) วันที่และเวลาที่มาถึง (arrival_time) ของ stop_time ที่สิ้นสุดขา

ค่าเวลาของฟิลด์นี้เป็นไปตาม ISO 8601 โดยมีสตริงรูปแบบดังนี้

YYYY-MM-DDThh:mm:ss±hh:mm

booking_token

(สตริง) ฟิลด์ที่ไม่บังคับซึ่งใช้เพื่อเพิ่มข้อมูล ค่านี้มาจากคำตอบของ Travel Transport API และจะต่อท้าย Deep Link ของการจำหน่ายตั๋ว

ความยาวสูงสุดของ booking_token ควรอยู่ที่ 100 อักขระ

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

lang

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

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

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

cur

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

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

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

utm_source

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

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

พารามิเตอร์ที่ทำซ้ำได้ทั้งหมดจะระบุเป็นอาร์เรย์ JSON โดยที่ค่าหลายค่า ระบุจุดแวะพัก คุณดูตัวอย่างการเข้ารหัส URL ได้ในตัวอย่าง ของส่วนขยายการจำหน่ายตั๋ว Google ขนส่งสาธารณะ