Tài liệu tham khảo và điểm khác biệt về GTFS theo thời gian thực của Google Transit

Trang này mô tả những điểm khác biệt chính giữa việc triển khai thông số kỹ thuật của GTFS Theo thời gian thực chính thức và Google Transit trong các lĩnh vực sau:

  • Bỏ qua thông số kỹ thuật chính thức: Các trường này là một phần của GTFS chính thức. Google Transit nhập dữ liệu này mà không gặp lỗi nhưng không chủ động sử dụng dữ liệu.

  • Cách diễn giải khác: Các trường này bao gồm các phần của GTFS chính thức mà Google Transit diễn giải theo cách khác với định nghĩa của GTFS về các phần đó.

  • Hỗ trợ thử nghiệm: Các trường này đang trong giai đoạn thử nghiệm trong quá trình triển khai Google Transit. Nếu bạn muốn triển khai một trường thử nghiệm mới, hãy liên hệ với Nhóm Google Transit.

  • Tiện ích được Google Transit hỗ trợ: Tiện ích này không thuộc GTFS chính thức. Tiện ích được hỗ trợ cho phương tiện công cộng bao gồm cả tiện ích công khai và tiện ích dành riêng cho Google Transit. Mọi đối tác đều có thể gửi thông tin này đến Transit trong nguồn cấp dữ liệu của họ.

Phương tiện công cộng theo thời gian thực

Các phần sau đây trình bày những điểm khác biệt chính giữa việc triển khai nguồn cấp dữ liệu phương tiện công cộng theo thời gian thực của GTFS chính thức và Google Transit.

Bỏ qua thông số kỹ thuật chính thức trong nguồn cấp dữ liệu theo thời gian thực

Một số thông số kỹ thuật bị bỏ qua đang trong giai đoạn thử nghiệm. Để tìm hiểu thêm, hãy truy cập vào gtfs.org.

Bảng 1 liệt kê các trường do GTFS xác định mà tính năng Phương tiện công cộng bỏ qua trong nguồn cấp dữ liệu theo thời gian thực.

Bảng 1. Bỏ qua các trường chính thức trong nguồn cấp dữ liệu theo thời gian thực
Thông điệp Trường bị bỏ qua được xác định trong GTFS Loại trường
message Alert image TranslatedImage
message Alert image_alternative_text TranslatedString
message Alert severity_level Enum
message Alert tts_description_text Proto
message Alert tts_header_text Proto
message CarriageDetails id Chuỗi
message CarriageDetails occupancy_percentage int32
message Position bearing Số thực dấu phẩy động
message Position odometer Đôi
message Position speed Số thực dấu phẩy động
message Shape encoded_polyline Chuỗi
message Shape shape_id Chuỗi
message StopTimeUpdate (trong TripUpdate) arrival.uncertainty int32
message StopTimeUpdate (trong TripUpdate) stop_time_properties Proto
message TripUpdate trip_properties Proto
message TripUpdate vehicle VehicleDescriptor
message VehicleDescriptor license_plate Chuỗi
message VehicleDescriptor wheelchair_accessible WheelchairAccessible
message VehiclePosition congestion_level Enum
message VehiclePosition current_status VehicleStopStatus
message VehiclePosition current_stop_sequence uint32
message VehiclePosition multi_carriage_details.id Chuỗi
message VehiclePosition occupancy_percentage uint32
message VehiclePosition stop_id Chuỗi

Cách diễn giải khác nhau trong nguồn cấp dữ liệu theo thời gian thực

Mặc dù chấp nhận một số trường GTFS nhất định, nhưng Transit diễn giải các trường đó khác với GTFS.

Bảng 2 liệt kê các trường do GTFS xác định trong nguồn cấp dữ liệu theo thời gian thực là không bắt buộc hoặc bắt buộc theo điều kiện của phương tiện công cộng. Đối với các trường không bắt buộc, bảng này cho biết liệu Transit có hỗ trợ các giá trị enum hay không.

Bảng 2. Các trường nguồn cấp dữ liệu theo thời gian thực được diễn giải khác nhau
Tên tệp Trường được xác định trong GTFS Loại trường Google Transit có yêu cầu không? Thông tin chi tiết về việc triển khai Google Transit
message StopTimeUpdate (trong TripUpdate) stop_id Chuỗi Bắt buộc có điều kiện

Khi bạn cung cấp một chuỗi stop_id, chuỗi đó phải đáp ứng một trong các điều kiện sau:

  • Chuỗi stop_id phải giống với chuỗi trong tệp stops.txt trong nguồn cấp dữ liệu GTFS tương ứng.
  • Nếu bạn sử dụng một chuỗi stop_id khác, thì chuỗi stop_id được cung cấp phải là chuỗi đồng cấp hoặc chuỗi con của chuỗi stop_id ban đầu được cung cấp trong GTFS tĩnh. Bạn cũng phải cung cấp trường stop_sequence tương ứng.
message StopTimeUpdate schedule_relationship Enum Không bắt buộc

Google Transit hỗ trợ các giá trị enum sau:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
message TripDescriptor schedule_relationship Enum Không bắt buộc

Google Transit không hỗ trợ các giá trị enum sau:

  • DUPLICATED
  • CANCELED – khi không dành cho bản ghi TripUpdate

Google hỗ trợ các giá trị enum sau:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED – chỉ hỗ trợ cho bản ghi TripUpdate

Hỗ trợ thử nghiệm trong nguồn cấp dữ liệu theo thời gian thực

Nếu bạn cần được hỗ trợ để tích hợp các trường thử nghiệm mới, hãy liên hệ với Google Transit.

Các tiện ích được Google Transit hỗ trợ trong nguồn cấp dữ liệu theo thời gian thực

Tại thời điểm xuất bản bài viết này, không có trường nào thuộc danh mục này. Nếu bạn cần được hỗ trợ, hãy liên hệ với Google Transit.