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ỉ trạm dừng. Để tích hợp tính năng này, chúng tôi cần hiểu cách bạn xác định các trạm dừng xe buýt hoặc tàu.
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 hoạt động tích hợp, ví dụ: ch_google_test (mã quốc gia, tên đối tác, hoạt động tích hợp) hoặc eu_google (mã khu vực, tên đối tác).
Đối tác có thể cung cấp tệp zip chứa các tệp văn bản ở định dạng CSV được áp dụng trên toàn cầu hoặc theo từng chế độ tích hợp:
Ví dụ 1:
- ch_google_test_stops.txt
- ch_google_test_markets.txt
Ví dụ 2:
- stops.txt (áp dụng cho tất cả các chế độ tích hợp)
- eu_google_integration1_markets.txt
- eu_google_integration2_markets.txt
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 |
Giấy tờ tuỳ thân (bắt buộc) | Giá trị nhận dạng duy nhất giúp xác định một điểm dừng hoặc trạm. Các trạm lớn hơn chỉ được chứa một mục nhập. Mã này được dùng khi thực hiện lệnh gọi đến API máy chủ đối tác và trong đường liên kết sâu đến trang đặt vé. |
stop_name |
Văn bản (bắt buộc) | Tên mà con người dễ đọc để gỡ lỗi liên kết điểm dừng, điền bộ nhớ đệm và dữ liệu về mức độ 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 để các đối tác có thể liên tục cung cấp tệp zip đã cập nhật khi thông tin trong đó thay đổi. Ví dụ: một đố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 nhóm 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 nhóm thị trường cho quá trình tích hợp này (danh sách chứa các cặp điểm xuất phát / điểm đến phổ biến). Từ đó, bạn có thể giảm nhóm thị trường này bằng cách cung cấp nguồn cấp dữ liệu nhóm thị trường.
Tập hợp thị trường đóng vai trò là danh sách cho phép: Nếu bạn không cung cấp tập hợp thị trường, thì tất cả thị trường sẽ được bật trong quá trình tích hợp. Nếu bạn cung cấp một nhóm thị trường, thì mọi thị trường không có trong danh sách sẽ bị tắt.
Tệp nhóm 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 |
Giấy tờ tuỳ thân (bắt buộc) | stop_id gốc của thị trường. |
destination_stop_id |
Giấy tờ tuỳ thân (bắt buộc) | stop_id đích 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 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.
Đường liên kết sâu đến trang đặt vé
Định dạng và tham số của đường liên kết sâu được xác định trong phần Đường liên kết bán vé
Thông số API đối tác
Các thông số SegmentKeys cho API Đối tác (GetBulkTripOptionsRequest) dựa trên thông số kỹ thuật của đường liên kết sâu. Chúng ta 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 ta sẽ chỉ định đầy đủ tuyến đường bao gồm tất cả các lượt chuyển bằng cách chỉ định nhiều SegmentKey, mỗi SegmentKey cho một phân đoạn.