Tích hợp chỉ dừng

Tổng quan

Nếu không phải là nhà cung cấp nguồn cấp dữ liệu GTFS cho Google Maps, thì chế độ tích hợp của bạn sẽ là Chỉ có điểm dừng. Đối với chế độ tích hợp này, chúng tôi cần hiểu cách bạn xác định các điểm dừng tàu hoặc xe buýt khác nhau.

Quy cách chung cho nguồn cấp dữ liệu

Khi bắt đầu tích hợp, chúng tôi sẽ tạo một giá trị nhận dạng riêng biệt cho mỗi chế độ tích hợp, ví dụ: ch_google_test (mã quốc gia, tên đối tác, chế độ tích hợp) hoặc eu_google (mã khu vực, tên đối tác).

Đối tác cung cấp một tệp chứa các tệp văn bản ở định dạng CSV được áp dụng cho mỗi chế độ tích hợp. Mỗi tệp CSV phải chứa một hàng tiêu đề có tên cột khớp với "Tên trường" được chỉ định trong bảng quy cách nguồn cấp dữ liệu tương ứng.

Để cho phép Đối tác tải các phiên bản mới của tệp điểm dừng và thị trường lên, nhóm của chúng tôi sẽ chia sẻ thông tin chi tiết về Tài khoản đăng SFTP (một cho mỗi loại tệp) trong quá trình thiết lập.

Quy cách nguồn cấp dữ liệu điểm dừng (bắt buộc)

Tệp điểm dừng phải chứa các cột sau:

Tên trường Loại (xem GTFS) Mô tả
stop_id Mã (bắt buộc) Giá trị nhận dạng riêng biệt xác định một điểm dừng hoặc nhà ga. Các nhà ga lớn hơn chỉ nên chứa một mục nhập. Giá trị này được dùng khi thực hiện lệnh gọi đến API Máy chủ đối tác và trong các đường liên kết sâu đến trang bán vé.
stop_name Văn bản (bắt buộc) Tên dễ đọc để gỡ lỗi dữ liệu về việc liên kết điểm dừng, điền bộ nhớ đệm và độ chính xác về giá.
stop_lat Vĩ độ (bắt buộc) Vĩ độ của điểm dừng.
stop_lon Kinh độ (bắt buộc) Kinh độ của điểm dừng.

Chúng tôi sẽ sử dụng quy trình tự động thu thập dữ liệu để đối tác có thể liên tục cung cấp các tệp zip đã cập nhật khi thông tin trong đó thay đổi. Ví dụ: đối tác có thể mở rộng khoảng không quảng cáo được cung cấp bằng cách mở rộng danh sách điểm dừng. Tuy nhiên, tương tự như GTFS, stop_ids phải ổn định.

Quy cách nguồn cấp dữ liệu tập hợp thị trường (không bắt buộc)

Với các điểm dừng đã liên kết, chúng tôi sẽ tạo tập hợp thị trường cho chế độ tích hợp này (một danh sách chứa các cặp điểm đi / điểm đến phổ biến). Từ đó, bạn có thể giảm tập hợp thị trường này bằng cách cung cấp nguồn cấp dữ liệu tập hợp thị trường.

Tập hợp thị trường hoạt động như một danh sách cho phép đối với dịch vụ điền bộ nhớ đệm của chúng tôi. Theo mặc định, nếu không có tập hợp thị trường nào được cung cấp, thì tất cả các thị trường đều được bật. Nếu bạn cung cấp một tập hợp thị trường, thì chỉ những thị trường có trong danh sách mới được truy vấn. Nếu người dùng truy vấn các thị trường bên ngoài danh sách cho phép này, hệ thống của chúng tôi vẫn sẽ gửi một truy vấn trực tiếp cho thị trường và ngày cụ thể được yêu cầu, nhưng chúng tôi sẽ không chủ động cố gắng lưu vào bộ nhớ đệm.

Tệp tập hợp thị trường phải chứa các cột sau:

Tên trường Loại (xem GTFS) Mô tả
origin_stop_id Mã (bắt buộc) stop_id nguồn gốc của thị trường.
destination_stop_id Mã (bắt buộc) stop_id điểm đến của thị trường.

Cấu hình đối tác

Khi sử dụng chế độ tích hợp chỉ có điểm dừng, chúng tôi yêu cầu thêm thông tin cho cấu hình đối tác tĩnh như được nêu trong phần Cấu hình đối tác.

Định dạng và các tham số của đường liên kết đặt phòng (còn gọi là Ticketing link) được xác định trong Đường liên kết đến trang bán vé

Tham số API đối tác

Các tham số SegmentKeys cho API Đối tác (GetBulkTripOptionsRequest) dựa trên quy cách đường liên kết sâu. Chúng tôi sử dụng SegmentKeys chỉ bao gồm from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time và arrival_time, để trống ticketing_trip_id. Chúng tôi sẽ chỉ định đầy đủ tuyến đường, bao gồm cả tất cả các điểm chuyển tuyến bằng cách chỉ định nhiều SegmentKeys, một cho mỗi phân đoạn.