Tài liệu tham khảo và điểm khác biệt về lịch trình GTFS của Google Transit

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

  • Thông số kỹ thuật chính thức bị bỏ qua: Các trường này là một phần của thông số chính thức GTFS (Quy cách chung cho tài khoản về kỹ thuật số) Google Transit nhập dữ liệu này mà không có 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 thông tin chính thức GTFS mà Google Transit diễn giải khác với định nghĩa của GTFS các phần đó.

  • Hỗ trợ thử nghiệm: Các trường này đang trong giai đoạn thử nghiệm trong trong quá trình triển khai. 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 mở rộng hỗ trợ chuyển tuyến bao gồm cả tiện ích công cộng và các 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 cho Chuyển tuyến trong nguồn cấp dữ liệu của họ.

Phương tiện công cộng tĩnh

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

Thông số kỹ thuật chính thức bị bỏ qua trong nguồn cấp dữ liệu tĩnh

Một số thông số kỹ thuật chính thức bị Chuyển tuyến bỏ qua đang trong giai đoạn thử nghiệm. Người nhận để tìm hiểu thêm, hãy truy cập gtfs.org.

Bảng 1 liệt kê các tệp GTFS không được Transit hỗ trợ trong nguồn cấp dữ liệu tĩnh. Ngoài ra, không có trường nào được xác định trong các tệp này được hỗ trợ bởi Chuyển tuyến.

Bảng 1. Các tệp GTFS không được hỗ trợ trong nguồn cấp dữ liệu tĩnh
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

Bảng 2 liệt kê tất cả các trường do GTFS xác định bị Chuyển tuyến bỏ qua trong nguồn cấp dữ liệu tĩnh.

Bảng 2. Các trường GTFS bị bỏ qua trong nguồn cấp dữ liệu tĩnh
Tên tệp Trường bị bỏ qua được xác định trong GTFS Loại trường
fare_attributes.txt payment_method Enum
feed_info.txt default_lang Mã ngôn ngữ
feed_info.txt feed_publisher_name Văn bản
pathways.txt max_slope Số thực dấu phẩy động
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id Mã nhận dạng
routes.txt route_desc Văn bản
routes.txt route_sort_order Số nguyên không âm
stops.txt level_id Mã nhận dạng
stops.txt stop_desc Văn bản
stops.txt stop_url URL
stops.txt tts_stop_name Văn bản
trips.txt bikes_allowed Enum

Cách diễn giải khác trong nguồn cấp dữ liệu tĩnh

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

Bảng 3 cho thấy các trường trong nguồn cấp dữ liệu tĩnh mà Transit triển khai theo cách khác khác với mô tả trong GTFS.

Bảng 3. Các trường nguồn cấp dữ liệu tĩnh được triển khai khác biệt
Tên tệp Trường được xác định trong GTFS Loại trường Google Transit yêu cầu? Thông tin chi tiết về việc triển khai Google Transit
fare_attributes.txt transfers Enum Bắt buộc

Tiện ích Google Transit.

GTFS công khai giới hạn các giá trị trong khoảng từ 0 đến 2 Google Transit chấp nhận các giá trị từ 0 đến 5

Sử dụng trường này để đặt số lượt chuyển tối đa được phép bằng giá vé. Điều này không bao gồm yêu cầu chặn (hay còn gọi là chuyển tại chỗ) chuyển cuộc gọi. Nếu bạn không muốn đặt giới hạn về số lần chuyển tiền giá vé, hãy để trống trường transfers.
pathways.txt pathway_mode Enum Không bắt buộc Khi trường pathway_mode được chỉ định, nếu trường này được đặt ở bên trái trống, Google Transit chấp nhận và coi tệp này là không xác định.
stop_times.txt arrival_time Thời gian Bắt buộc có điều kiện Giờ bị giới hạn ở các giá trị từ 00 đến 99, quá đủ cho các chuyến đi 3 ngày.
transfers.txt transfer_type Enum Bắt buộc

Giá trị của 4 và 5 không được hỗ trợ và sẽ bị bỏ qua.

Google Transit hỗ trợ các giá trị của 0, 1, 2 và 3.
trips.txt block_id Mã nhận dạng Không bắt buộc Để tìm hiểu thêm, hãy xem Ví dụ về chặn yêu cầu chuyển.

Hỗ trợ thử nghiệm trong nguồn cấp dữ liệu tĩnh

Nếu cần hỗ trợ để tích hợp các trường thử nghiệm mới trong danh mục này, 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 tĩnh

Bảng 4 cung cấp thông tin về các tiện ích của Google Transit. Các trường này không thuộc GTFS chính thức.

Bảng 4. Phần mở rộng về nguồn cấp dữ liệu tĩnh được hỗ trợ
Tên tệp Trường Loại trường Google Transit yêu cầu? Thông tin chi tiết về việc triển khai Google Transit
fare_attributes.txt ic_price Số thực dấu phẩy động Không bắt buộc

Tiện ích Google Transit này chỉ dành cho các đối tác ở Nhật Bản.

Trường ic_price thể hiện số tiền chiết khấu của thanh toán cho giá vé này bằng thẻ thông minh. Nếu không có chiết khấu nếu bạn cung cấp giá vé này, hoặc thẻ thông minh không được hỗ trợ, Giá trị của trường ic_price cần phải là -1.
fare_rules.txt contains_route_id Mã nhận dạng Không bắt buộc

Tiện ích Google Transit.

Giá vé này chỉ áp dụng cho các chuyến đi vào một nhóm tuyến đường chính xác được xác định bởi giá trị route_id trong tất cả các hàng cho thuộc tính này tổ hợp fare_id, origin_id và destination_id cột.

Nếu cột contains_route_id bị thiếu hoặc tất cả các giá trị của giá vé này là rỗng, vậy giá vé không bị hạn chế trong . Nếu trường contains_route_id được cung cấp cho giá vé, thì trường route_id phải để trống.
routes.txt checkin_duration Số nguyên Không bắt buộc

Tiện ích Google Transit.

Trường checkin_duration chỉ định số giây nên hành khách đến sớm trước thời gian khởi hành theo lịch trình sau xác nhận có mặt và lên máy bay.

Nếu hành khách nối chuyến tại điểm khởi hành, thì bất kỳ thời gian chuyển đã xác định sẽ ghi đè giá trị checkin_duration.

Giá trị checkin_duration chỉ là một đề xuất thường do công ty vận tải cung cấp. Số liệu này có thể không phản ánh đúng giá trị tuyệt đối thời điểm cuối cùng mà hành khách có thể đến và vẫn lên tàu chiếc xe.
routes.txt route_type Enum Bắt buộc

Tiện ích Google Transit.

Để tìm hiểu cách Google Transit mở rộng route_type được GTFS chấp nhận các lựa chọn về giá trị, xem Loại tuyến GTFS mở rộng.
stop_times.txt stop_direction_name Văn bản Không bắt buộc

Tiện ích Google Transit.

Trường stop_direction_name xác định thông tin chỉ đường cho hành khách. Hướng được lưu trữ dưới dạng direction_name giá trị của thời gian khởi hành từ điểm dừng này.

Nếu trường stop_direction_name trống, thì hàm Thay vào đó, trường trip_direction_name hỗ trợ phương tiện công cộng sẽ được sử dụng. Nếu trip_direction_name và stop_direction_name cả hai trường đều trống, thì trình nhập phương tiện công cộng để trống các trường này. Ngang bằng trong trường hợp đó, đối tác có thể sử dụng stop_headsign hoặc Thay vào đó, giá trị trip_headsign. Các giá trị của thuộc tính Trường stop_direction_name được chuẩn hoá chữ hoa chữ thường.
stops.txt signposted_as Văn bản Không bắt buộc

Tiện ích Google Transit.

Trường signposted_as chứa văn bản nguyên văn đã viết trên bảng hiệu dành cho nền tảng. Ví dụ: "Hướng đến Trung tâm" và "Sườn phía Đông và Brooklyn."

Trường platform_code của GTFS và trường được phương tiện công cộng hỗ trợ Bạn có thể đặt trường signposted_as cùng lúc.

Sự khác biệt giữa platform_code và Các trường signposted_as bao gồm:

  • Thời lượng. Trường platform_code thường chứa một số hoặc chữ cái như 2 hoặc C.
  • Ngôn ngữ. Trường platform_code không có một ngôn ngữ, nhưng signposted_as giá trị có thể có bản dịch.
  • Độ ổn định. Trường platform_code thay đổi ít thường xuyên hơn nhiều so với trường signposted_as.
stops.txt vehicle_type Số nguyên Không bắt buộc

Tiện ích Google Transit.

Trường vehicle_type chỉ định loại xe được sử dụng tại một điểm dừng. Trường này chấp nhận loại xe phân cấp (HVT) loại tuyến đường. Giá trị HVT được lấy từ Giao thông vận tải của Châu Âu Tiêu chuẩn Nhóm Chuyên gia về giao thức (TPEG).
agency.txt ticketing_deep_link_id Mã nhận dạng Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trong Tệp agency.txt, ticketing_deep_link_id đại diện cho liên kết sâu được dùng để bán vé cho các chuyến đi của đại lý.
routes.txt ticketing_deep_link_id Mã nhận dạng Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trong Tệp routes.txt, ticketing_deep_link_id đại diện cho liên kết sâu được dùng để bán vé cho các chuyến đi của tuyến đường.
stop_times.txt ticketing_stop_time_id Mã nhận dạng Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Nếu có trong Tệp stop_times.txt, ticketing_stop_time_id ghi đè giá trị nhận dạng thể hiện thời gian ngừng bán vé với liên kết sâu.
stop_times.txt ticketing_type Enum Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường ticketing_type chỉ định hình thức bán vé áp dụng cho thời gian dừng này.

Google Transit chấp nhận các giá trị sau:

  • Empty. Mặc định – do chuyến đi xác định.
  • 0. Chỉ có sẵn nếu đại lý hoặc tuyến đường có đường liên kết sâu bán vé đã được bật.
  • 1. Không có sẵn.
ticketing_deep_links.txt android_intent_uri URI Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường android_intent_uri biểu thị URI ý định được dùng để liên kết sâu trên Android.
ticketing_deep_links.txt ios_universal_link_url URL Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường ios_universal_link_url đại diện cho được dùng để liên kết sâu trên iOS.
ticketing_deep_links.txt ticketing_deep_link_id Mã nhận dạng Bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường ticketing_deep_link_id biểu thị giá trị nhận dạng của đường liên kết sâu.
ticketing_deep_links.txt web_url URL Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường web_url đại diện cho URL được dùng cho sâu liên kết trên web.
ticketing_identifiers.txt agency_id Mã nhận dạng Bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Để chỉ định đại lý của điểm dừng mà ticketing_stop_id mặc định được định nghĩa cho, trường agency_id chứa mã nhận dạng của GTFS agency.txt.
ticketing_identifiers.txt stop_id Mã nhận dạng Bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Để chỉ định điểm dừng mà ticketing_stop_id mặc định được định nghĩa cho, trường stop_id chứa mã nhận dạng từ GTFS stops.txt.
ticketing_identifiers.txt ticketing_stop_id Mã nhận dạng Bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Trường ticketing_stop_id chứa mã bán vé sẽ được áp dụng cho điểm dừng. Nếu muốn, một công ty quảng cáo đủ điều kiện để nhận mã này.
trips.txt exceptional Enum Không bắt buộc

Trường này biểu thị các chuyến đi đặc biệt. Họ hoạt động bên ngoài lịch trình thông thường hoặc bị chuyển hướng khỏi tuyến đường thông thường do đặc biệt các sự kiện hoặc đợt gián đoạn theo kế hoạch (chẳng hạn như hoạt động theo dõi, v.v.).

Google chấp nhận các lựa chọn về giá trị sau:

  • 0. Dịch vụ thông thường
  • 1. Trường hợp ngoại lệ về dịch vụ. Ví dụ: các dịch vụ được thêm vào do các sự kiện hoặc dịch vụ đặc biệt bị chuyển hướng khỏi tuyến đường thông thường do bị gián đoạn theo kế hoạch.
trips.txt ticketing_trip_id Mã nhận dạng Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

Nếu có trường ticketing_trip_id, giá trị của trường đó ghi đè trường trip_id để xác định chuyến đi cho bán vé bằng đường liên kết sâu.
trips.txt ticketing_type Enum Không bắt buộc

Phần mở rộng về tính năng bán vé của Google Transit.

ticketing_type chỉ định loại vé áp dụng cho chuyến đi này.

Google Transit chấp nhận các giá trị sau:

  • 0. Mặc định. Chỉ có sẵn nếu đại lý hoặc tuyến đường có đường liên kết sâu bán vé đã được bật.
  • 1. Không có sẵn.
translations.txt lang Mã ngôn ngữ Không bắt buộc

Tiện ích Google Transit.

Trường lang không thuộc GTFS chính thức, nhưng Google Phương tiện công cộng sử dụng giá trị này khi có.

Để chỉ định bản dịch cho một cụm từ, hãy sử dụng lang . Giá trị của giá trị này không được để trống hoặc und (một ngôn ngữ không xác định).
translations.txt trans_id Mã nhận dạng Không bắt buộc

Tiện ích Google Transit.

Trường trans_id không thuộc GTFS chính thức, nhưng Google Transit sử dụng giá trị này khi có.

Để chỉ định mã thông báo mã nhận dạng của cụm từ được cung cấp bản dịch để sử dụng trường trans_id. Mỗi hàng của bảng translations.txt có nghĩa là trong ngôn ngữ lang, cụm từ trans_id dịch sang translation.
trips.txt original_trip_id Mã nhận dạng Không bắt buộc

Tiện ích Google Transit.

Nếu lệnh này hiển thị trong Tệp trips.txt, giá trị original_trip_id ghi đè giá trị trip_id để các hệ thống khác sử dụng. Một ví dụ là so khớp theo thời gian thực.
trips.txt trip_direction_name Văn bản Không bắt buộc

Tiện ích Google Transit.

Trường trip_direction_name xác định thông tin chỉ đường cho hành khách. Giá trị trong trường này được lưu trữ dưới dạng direction_name giá trị của mỗi chuyến đi.

Nếu giá trị stop_direction_name trong stop_times các thay đổi của bảng trong suốt chuyến đi, nó có thể ghi đè trip_direction_name giá trị.

Các giá trị trong trường trip_direction_name là kiểu viết hoa chuẩn hoá.
trips.txt vehicle_category_id Mã nhận dạng Không bắt buộc

Tiện ích Google Transit.

Trong Tệp trips.txt, vehicle_category_id trường xác định xe được phân bổ cho chuyến đi này. Khi việc này nằm trong tệp trips.txt, giá trị của trường này sẽ ghi đè Giá trị vehicle_category_id trong tệp routes.txt.