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

Trang này mô tả những điểm khác biệt chính giữa cách tính thời gian thực của GTFS chính thức và cách Google Transit triển khai quy cách trong các phần sau:

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

  • 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 khác với định nghĩa GTFS của 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 hỗ trợ Google Transit: Tiện ích này không thuộc GTFS chính thức. Tiện ích hỗ trợ Phương tiện công cộng bao gồm cả tiện ích công cộng 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 Phương tiện công cộng 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 ghi lại những điểm khác biệt chính giữa GTFS chính thức và cách Google Transit sử dụng Nguồn cấp dữ liệu phương tiện công cộng theo thời gian thực.

Bỏ qua quy cách 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à Transit sẽ 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
thông báo Alert image TranslatedImage
thông báo Alert image_alternative_text TranslatedString
thông báo Alert severity_level Liệt kê
thông báo Alert tts_description_text Proto
thông báo Alert tts_header_text Proto
thông báo CarriageDetails id Chuỗi
thông báo CarriageDetails occupancy_percentage int32
thông báo Position bearing Số thực dấu phẩy động
thông báo Position odometer Số thực có độ chính xác kép
thông báo Position speed Số thực dấu phẩy động
thông báo Shape encoded_polyline Chuỗi
thông báo Shape shape_id Chuỗi
tin nhắn StopTimeUpdate (trong TripUpdate) arrival.uncertainty int32
tin nhắn StopTimeUpdate (trong TripUpdate) stop_time_properties Proto
thông báo TripUpdate trip_properties Proto
thông báo TripUpdate vehicle VehicleDescriptor
thông báo VehicleDescriptor license_plate Chuỗi
thông báo VehicleDescriptor wheelchair_accessible WheelchairAccessible
thông báo VehiclePosition congestion_level Liệt kê
thông báo VehiclePosition current_status VehicleStopStatus
thông báo VehiclePosition current_stop_sequence uint32
thông báo VehiclePosition multi_carriage_details.id Chuỗi
thông báo VehiclePosition occupancy_percentage uint32
thông báo VehiclePosition stop_id Chuỗi

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

Mặc dù Transit chấp nhận một số trường GTFS nhất định, nhưng Transit sẽ hiểu các trường này 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 (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 sẽ cho biết liệu các giá trị enum có được Transit hay không.

Bảng 2. Các trường nguồn cấp dữ liệu theo thời gian thực bị 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 bắt buộc? Thông tin chi tiết về việc triển khai Google Transit
tin nhắn StopTimeUpdate (trong TripUpdate) stop_id Chuỗi Bắt buộc có điều kiện

Khi chuỗi stop_id được cung cấp, 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 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.
thông báo StopTimeUpdate schedule_relationship Liệt kê Không bắt buộc

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

  • SCHEDULED
  • SKIPPED
  • NO_DATA
thông báo TripDescriptor schedule_relationship Liệt kê Không bắt buộc

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

  • DUPLICATED
  • CANCELED – khi chế độ này không áp dụng cho bản ghi TripUpdate

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

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED – chỉ được 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 hỗ trợ để tích hợp các trường thử nghiệm mới, hãy liên hệ với Google Transit.

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 hỗ trợ, hãy liên hệ với Google Transit.