Định dạng đường liên kết tìm kiếm

Đối với đường liên kết tìm kiếm, các đối tác sẽ cung cấp một URL cơ sở dành riêng cho tìm kiếm (xem phần Cấu hình đối tác). Chúng tôi hỗ trợ các tham số truy vấn sau:

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

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

Giá trị của stop_id của các nhà ga khởi hành.
to_stop_id

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

Giá trị của stop_id của các trạm đến.
search_date

(Ngày) Ngày sử dụng dịch vụ của chuyến đi.

Trường này chứa ngày có chuỗi định dạng sau:

YYYYMMDD
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 nên 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ể 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. Đối với from_stop_id và to_stop_id, nhiều giá trị thể hiện nhiều trạm tại địa điểm xuất phát và địa điểm đến.

Ví dụ

Trong ví dụ này, người dùng truy vấn thông tin về các chuyến tàu từ locality1 đến locality2:

  • locality1 tương ứng với các trạm có stop_id f1 và f2.
  • locality2 tương ứng với các trạm có stop_id t1 và t2.
  • Ngày dịch vụ là 20190716.

Trong ví dụ này, URL cơ sở là https://example.com.

Với tất cả thông tin này, hãy sử dụng các giá trị sau cho các tham số:

Tên trường Thông tin chi tiết
from_stop_id ["f1", "f2"]
to_stop_id ["t1", "t2"]
service_date 20190716

Sau đây là URI cuối cùng sau khi mã hoá:

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

Trong trang đích, người dùng sẽ có thể xem hành trình khởi hành từ các nhà ga f1 và f2 vào ngày 20190716 và đến các nhà ga t1 và t2. Hỗ trợ tất cả các tổ hợp trạm sạc:

  • Từ f1 đến t1
  • Từ f1 đến t2
  • Từ f2 đến t1
  • Từ f2 đến t2