Định dạng đường liên kết đến trang bán vé

Đối với đường liên kết sâu, các đối tác sẽ cung cấp URL cơ sở (xem phần Cấu hình đối tác). Các tham số truy vấn mà chúng tôi thêm vào URL sẽ tuân theo Tiện ích bán vé phương tiện công cộng của Google với một bộ tham số đã được sửa đổi:

Tên trường Thông tin chi tiết
from_ticketing_stop_time_id

(Có thể lặp lại) Giá trị nhận dạng của điểm dừng nơi chặng bắt đầu.

Đối với một thời gian dừng cụ thể, đây là giá trị của stop_id của trạm khởi hành.
to_ticketing_stop_time_id

(Có thể lặp lại) Giá trị nhận dạng của điểm dừng mà chặng kết thúc.

Đối với một thời gian dừng cụ thể, đây là giá trị của stop_id của nhà ga đến.
service_date

(Ngày, Có thể lặp lại) Ngày sử dụng dịch vụ của chuyến đi.

Trường này có định dạng là một mảng JSON, chứa ngày có chuỗi định dạng sau:

YYYYMMDD
boarding_time

(ISO 8601, Có thể lặp lại) Ngày và giờ khởi hành (departure_time) của stop_time mà chặng bắt đầu.

Giá trị thời gian của trường này tuân thủ ISO 8601, với chuỗi định dạng sau:

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

(ISO 8601, Có thể lặp lại) Ngày và giờ đến (arrival_time) của stop_time mà tại đó chặng kết thúc.

Giá trị thời gian của trường này tuân thủ ISO 8601, với chuỗi định dạng sau:

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

(Chuỗi) Trường không bắt buộc dùng để thêm dữ liệu bổ sung. Giá trị này xuất phát từ phản hồi của Travel Transport API và được thêm vào đường liên kết sâu để đặt vé.

Độ dài tối đa của booking_token là 100 ký tự.

Tính năng tra cứu chuyến đi vẫn hoạt động mà không cần mã thông báo đặt chỗ, nhưng bạn có thể dùng mã thông báo này để duy trì tính nhất quán về giá giữa kết quả trên Google Tìm kiếm và trang đặt chỗ của đối tác.
lang

(IETF BCP 47, Không bắt buộc) Trường dùng để cho biết ngôn ngữ đã chọn của trang web đặt phòng.

Giá trị của trường này tuân thủ IETF BCP 47, ví dụ: en-US.

Nếu ngôn ngữ đã chọn không có sẵn hoặc trường này không được truyền, thì trang web đặt phòng phải sử dụng ngôn ngữ dự phòng.
cur

(ISO 4217, Không bắt buộc) Trường dùng để cho biết đơn vị tiền tệ mà giá sẽ được hiển thị.

Giá trị của trường này tuân theo tiêu chuẩn ISO 4217, ví dụ: USD.

Nếu không thể hiện đơn vị tiền tệ đã chọn hoặc trường này không được truyền, thì trang web đặt phòng nên sử dụng đơn vị tiền tệ dự phòng.
utm_source

(Chuỗi, không bắt buộc) Trường dùng để cho biết trang web cấp cao đã gửi lưu lượng truy cập.

Các giá trị có thể có là google_search và google_maps.

Tất cả các tham số có thể lặp lại đều được chỉ định dưới dạng một mảng JSON, trong đó nhiều giá trị cho biết các điểm dừng chuyển tuyến. Bạn có thể tìm thấy các ví dụ về việc mã hoá URL trong các ví dụ của Tiện ích Google Transit Ticketing.