Google 대중교통 GTFS 일정 참조 및 차이점

이 페이지에서는 다음 영역에서 사양에 대한 공식 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`	텍스트
`trips.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`	열거형	필수	값으로 `4`와 `5`는 지원되지 않으며 이 값은 무시됩니다. 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_name`과 `stop_direction_name` 필드가 둘 다 비어 있으면 대중교통 가져오기 도구에 의해 이 필드가 비워집니다. 이 경우 파트너는 `stop_headsign` 또는 `trip_headsign` 값을 대신 사용할 수 있습니다. `stop_direction_name` 필드의 값은 대소문자로 정규화됩니다.
`stops.txt`	`signposted_as`	텍스트	선택사항	Google 대중교통 확장. `signposted_as` 필드에는 플랫폼의 표지판에 기록된 텍스트가 그대로 포함됩니다. 예를 들어 '센트럴 쪽', '동쪽 및 브루클린'입니다. GTFS `platform_code` 필드와 대중교통 지원 `signposted_as` 필드를 동시에 설정할 수 있습니다. `platform_code`와 `signposted_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`	`exceptional`	열거형	선택사항	이 필드는 예외적인 이동을 나타냅니다. 특별한 상황 또는 계획된 운영 중단(예: 선로 공사)으로 인해 정규 시각표 이외의 시간에 운영하거나 평소의 경로에서 벗어납니다. Google은 다음 값 옵션을 허용합니다. `0`. 일반 서비스 `1`. 서비스 예외입니다. 예를 들어 특별한 상황으로 인해 추가된 서비스 또는 계획된 운영 중단으로 인해 평소의 경로에서 벗어난 서비스입니다.
`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` 값을 재정의합니다.