Bảng chú giải thuật ngữ

Bảng thuật ngữ này định nghĩa các thuật ngữ chính được dùng trong tài liệu Tích hợp đối tác vận chuyển.

Mã thông báo đặt vé: Một chuỗi không bắt buộc do đối tác tạo, có thể được truyền trong đường liên kết sâu đặt vé để giúp duy trì tính nhất quán về giá và hành trình giữa kết quả tìm kiếm của Google và trang đặt vé của đối tác.

Ánh xạ JSON chuẩn: Một nhóm quy tắc cụ thể do Protocol Buffers xác định để chuyển đổi thông báo proto thành đối tượng JSON. Để tích hợp, bạn cần sử dụng ánh xạ này với các lựa chọn cụ thể để yêu cầu và phản hồi được định dạng chính xác.

GTFS (Quy cách chung cho nguồn cấp dữ liệu về phương tiện công cộng): Một định dạng dữ liệu tiêu chuẩn mà các công ty vận tải công cộng sử dụng để cung cấp thông tin về lịch trình, tuyến đường và giá vé cho hành khách. Trong chế độ tích hợp này, đây là một trong hai cách để cung cấp dữ liệu tĩnh cho Google.

Tích hợp dựa trên GTFS: Một phương thức tích hợp dành cho những đối tác cung cấp dữ liệu lịch trình của riêng họ cho Google trong một nguồn cấp dữ liệu GTFS. Thông tin này được dùng khi Google chưa có lịch trình của nhà điều hành.

known_itineraries: Một lựa chọn trong Cấu hình đối tác cho phép đối tác nhận danh sách các hành trình đã biết từ Google để tối ưu hoá phản hồi của họ.

Market Set (Tập hợp thị trường): (Đối với chế độ tích hợp chỉ dừng) Nguồn cấp dữ liệu không bắt buộc do đối tác cung cấp để xác định một danh sách cụ thể gồm các cặp điểm xuất phát – điểm đến (thị trường) mà họ sẽ cung cấp giá. Nếu được cung cấp, tham số này sẽ hoạt động như một danh sách cho phép.

Partner API / Partner Server API: Nhóm API mà đối tác phải triển khai để cung cấp cho Google dữ liệu linh động, chẳng hạn như giá và tình trạng phòng theo thời gian thực.

Kiểm tra chất lượng giá: Quy trình diễn ra liên tục, trong đó trình thu thập thông tin của Google lấy mẫu hành trình trên trang web của đối tác để xác minh rằng giá mà người dùng nhìn thấy khớp với giá được cung cấp thông qua Partner API.

QPS (Số truy vấn mỗi giây): Tốc độ trung bình mà Google gửi yêu cầu (một truy vấn là một yêu cầu) đến máy chủ Partner API. Tỷ lệ này có thể dao động, với những khoảng thời gian lưu lượng truy cập cao hơn hoặc thấp hơn một chút.

SegmentKey: Một đối tượng được dùng trong Partner API để xác định duy nhất một chặng của hành trình, bao gồm cả điểm xuất phát, điểm đến và ngày/giờ dịch vụ.

service_date: Ngày cụ thể mà dịch vụ vận chuyển công cộng hoạt động, được định dạng là YYYYMMDD. Mã này được dùng kết hợp với các giá trị nhận dạng khác để chỉ định một phiên bản chuyến đi duy nhất.

Chỉ tích hợp dừng: Một phương thức tích hợp dành cho những đối tác không phải là nguồn dữ liệu lịch phát sóng. Thuộc tính này được dùng khi Google đã nhận được lịch trình của nhà điều hành từ một nguồn khác. Đối tác chỉ cần cung cấp danh sách mã nhận dạng điểm dừng.

ticketing_stop_id: Giá trị nhận dạng duy nhất của đối tác cho một điểm dừng hoặc trạm. Mã nhận dạng này được cung cấp trong nguồn cấp dữ liệu tĩnh (GTFS hoặc Chỉ có điểm dừng) và được dùng trong Partner API và đường liên kết sâu đến hệ thống bán vé.

ticketing_trip_id: (Đối với chế độ tích hợp dựa trên GTFS) Giá trị nhận dạng riêng biệt của đối tác cho một chuyến đi cụ thể, được cung cấp trong tệp trips.txt của nguồn cấp dữ liệu GTFS. Chỉ tích hợp dựa trên GTFS.

Đường liên kết sâu đến trang bán vé: Một URL chuyển hướng người dùng từ kết quả tìm kiếm của Google đến trang web của đối tác để đặt một hành trình cụ thể. URL này chứa thông tin chi tiết được mã hoá về chuyến đi đã chọn.

TripOptionsErrorType: Một nhóm cụ thể gồm các loại lỗi có thể được trả về trong Partner API để cung cấp thông tin chi tiết hơn về lý do khiến yêu cầu không thành công.

UNSPECIFIED Giá trị enum: Giá trị đầu tiên bắt buộc (có giá trị số là 0) trong mọi định nghĩa enum khi sử dụng Protocol Buffers. Đây là giá trị mặc định và thường được coi là lỗi nếu nhận được trong một yêu cầu.