GTFS 일정과 Google 대중교통 구현 간의 차이점

이 페이지에서는 다음 영역에서 사양에 대한 공식 GTFS 일정과 Google 대중교통 구현 간의 주요 차이점을 설명합니다.

  • 무시되는 공식 사양: 이 필드는 공식 GTFS 중 일부입니다. Google 대중교통은 오류 없이 이 데이터를 수집하지만 사전에 데이터를 사용하지는 않습니다.

  • 해석의 차이: 이 필드에는 Google 대중교통에서 GTFS의 정의와 다르게 해석하는 공식 GTFS 중 일부가 포함됩니다.

  • 실험 지원: 이 필드는 Google 대중교통 구현에서 실험용입니다. 새로운 시험용 필드를 구현하려면 Google 대중교통팀에 문의하세요.

  • Google 대중교통 지원 확장: 이 확장은 공식 GTFS 중 일부가 아닙니다. 대중교통 지원 확장에는 공개 확장과 Google 대중교통 전용 확장이 모두 포함됩니다. 모든 파트너가 이 정보를 자신의 피드에서 대중교통으로 보낼 수 있습니다.

정적 대중교통

다음 섹션에서는 정적 피드에 대한 공식 GTFS와 Google 대중교통의 구현 간의 주요 차이점을 설명합니다.

정적 피드에서 무시되는 공식 사양

대중교통에서 무시되는 일부 공식 사양은 시험용입니다. 자세한 내용은 gtfs.org를 참고하세요.

표 1에는 정적 피드에서 대중교통의 지원이 적용되지 않는 GTFS 파일이 나열됩니다. 또한 이 파일에 정의된 모든 필드는 대중교통에서 지원하지 않습니다.

표 1. 정적 피드에서 지원되지 않는 GTFS 파일
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

표 2에는 정적 피드에서 대중교통에 의해 무시되는 모든 GTFS 정의 필드가 나열됩니다.

표 2. 정적 피드에서 무시되는 GTFS 필드
파일 이름 GTFS에 정의된 무시되는 필드 필드 유형
fare_attributes.txt payment_method 열거형
feed_info.txt default_lang 언어 코드
feed_info.txt feed_publisher_name 텍스트
pathways.txt max_slope 부동 소수점 수
routes.txt continuous_drop_off 열거형
routes.txt continuous_pickup 열거형
routes.txt network_id ID
routes.txt route_desc 텍스트
routes.txt route_sort_order 비음수 정수
stops.txt level_id ID
stops.txt stop_desc 텍스트
stops.txt stop_url URL
stops.txt tts_stop_name 텍스트
stops.txt bikes_allowed 열거형

정적 피드에서의 해석의 차이

대중교통은 GTFS에서 정의한 특정 필드를 허용하지만 이를 GTFS와는 다르게 해석합니다.

표 3에는 정적 피드에서 대중교통이 GTFS에 설명된 것과 다르게 구현하는 필드가 나열됩니다.

표 3. 다르게 구현된 정적 피드 필드
파일 이름 GTFS에 정의된 필드 필드 유형 Google 대중교통에서의 필수 여부 Google 대중교통 구현 세부정보
fare_attributes.txt transfers 열거형 필수

Google 대중교통 확장.

공개 GTFS에서는 값을 0에서 2까지의 범위로 제한합니다. Google 대중교통은 0에서 5까지의 값을 허용합니다.

이 필드를 사용하여 해당 요금으로 허용되는 최대 환승 횟수를 설정합니다. 여기에 블록 환승(좌석 내 환승이라고도 함)은 포함되지 않습니다. 특정 요금으로 허용되는 환승 횟수를 제한하지 않으려면 transfers 필드를 비워 둡니다.

pathways.txt pathway_mode 열거형 선택사항 pathway_mode 필드가 지정된 경우, 해당 필드가 비어 있으면 Google 대중교통에서 이를 수락하고 알 수 없음으로 처리합니다.
stop_times.txt arrival_time 시간 조건부 필수 시간은 00부터 99까지의 값으로 제한되며, 이는 3일에 걸친 이동을 나타내기에 충분한 수치입니다.
transfers.txt transfer_type 열거형 필수

값으로 45는 지원되지 않으며 이 값은 무시됩니다.

Google 대중교통은 값으로 0, 1, 2, 3을 지원합니다.

trips.txt block_id ID 선택사항 자세한 내용은 블록 환승 예를 참고하세요.

정적 피드의 시험적 지원

이 카테고리의 새로운 시험용 필드를 통합하는 데 지원이 필요한 경우 Google 대중교통에 문의하세요.

정적 피드의 Google 대중교통 지원 확장

표 4에는 Google 대중교통 확장에 대한 정보가 제공됩니다. 이 필드는 공식 GTFS에 속하지 않습니다.

표 4. 지원되는 정적 피드 확장
파일 이름 필드 필드 유형 Google 대중교통에서의 필수 여부 Google 대중교통 구현 세부정보
fare_attributes.txt ic_price 부동 소수점 수 선택사항

이 Google 대중교통 확장은 일본에 있는 파트너만 사용할 수 있습니다.

ic_price 필드는 스마트 카드로 결제한 요금의 할인 금액을 나타냅니다. 이 요금에 할인이 제공되지 않거나 스마트 카드가 지원되지 않는 경우 ic_price 필드의 값은 -1이어야 합니다.

fare_rules.txt contains_route_id ID 선택사항

Google 대중교통 확장.

이 요금은 fare_id, origin_id, destination_id 열의 조합에 해당하는 모든 행의 route_id 값으로 확인된 정확한 경로 세트를 이용하는 여정에만 적용됩니다.

contains_route_id 열이 누락되었거나 이 요금의 모든 값이 null인 경우 이 매개변수에서 요금이 제한되지 않습니다. 요금에 대해 contains_route_id 필드가 할당되면 route_id 필드는 비워 두어야 합니다.

routes.txt checkin_duration 정수 선택사항

Google 대중교통 확장.

checkin_duration 필드는 승객이 예정된 출발 시간을 기준으로 체크인과 탑승을 위해 미리 도착해야 하는 권장 시간(초)을 지정합니다.

승객이 환승으로 출발 편에 연결되면 정의된 환승 시간이 checkin_duration 값을 재정의합니다.

checkin_duration 값은 일반적으로 대중교통 사업자가 제공하는 권장사항일 뿐입니다. 승객이 도착하여 차량에 탑승하려면 늦어도 언제까지 도착해야 하는지 정확하게 반영되지 않을 수 있습니다.

routes.txt route_type 열거형 필수

Google 대중교통 확장.

Google 대중교통에서 GTFS가 허용되는 route_type 값 옵션을 확장하는 방법을 알아보려면 확장 GTFS 경로 유형을 참고하세요.

stop_times.txt stop_direction_name 텍스트 선택사항

Google 대중교통 확장.

stop_direction_name 필드는 승객에게 이동 경로를 알려 줍니다. 이동 경로는 정류장에서 출발하는 direction_name 값으로 저장됩니다.

stop_direction_name 필드가 비어 있으면 대중교통 지원 trip_direction_name 필드가 대신 사용됩니다. trip_direction_namestop_direction_name 필드가 둘 다 비어 있으면 대중교통 가져오기 도구에 의해 이 필드가 비워집니다. 이 경우 파트너는 stop_headsign 또는 trip_headsign 값을 대신 사용할 수 있습니다. stop_direction_name 필드의 값은 대소문자로 정규화됩니다.

stops.txt signposted_as 텍스트 선택사항

Google 대중교통 확장.

signposted_as 필드에는 플랫폼의 표지판에 기록된 텍스트가 그대로 포함됩니다. 예를 들어 '센트럴 쪽', '동쪽 및 브루클린'입니다.

GTFS platform_code 필드와 대중교통 지원 signposted_as 필드를 동시에 설정할 수 있습니다.

platform_codesignposted_as 필드 간의 차이점은 다음과 같습니다.

  • 길이. platform_code 필드에는 일반적으로 2 또는 C와 같은 숫자나 문자가 포함됩니다.
  • 언어. platform_code 필드에는 언어가 없지만 signposted_as 값에는 번역이 적용될 수 있습니다.
  • 안정성. platform_code 필드는 signposted_as 필드에 비해 변경되는 빈도가 훨씬 낮습니다.
stops.txt vehicle_type 정수 선택사항

Google 대중교통 확장.

vehicle_type 필드는 정류장에 사용되는 교통수단의 유형을 지정합니다. 이 필드는 계층적 차량 유형(HVT) 경로 유형을 허용합니다. HVT 값은 유럽 운송 프로토콜 전문가 그룹(TPEG) 표준에서 파생됩니다.

agency.txt ticketing_deep_link_id ID 선택사항

Google 대중교통 티켓 판매 확장.

agency.txt 파일에서 ticketing_deep_link_id 필드는 이 기관이 이동에 대한 티켓을 판매하기 위해 사용하는 딥 링크를 나타냅니다.

routes.txt ticketing_deep_link_id ID 선택사항

Google 대중교통 티켓 판매 확장.

routes.txt 파일에서 ticketing_deep_link_id 필드는 이 경로의 이동에 대한 티켓을 판매하기 위해 사용되는 딥 링크를 나타냅니다.

stop_times.txt ticketing_stop_time_id ID 선택사항

Google 대중교통 티켓 판매 확장.

stop_times.txt 파일에 있는 경우 ticketing_stop_time_id 필드는 딥 링크로 티켓 판매를 위한 정차 시간을 나타내는 식별자를 재정의합니다.

stop_times.txt ticketing_type 열거형 선택사항

Google 대중교통 티켓 판매 확장.

ticketing_type 필드는 이 정차 시간에 적용되는 티켓 판매 유형을 지정합니다.

Google 대중교통에서 허용되는 값은 다음과 같습니다.

  • Empty. 이동에 의해 정의되는 기본값.
  • 0. 기관 또는 경로에 사용 설정된 티켓 판매 딥 링크가 있는 경우에만 사용 가능.
  • 1. 사용 불가.
ticketing_deep_links.txt android_intent_uri URI 선택사항

Google 대중교통 티켓 판매 확장.

android_intent_uri 필드는 Android의 딥 링크에 사용되는 인텐트 URI를 나타냅니다.

ticketing_deep_links.txt ios_universal_link_url URL 선택사항

Google 대중교통 티켓 판매 확장.

ios_universal_link_url 필드는 iOS의 딥 링크에 사용되는 범용 링크 URL을 나타냅니다.

ticketing_deep_links.txt ticketing_deep_link_id ID 필수

Google 대중교통 티켓 판매 확장.

ticketing_deep_link_id 필드는 딥 링크의 식별자를 나타냅니다.

ticketing_deep_links.txt web_url URL 선택사항

Google 대중교통 티켓 판매 확장.

web_url 필드는 웹에서 딥 링크에 사용되는 URL을 나타냅니다.

ticketing_identifiers.txt agency_id ID 필수

Google 대중교통 티켓 판매 확장.

기본 ticketing_stop_id 필드가 정의된 정류장의 기관을 지정하기 위해 agency_id 필드에 GTFS agency.txt 파일의 ID가 포함됩니다.

ticketing_identifiers.txt stop_id ID 필수

Google 대중교통 티켓 판매 확장.

기본 ticketing_stop_id 필드가 정의된 정류장을 지정하기 위해 stop_id 필드에 GTFS stops.txt 파일의 ID가 포함됩니다.

ticketing_identifiers.txt ticketing_stop_id ID 필수

Google 대중교통 티켓 판매 확장.

ticketing_stop_id 필드에는 정류장에 적용되는 티켓 판매 ID가 포함됩니다. 원하는 경우 기관에서 ID를 검증할 수 있습니다.

trips.txt ticketing_trip_id ID 선택사항

Google 대중교통 티켓 판매 확장.

ticketing_trip_id 필드가 있으면 이 필드의 값이 trip_id 필드를 재정의하여 딥 링크로 이동의 티켓 판매를 식별합니다.

trips.txt ticketing_type 열거형 선택사항

Google 대중교통 티켓 판매 확장.

ticketing_type 필드는 이 이동에 적용되는 티켓 판매 유형을 지정합니다.

Google 대중교통에서 허용되는 값은 다음과 같습니다.

  • 0. 기본값. 기관 또는 경로에 사용 설정된 티켓 판매 딥 링크가 있는 경우에만 사용 가능.
  • 1. 사용 불가.
translations.txt lang 언어 코드 선택사항

Google 대중교통 확장.

lang 필드는 공식 GTFS에 속하지 않지만 이 필드가 있는 경우 Google 대중교통에 이 값이 사용됩니다.

구문의 번역을 지정하기 위해 lang 필드를 사용합니다. 이 값은 비어 있거나 und(정의되지 않은 언어) 상태가 아니어야 합니다.

translations.txt trans_id ID 선택사항

Google 대중교통 확장.

trans_id 필드는 공식 GTFS에 속하지 않지만 이 필드가 있는 경우 Google 대중교통에 이 값이 사용됩니다.

번역이 제공되는 구문의 ID 토큰을 지정하기 위해 trans_id 필드를 사용합니다. translations.txt 표의 각 행은 lang 언어를 사용하여 trans_id 구문이 translation으로 번역됨을 의미합니다.

trips.txt original_trip_id ID 선택사항

Google 대중교통 확장.

original_trip_id 값이 trips.txt 파일에 있는 경우 이 값은 다른 시스템에서 사용할 수 있도록 trip_id 값을 재정의합니다. 실시간 매칭을 예로 들 수 있습니다.

trips.txt trip_direction_name 텍스트 선택사항

Google 대중교통 확장.

trip_direction_name 필드는 승객에게 이동 경로를 알려 줍니다. 이 필드의 값은 각 이동의 direction_name 값으로 저장됩니다.

이동 중에 stop_times 표의 stop_direction_name 값이 변경되면 trip_direction_name 값이 재정의될 수 있습니다.

trip_direction_name 필드의 값은 대소문자로 정규화됩니다.

trips.txt vehicle_category_id ID 선택사항

Google 대중교통 확장.

trips.txt 파일에서 vehicle_category_id 필드는 이 이동에 할당된 차량을 식별합니다. 이 필드가 trips.txt 파일에 있으면 그 값은 routes.txt 파일의 vehicle_category_id 값을 재정의합니다.