Tích hợp chỉ dừng

Tổng quan

Nếu bạn 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. Để tích hợp, chúng tôi cần biết cách bạn xác định các trạm dừng tàu hoặc xe buýt.

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 duy nhất cho mỗi lần tích hợp, ví dụ: ch_google_test (mã quốc gia, tên đối tác, tích hợp) hoặc eu_google (mã khu vực, tên đối tác).

Cá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 lần 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 trạm dừng và tệp thị trường lên, nhóm của chúng tôi sẽ chia sẻ thông tin chi tiết về hộp thư SFTP, một cho mỗi loại tệp trong quá trình tham gia.

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ã nhận dạng (bắt buộc) Giá trị nhận dạng riêng biệt giúp xác định một điểm dừng hoặc trạm. Các trạm sạc lớn hơn chỉ được chứa một mục nhập. Giá trị này được dùng khi thực hiện các lệnh gọi đến Partner Server API và trong các đường liên kết sâu về vé.
stop_name Văn bản (bắt buộc) Tên mà con người dễ đọc để gỡ lỗi việc liên kết điểm dừng, điền vào bộ nhớ đệm và dữ liệu về độ chính xác của giá.
stop_lat Vĩ độ (bắt buộc) Vĩ độ của trạm dừng.
stop_lon Kinh độ (bắt buộc) Kinh độ của trạm dừng.

Chúng tôi sẽ sử dụng quy trình nhập tự động, trong đó các đối tác có thể liên tục cung cấp tệp zip mới 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 các điểm dừng. Tuy nhiên, tương tự như GTFS, stop_id phải ổn định.

Quy cách nguồn cấp dữ liệu bộ sản phẩm theo thị trường (không bắt buộc)

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

Nhóm thị trường hoạt động như một danh sách cho phép cho dịch vụ điền bộ nhớ đệm của chúng tôi. Theo mặc định, nếu bạn không cung cấp bộ thị trường nào, thì tất cả thị trường đều được bật. Nếu bạn cung cấp một bộ 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 cố gắng chủ động lưu vào bộ nhớ đệm.

Tệp bộ 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ã nhận dạng (bắt buộc) stop_id ban đầu của thị trường.
destination_stop_id Mã nhận dạng (bắt buộc) stop_id của thị trường.

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

Khi sử dụng chế độ tích hợp chỉ dừng, chúng tôi cần thêm thông tin cho cấu hình đối tác tĩnh như trình bày 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 vé (còn gọi là Ticketing link) được xác định trong Đường liên kết bán vé

Tham số Partner API

Các thông số SegmentKeys cho Partner API (GetBulkTripOptionsRequest) dựa trên quy cách đường liên kết sâu. Chúng tôi chỉ sử dụng SegmentKeys, 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 lượt chuyển bằng cách chỉ định nhiều SegmentKey, mỗi SegmentKey cho một đoạn đường.