콘텐츠로 이동

GTFSSchedule 참조

2022년 12월 8일 개정. 자세한 내용은 개정 내역 을 참조하십시오.

이 문서는 다음을 구성하는 파일의 형식과 구조를 정의합니다.GTFS 데이터세트.

목차

  1. 문서 규칙
  2. 데이터세트 파일
  3. 파일 요구 사항
  4. 필드 정의

문서 규칙

이 문서의 키워드 "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" 및 "OPTIONAL"은 RFC 2119 에 설명된 대로 해석됩니다.

용어 정의

이 섹션에서는 이 문서 전체에서 사용되는 용어를 정의합니다.

  • 데이터 세트 - 이 사양 참조에 의해 정의된 완전한 파일 세트입니다. 데이터세트를 변경하면 데이터세트의 새 버전이 생성됩니다. 데이터 세트는 zip 파일 이름을 포함하여 공개 영구 URL에 게시해야 합니다. (예: GTFS /GTFS .zip">https://www.agency.org/GTFS /GTFS .zip ).
  • 레코드 - 단일 엔터티(예: 대중 교통 기관, 정류장, 경로 등)를 설명하는 다양한 필드 값으로 구성된 기본 데이터 구조입니다. 테이블에서 행으로 표시됩니다.
  • 필드 - 개체 또는 엔터티의 속성입니다. 테이블에서 열로 표시됩니다.
  • 필드 값 - 필드의 개별 항목입니다. 표에서 단일 셀로 표시됩니다.
  • 서비스 날짜 - 서비스 날짜는 경로 일정을 나타내는 데 사용되는 기간입니다. 서비스 날짜의 정확한 정의는 기관마다 다르지만 서비스 날짜는 종종 달력 날짜와 일치하지 않습니다. 서비스가 하루에 시작되어 다음 날 끝나는 경우 서비스 날짜는 24:00:00를 초과할 수 있습니다. 예를 들어, 금요일 08:00:00부터 토요일 02:00:00까지 실행되는 서비스는 단일 서비스 날짜에 08:00:00부터 26:00:00까지 실행되는 것으로 표시될 수 있습니다.
  • TTS(텍스트 음성 변환) 필드 - 필드는 상위 필드와 동일한 정보를 포함해야 합니다(비어 있는 경우 대체). 텍스트 음성 변환으로 읽는 것이 목표이므로 약어를 제거하거나("St"는 "Street" 또는 "Saint"로 읽어야 하고, "Elizabeth I"는 "Elizabeth first"로 읽어야 함) 또는 그대로 읽습니다("JFK 공항"은 약어로 표시됨).
  • 다리 - 라이더가 여행을 따라 한 쌍의 후속 위치 사이에서 승하차하는 여행.
  • 여정 - 출발지에서 목적지까지의 모든 구간과 환승을 포함한 전반적인 이동입니다.
  • 하위 여정 - 여정의 하위 집합을 구성하는 두 개 이상의 구간입니다.
  • 운임 상품 - 여행 비용을 지불하거나 확인하는 데 사용할 수 있는 구매 가능한 운임 상품입니다.

있음

필드 및 파일에 적용 가능한 존재 조건:

  • 필수 - 필드 또는 파일은 데이터 세트에 포함되어야 하며 각 레코드에 대한 유효한 값을 포함해야 합니다.
  • 선택 사항 - 데이터 세트에서 필드 또는 파일을 생략할 수 있습니다.
  • 조건부 필수 - 필드 또는 파일 설명에 설명된 조건에 따라 필드 또는 파일이 포함되어야 합니다.
  • 조건부 금지 - 필드 또는 파일 설명에 설명된 조건에 따라 필드 또는 파일이 포함되어서는 안 됩니다.

필드 유형

  • 색상 - 6자리 16진수로 인코딩된 색상입니다. 유효한 값을 생성하려면 https://htmlcolorcodes.com 을 참조하십시오(앞에 "#"는 포함되지 않아야 함).
    예: 흰색의 경우 FFFFFF , 검은색의 경우 000000 또는 0039A6 의 A,C,E 라인의 경우 0039A6입니다.
  • 통화 코드 - ISO 4217 알파벳 통화 코드입니다. 현재 통화 목록은 https://en.wikipedia.org/wiki/ISO_4217#Active_codes 를 참조하세요.
    예: 캐나다 달러의 경우 CAD , 유로의 경우 EUR 또는 일본 엔의 경우 JPY .
  • 통화 금액 - 통화 금액을 나타내는 십진수 값입니다. 소수점 이하 자릿수는 함께 제공되는 통화 코드에 대해 ISO 4217 에 의해 지정됩니다. 모든 재무 계산은 프로그래밍에 따라 십진수, 통화 또는 재무 계산에 적합한 기타 동등한 유형으로 처리되어야 합니다.language 데이터를 소비하는 데 사용됩니다. 통화 금액을 유동으로 처리하는 것은 계산 중 돈의 이익 또는 손실로 인해 권장되지 않습니다.
  • 날짜 - YYYYMMDD 형식의 서비스 날짜입니다. 서비스 일 내의 시간이 24:00:00를 초과할 수 있으므로 서비스 일에는 다음 날에 대한 정보가 포함될 수 있습니다.
    예: 2018년 9월 13일의 경우 20180913 .
  • 이메일 - 이메일 주소입니다.
    예: example@example.com
  • 열거형 - "설명" 열에 정의된 미리 정의된 상수 집합의 옵션입니다.
    예: route_type 필드에는 트램의 경우 0 , 지하철의 경우 1 이 포함됩니다.
  • ID - ID 필드 값은 라이더에게 표시되지 않는 내부 ID이며 UTF-8 문자의 시퀀스입니다. 인쇄 가능한 ASCII 문자만 사용하는 것이 좋습니다. ID는 파일 내에서 고유해야 하는 경우 "고유 ID"라는 레이블이 지정됩니다. 한 .txt 파일에 정의된 ID는 종종 다른 .txt 파일에서 참조됩니다. 다른 테이블의 ID를 참조하는 ID에는 "외부 ID"라는 레이블이 지정됩니다.
    예:stop_id 필드stops.txt "고유 아이디"입니다. 의 parent_station 필드stops.txt 는 "외부 ID 참조 stops. stop_idstop_id ".
  • language 코드 - IETF BCP 47language 암호. IETF BCP 47에 대한 소개는 https://www.rfc-editor.org/rfc/bcp/bcp47.txt언어 를 참조하십시오. -tags/">https://www.w3.org/International/articles/language -태그/ .
    예: 영어의 경우 en , 미국식 영어의 경우 en-US , 독일어의 경우 de
  • 위도 - 십진법 단위의 WGS84 위도입니다. 값은 -90.0보다 크거나 같고 90.0보다 작거나 같아야 합니다.
    예: 로마 콜로세움의 경우 41.890169 .
  • 경도 - 10진수 단위의 WGS84 경도입니다. 값은 -180.0보다 크거나 같고 180.0보다 작거나 같아야 합니다.
    예: 로마의 콜로세움의 경우 12.492269 입니다.
  • Float - 부동 소수점 숫자입니다.
  • 정수 - 정수입니다.
  • 전화번호 - 전화번호입니다.
  • 시간 - HH:MM:SS 형식의 시간입니다(H:MM:SS도 허용됨). 시간은 서비스 일의 "정오 빼기 12h"에서 측정됩니다(일광 절약 시간제가 변경되는 날을 제외하고 사실상 자정). 자정 이후에 발생하는 시간의 경우 여행 날짜의 HH:MM:SS 현지 시간으로 24:00:00보다 큰 값으로 시간을 입력하십시오.Schedule 시작합니다.
    예: 오후 2:30의 경우 14:30:00 또는 다음 날 오전 1:35의 경우 25:35:00 .
  • 텍스트 - 표시를 목표로 하므로 사람이 읽을 수 있어야 하는 UTF-8 문자 문자열입니다.
  • 시간대 - https://www.iana.org/time-zones 의 TZ 시간대. 시간대 이름에는 공백 문자가 포함되지 않지만 밑줄은 포함될 수 있습니다. 유효한 값 목록은 https://en.wikipedia.org/wiki/List_of_tz_zones 를 참조하세요.
    예: Asia/Tokyo , America/Los_Angeles 또는 Africa/Cairo .
  • URL - http:// 또는 https://를 포함하는 정규화된 URL과 URL의 모든 특수 문자는 올바르게 이스케이프되어야 합니다. 정규화된 URL 값을 만드는 방법에 대한 설명은 다음 https://www.w3.org/Addressing/URL/4_URI_Recommentations.html 을 참조하세요.

필드 표지판

Float 또는 Integer 필드 유형에 적용 가능한 기호:

  • 음수가 아닌 - 0보다 크거나 같음.
  • 0이 아닌 값 - 0이 아닙니다.
  • 양수 - 0보다 큽니다.

예: 음수가 아닌 부동 소수점 - 0보다 크거나 같은 부동 소수점 숫자입니다.

데이터세트 속성

데이터 세트의 기본 키 는 행을 고유하게 식별하는 필드 또는 필드 조합입니다. Primary key (*) 는 파일에 제공된 모든 필드를 사용하여 행을 고유하게 식별하는 데 사용됩니다. Primary key (none) 는 파일이 하나의 행만 허용함을 의미합니다.

예:trip_id 그리고stop_sequence 필드는 기본 키를 만듭니다.stop_times.txt .

데이터세트 속성

데이터 세트의 기본 키 는 행을 고유하게 식별하는 필드 또는 필드 조합입니다. Primary key (*) 는 파일에 제공된 모든 필드를 사용하여 행을 고유하게 식별하는 데 사용됩니다. Primary key (none) 는 파일이 하나의 행만 허용함을 의미합니다.

예:_trip_id _그리고_stop_sequence _필드는 기본 키를 만듭니다._stop_times.txt ._

데이터세트 파일

이 사양은 다음 파일을 정의합니다.

파일 이름 있음 설명
agency.txt 필수의 이 데이터세트에 표시된 서비스를 제공하는 대중교통 기관입니다.
stops.txt 필수의 차량이 승객을 태우거나 내리는 곳에서 정차합니다. 또한 역 및 역 입구를 정의합니다.
routes.txt 필수의 대중교통 노선. 경로는 라이더에게 단일 서비스로 표시되는 이동 그룹입니다.
trips.txt 필수의 각 경로에 대한 여행. 여행은 특정 기간 동안 발생하는 2개 이상의 정류장 시퀀스입니다.
stop_times.txt 필수의 각 이동에 대해 차량이 정류장에 도착하고 출발하는 시간입니다.
calendar.txt 조건부 필수 주간을 사용하여 지정된 서비스 날짜Schedule 시작 날짜와 종료 날짜가 있습니다.

조건부 필수:
- 필수의 모든 서비스 날짜가calendar_dates.txt .
- 그렇지 않으면 선택 사항입니다.
calendar_dates.txt 조건부 필수 에 정의된 서비스에 대한 예외calendar.txt .

조건부 필수:
- 필수의 만약에calendar.txt 생략됩니다. 어떤 경우에calendar_dates.txt 모든 서비스 날짜를 포함해야 합니다.
- 그렇지 않으면 선택 사항입니다.
fare_attributes.txt 선택 과목 대중 교통 기관의 경로에 대한 요금 정보입니다.
fare_rules.txt 선택 과목 여정에 요금을 적용하는 규칙입니다.
fare_media.txt 선택 과목 운임 상품을 사용하기 위해 사용할 수 있는 운임 매체를 설명합니다.

fare_media.txt 파일에는 표현되지 않은 개념이 설명되어 있습니다.fare_attributes.txt그리고fare_rules.txt. 따라서 fare_media.txt 의 사용은 파일과 완전히 별개입니다.fare_attributes.txt 그리고fare_rules.txt .
fare_products.txt 선택 과목 승객이 구매할 수 있는 다양한 유형의 티켓 또는 요금을 설명합니다.

파일fare_products.txt 에 표시되지 않은 운임 상품을 설명합니다.fare_attributes.txt 그리고fare_rules.txt . 이와 같이 사용fare_products.txt 파일과 완전히 별개입니다.fare_attributes.txt 그리고fare_rules.txt .
fare_leg_rules.txt 선택 과목 개별 여행 구간에 대한 운임 규정.

파일fare_leg_rules.txt 요금 구조를 모델링하기 위한 보다 자세한 방법을 제공합니다. 이와 같이 사용fare_leg_rules.txt 파일과 완전히 별개입니다.fare_attributes.txt 그리고fare_rules.txt .
fare_transfer_rules.txt 선택 과목 구간 간 환승에 대한 운임 규정.

와 함께fare_leg_rules.txt , 파일fare_transfer_rules.txt 요금 구조를 모델링하기 위한 보다 자세한 방법을 제공합니다. 이와 같이 사용fare_transfer_rules.txt 파일과 완전히 별개입니다.fare_attributes.txt 그리고fare_rules.txt .
areas.txt 선택 과목 위치의 영역 그룹화.
stop_areas.txt 선택 과목 지역에 정류장을 지정하는 규칙.
shapes.txt 선택 과목 경로 정렬이라고도 하는 차량 이동 경로 매핑에 대한 규칙입니다.
frequencies.txt 선택 과목 차간 기반 서비스에 대한 차간(이동 사이의 시간) 또는 고정된 서비스의 압축된 표현Schedule 서비스.
transfers.txt 선택 과목 노선 간 환승 지점에서 연결하기 위한 규칙입니다.
pathways.txt 선택 과목 스테이션 내 위치를 함께 연결하는 경로.
levels.txt 조건부 필수 스테이션 내의 레벨.

조건부 필수:
- 필수의 엘리베이터가 있는 경로를 설명할 때(pathway_mode=5 ).
- 그렇지 않으면 선택 사항입니다.
translations.txt 선택 과목 고객 대면 데이터 세트 값의 번역.
feed_info.txt 선택 과목 게시자, 버전 및 만료 정보를 포함한 데이터세트 메타데이터.
attributions.txt 선택 과목 데이터 세트 속성.

파일 요구 사항

데이터세트 파일의 형식과 내용에는 다음 요구 사항이 적용됩니다.

  • 모든 파일은 쉼표로 구분된 텍스트로 저장해야 합니다.
  • 각 파일의 첫 번째 줄에는 필드 이름이 포함되어야 합니다. 필드 정의 섹션의 각 하위 섹션은 다음 파일 중 하나에 해당합니다.GTFS 데이터세트 및 해당 파일에서 사용할 수 있는 필드 이름을 나열합니다.
  • 모든 파일 및 필드 이름은 대소문자를 구분합니다.
  • 필드 값은 탭, 캐리지 리턴 또는 새 줄을 포함할 수 없습니다.
  • 따옴표 또는 쉼표가 포함된 필드 값은 따옴표로 묶어야 합니다. 또한 필드 값의 각 따옴표 앞에는 따옴표가 있어야 합니다. 이는 Microsoft Excel에서 CSV(쉼표로 구분된) 파일을 출력하는 방식과 일치합니다. CSV 파일 형식에 대한 자세한 내용은 https://tools.ietf.org/html/rfc4180 을 참조하십시오.

다음 예는 필드 값이 쉼표로 구분된 파일에 표시되는 방식을 보여줍니다.

  • 원래 필드 값: Contains "quotes", commas and text
  • CSV 파일의 필드 값: "Contains ""quotes"", commas and text"
  • 필드 값에는 HTML 태그, 주석 또는 이스케이프 시퀀스가 포함되어서는 안 됩니다.
  • 필드 또는 필드 이름 사이의 추가 공백은 제거해야 합니다. 많은 파서는 공백을 값의 일부로 간주하므로 오류가 발생할 수 있습니다.
  • 각 줄은 CRLF 또는 LF 줄바꿈 문자로 끝나야 합니다.
  • 모든 유니코드 문자를 지원하려면 파일을 UTF-8로 인코딩해야 합니다. 유니코드 BOM(바이트 순서 표시) 문자가 포함된 파일을 사용할 수 있습니다. BOM 문자 및 UTF-8에 대한 자세한 내용은 https://unicode.org/faq/utf_bom.html#BOM 을 참조하세요.
  • 모든 데이터세트 파일은 함께 압축해야 합니다.

필드 정의

agency.txt

파일: 필수

기본 키(agency_id )

분야 명 유형 있음 설명
agency_id 고유 ID 조건부 필수 대중 교통 기관과 동의어인 대중 교통 브랜드를 식별합니다. 단일 대행사에서 여러 개의 별도 서비스를 운영하는 경우와 같이 대행사와 브랜드가 서로 다른 경우도 있습니다. 이 문서에서는 "브랜드" 대신 "대행사"라는 용어를 사용합니다. 데이터 세트에는 여러 기관의 데이터가 포함될 수 있습니다.

조건부 필수:
- 필수의 데이터 세트에 여러 대중 교통 기관에 대한 데이터가 포함된 경우.
- 그렇지 않으면 선택 사항입니다.
agency_name 텍스트 필수의 대중교통 기관의 전체 이름입니다.
agency_url URL 필수의 대중교통 기관의 URL입니다.
agency_timezone 시간대 필수의 대중교통 기관이 위치한 시간대입니다. 데이터세트에 여러 대행사가 지정된 경우 각각은 동일해야 합니다.agency_timezone .
agency_lang language 암호 선택 과목 주요한language 이 교통 기관에서 사용합니다. 도움이 되도록 제공되어야 함GTFS 소비자는 대문자 규칙 및 기타를 선택합니다.language - 데이터 세트에 대한 특정 설정.
agency_phone 전화 번호 선택 과목 지정된 기관의 음성 전화 번호입니다. 이 필드는 해당 기관의 서비스 지역에 대한 일반적인 전화 번호를 나타내는 문자열 값입니다. 숫자의 자릿수를 그룹화하기 위해 구두점이 포함될 수 있습니다. 다이얼 가능한 텍스트(예: TriMet의 "503-238-RIDE")는 허용되지만 필드에는 다른 설명 텍스트가 포함되어서는 안 됩니다.
agency_fare_url URL 선택 과목 승객이 온라인으로 해당 대행사의 티켓 또는 기타 요금 수단을 구매할 수 있는 웹 페이지의 URL입니다.
agency_email 이메일 선택 과목 대행사의 고객 서비스 부서에서 적극적으로 모니터링하는 이메일 주소입니다. 이 이메일 주소는 대중교통 이용객이 대행사의 고객 서비스 담당자에게 연락할 수 있는 직접 연락 지점이어야 합니다.

stops.txt

파일: 필수

기본 키(stop_id )

분야 명 유형 있음 설명
stop_id 고유 ID 필수의 위치 식별: 정류장/플랫폼, 역, 입구/출구, 일반 노드 또는 탑승 구역(참조location_type ).

여러 경로가 동일한 것을 사용할 수 있습니다.stop_id .
stop_code 텍스트 선택 과목 라이더의 위치를 식별하는 짧은 텍스트 또는 숫자. 이 코드는 전화 기반 대중 교통 정보 시스템에서 자주 사용되거나 라이더가 특정 위치에 대한 정보를 더 쉽게 얻을 수 있도록 표지판에 인쇄됩니다. 그만큼stop_code 와 같을 수 있습니다stop_id 그것이 공개적인 경우. 라이더에게 코드가 제공되지 않는 위치의 경우 이 필드를 비워 두어야 합니다.
stop_name 텍스트 조건부 필수 위치의 이름입니다. 그만큼stop_name 시간표에 인쇄되거나 온라인에 게시되거나 간판에 표시된 위치에 대한 기관의 탑승자 이름과 일치해야 합니다. 다른 언어로 번역하려면 다음을 사용하십시오.translations.txt .

위치가 탑승 장소인 경우(location_type=4 ),stop_name 대행사에서 표시한 탑승 구역의 이름을 포함해야 합니다. 하나의 문자(일부 유럽 도시 간 철도역과 같이) 또는 "휠체어 탑승 구역"(NYC의 지하철) 또는 "단거리 열차의 수장"(파리의 RER)과 같은 텍스트일 수 있습니다.

조건부 필수:
- 필수의 정류장이 있는 위치의 경우(location_type=0 ), 역(location_type=1 ) 또는 입구/출구(location_type=2 ).
- 일반 노드인 위치의 경우 선택 사항(location_type=3 ) 또는 탑승 구역(location_type=4 ).
tts_stop_name 텍스트 선택 과목 읽을 수 있는 버전stop_name . "텍스트 음성 변환 필드"를 참조하십시오. 용어 정의 이상.
stop_desc 텍스트 선택 과목 유용한 양질의 정보를 제공하는 위치에 대한 설명입니다. 의 중복이 아니어야 합니다.stop_name .
stop_lat 위도 조건부 필수 위치의 위도입니다.

정류장/플랫폼(location_type=0 ) 및 탑승 구역(location_type=4 ), 좌표는 버스 기둥(있는 경우)과 여행자가 차량에 탑승하는 위치(차량이 정차하는 도로 또는 선로가 아닌 인도 또는 플랫폼)의 좌표여야 합니다.

조건부 필수:
- 필수의 정류장이 있는 위치의 경우(location_type=0 ), 역(location_type=1 ) 또는 입구/출구(location_type=2 ).
- 일반 노드인 위치의 경우 선택 사항(location_type=3 ) 또는 탑승 구역(location_type=4 ).
stop_lon 경도 조건부 필수 위치의 경도입니다.

정류장/플랫폼(location_type=0 ) 및 탑승 구역(location_type=4 ), 좌표는 버스 기둥(있는 경우)과 여행자가 차량에 탑승하는 위치(차량이 정차하는 도로 또는 선로가 아닌 인도 또는 플랫폼)의 좌표여야 합니다.

조건부 필수:
- 필수의 정류장이 있는 위치의 경우(location_type=0 ), 역(location_type=1 ) 또는 입구/출구(location_type=2 ).
- 일반 노드인 위치의 경우 선택 사항(location_type=3 ) 또는 탑승 구역(location_type=4 ).
zone_id ID 조건부 필수 정류장의 요금 구역을 식별합니다. 이 레코드가 역 또는 역 입구를 나타내는 경우zone_id 무시됩니다.

조건부 필수:
- 필수의 이용하여 요금정보를 제공하는 경우fare_rules.txt
- 그렇지 않으면 선택 사항입니다.
stop_url URL 선택 과목 위치에 대한 웹페이지의 URL입니다. 이것은 다음과 달라야 합니다.agency.agency_url 그리고routes.route_url 필드 값.
location_type 열거 선택 과목 위치 유형. 유효한 옵션은 다음과 같습니다.

0 (또는 공백) - 중지 (또는 플랫폼 ). 승객이 대중교통 차량에 탑승하거나 하차하는 위치. 내에서 정의될 때 플랫폼이라고 합니다.parent_station .
1 - . 하나 이상의 플랫폼을 포함하는 물리적 구조 또는 영역입니다.
2 - 입구/출구 . 승객이 거리에서 역에 출입할 수 있는 위치. 입구/출구가 여러 스테이션에 속해 있는 경우 두 스테이션 모두에 대한 경로로 연결될 수 있지만 데이터 제공자는 그 중 하나를 상위 스테이션으로 선택해야 합니다.
3 - 일반 노드 . 역 내 위치, 다른 위치와 일치하지 않음location_type 에서 정의하는 경로를 함께 연결하는 데 사용할 수 있습니다.pathways.txt .
4 - 탑승 구역 . 승객이 차량에 탑승 및/또는 내릴 수 있는 플랫폼의 특정 위치입니다.
parent_station 외국 신분증 참조stops.stop_id 조건부 필수 에 정의된 서로 다른 위치 간의 계층 구조를 정의합니다.stops.txt . 여기에는 다음과 같이 상위 위치의 ID가 포함됩니다.

- 정류장/플랫폼 (location_type=0 ):parent_station 필드에는 스테이션의 ID가 포함됩니다.
- (location_type=1 ): 이 필드는 비어 있어야 합니다.
- 입구/출구 (location_type=2 ) 또는 일반 노드 (location_type=3 ):parent_station 필드에는 스테이션의 ID가 포함됩니다(location_type=1 )
- 탑승 구역 (location_type=4 ):parent_station 필드에는 플랫폼의 ID가 포함됩니다.

조건부 필수:
- 필수의 입구인 위치의 경우(location_type=2 ), 일반 노드(location_type=3 ) 또는 탑승 구역(location_type=4 ).
- 정류장/플랫폼 옵션(location_type=0 ).
- 역 금지(location_type=1 ).
stop_timezone 시간대 선택 과목 위치의 시간대입니다. 위치에 상위 스테이션이 있는 경우 자체 시간대를 적용하는 대신 상위 스테이션의 시간대를 상속합니다. 비어 있는 역 및 부모 없는 정류장stop_timezone 에 의해 지정된 시간대를 상속합니다.agency.agency_timezone . 만약에stop_timezone 값이 제공되고 시간이stop_times.txt 지정된 시간대의 자정 이후 시간으로 입력해야 합니다.agency.agency_timezone . 이렇게 하면 여행이 교차하는 시간대에 관계없이 여행의 시간 값이 여행 과정에서 항상 증가합니다.
wheelchair_boarding 열거 선택 과목 해당 위치에서 휠체어 탑승 가능 여부를 나타냅니다. 유효한 옵션은 다음과 같습니다.

부모가 없는 정류장의 경우:
0 또는 비어 있음 - 정류장에 대한 접근성 정보가 없습니다.
1 - 이 정류장의 일부 차량은 휠체어 사용자가 탑승할 수 있습니다.
2 - 이 정류장에서는 휠체어 탑승이 불가능합니다.

어린이 정류장:
0 또는 비어 있음 - Stop은 해당 항목을 상속합니다.wheelchair_boarding 상위 스테이션에서 지정된 경우 상위 스테이션의 동작입니다.
1 - 역 외부에서 특정 정류장/플랫폼까지 접근 가능한 경로가 있습니다.
2 - 역 외부에서 특정 정류장/플랫폼까지 접근 가능한 경로가 없습니다.

역 입구/출구:
0 또는 비어 있음 - 역 입구는wheelchair_boarding 상위 스테이션에 대해 지정된 경우 상위 스테이션의 동작입니다.
1 - 역 입구는 휠체어 접근이 가능합니다.
2 - 역 입구에서 정류장/플랫폼까지 접근 가능한 경로가 없습니다.
level_id 외국 신분증 참조levels.level_id 선택 과목 위치의 수준입니다. 연결되지 않은 여러 스테이션에서 동일한 레벨을 사용할 수 있습니다.
platform_code 텍스트 선택 과목 플랫폼 정류장의 플랫폼 식별자(역에 속한 정류장). 이것은 플랫폼 식별자(예: "G" 또는 "3")여야 합니다. "플랫폼" 또는 "트랙"(또는 피드의language -특정 등가물)이 포함되어서는 안 됩니다. 이를 통해 피드 소비자는 플랫폼 식별자를 다른 언어로 보다 쉽게 국제화하고 현지화할 수 있습니다.

routes.txt

파일: 필수

기본 키(route_id )

분야 명 유형 있음 설명
route_id 고유 ID 필수의 경로를 식별합니다.
agency_id 외국 신분증 참조agency.agency_id 조건부 필수 지정된 경로에 대한 대행사입니다.

조건부 필수:
- 필수의 여러 기관이 정의된 경우agency.txt .
- 그렇지 않으면 선택 사항입니다.
route_short_name 텍스트 조건부 필수 경로의 짧은 이름입니다. 종종 라이더가 경로를 식별하는 데 사용하는 짧고 추상적인 식별자(예: "32", "100X", "Green")입니다. 둘 다route_short_name 그리고route_long_name 정의할 수 있습니다.

조건부 필수:
- 필수의 만약에routes.route_long_name 비었다.
- 그렇지 않으면 선택 사항입니다.
route_long_name 텍스트 조건부 필수 경로의 전체 이름입니다. 이 이름은 일반적으로route_short_name 그리고 종종 경로의 목적지 또는 정류장을 포함합니다. 둘 다route_short_name 그리고route_long_name 정의할 수 있습니다.

조건부 필수:
- 필수의 만약에routes.route_short_name 비었다.
- 그렇지 않으면 선택 사항입니다.
route_desc 텍스트 선택 과목 유용한 양질의 정보를 제공하는 경로에 대한 설명입니다. 의 중복이 아니어야 합니다. route_short_name 또는route_long_name .
* 예: "A" 열차는 맨해튼의 Inwood-207 St와 Queens의 Far Rockaway-Mott Avenue 사이를 항상 운행합니다. 또한 오전 6시부터 자정까지 추가 "A" 열차가 Inwood-207 St와 Lefferts Boulevard 사이에서 운행됩니다(기차는 일반적으로 Lefferts Blvd와 Far Rockaway 사이를 번갈아 운행합니다). *
route_type 열거 필수의 경로에서 사용되는 교통 수단의 유형을 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 - 트램, 전차, 경전철. 대도시 지역 내의 모든 경전철 또는 거리 수준 시스템.
1 - 지하철, 지하철. 수도권 내의 모든 지하 철도 시스템.
2 - 철도. 시외 또는 장거리 여행에 사용됩니다.
3 - 버스. 단거리 및 장거리 버스 노선에 사용됩니다.
4 - 페리. 단거리 및 장거리 보트 서비스에 사용됩니다.
5 - 케이블 트램. 케이블이 차량 아래로 흐르는 거리 수준의 철도 차량에 사용됩니다(예: 샌프란시스코의 케이블카).
6 - 공중 리프트, 매달린 케이블카(예: 곤돌라 리프트, 공중 트램웨이). 캐빈, 자동차, 곤돌라 또는 개방형 의자가 하나 이상의 케이블로 매달려 있는 케이블 운송.
7 - 푸니쿨라. 가파른 경사를 위해 설계된 모든 철도 시스템.
11 - 무궤도 전차. 기둥을 사용하여 가공 전선에서 전력을 끌어오는 전기 버스.
12 - 모노레일. 선로가 단일 레일 또는 빔으로 구성된 철도.
route_url URL 선택 과목 특정 경로에 대한 웹 페이지의 URL입니다. 와 달라야 한다.agency.agency_url 값.
route_color 색깔 선택 과목 공공 대면 재료와 일치하는 경로 색상 지정. 기본값은 흰색(FFFFFF ) 생략되거나 비어 있는 경우. 사이의 색상 차이route_color 그리고route_text_color 흑백 화면에서 볼 때 충분한 대비를 제공해야 합니다.
route_text_color 색깔 선택 과목 배경에 그려진 텍스트에 사용할 가독성 있는 색상route_color . 기본값은 검은색(000000 ) 생략되거나 비어 있는 경우. 사이의 색상 차이route_color 그리고route_text_color 흑백 화면에서 볼 때 충분한 대비를 제공해야 합니다.
route_sort_order 음이 아닌 정수 선택 과목 고객에게 제시하기에 이상적인 방식으로 경로를 주문합니다. 더 작은 경로route_sort_order 값이 먼저 표시되어야 합니다.
continuous_pickup 열거 선택 과목 라이더가 다음에 설명된 대로 차량의 이동 경로를 따라 어느 지점에서나 대중교통 차량에 탑승할 수 있음을 나타냅니다.shapes.txt , 경로의 모든 여행에서. 유효한 옵션은 다음과 같습니다.

0 - 연속 정지 픽업.
1 또는 비어 있음 - 연속 중지 픽업 없음.
2 - 연속 정차 픽업을 예약하려면 에이전시에 전화해야 합니다.
3 - 연속 정차 픽업을 위해 운전자와 협의해야 합니다.

routes.continuous_pickup 값을 정의하여 재정의할 수 있습니다.stop_times.continuous_pickup 특정stop_time 경로를 따라 s.
continuous_drop_off 열거 선택 과목 라이더가 다음에 설명된 대로 차량의 이동 경로를 따라 어느 지점에서든 운송 차량에서 내릴 수 있음을 나타냅니다.shapes.txt , 경로의 모든 여행에서. 유효한 옵션은 다음과 같습니다.

0 - 연속 정지 하차.
1 또는 비어 있음 - 연속 정지 드롭오프가 없습니다.
2 - 연속 정차 하차를 예약하려면 에이전시에 전화해야 합니다.
3 - 연속 정차 하차를 조정하기 위해 운전자와 협력해야 합니다.

routes.continuous_drop_off 값을 정의하여 재정의할 수 있습니다.stop_times.continuous_drop_off 특정stop_time 경로를 따라 s.
network_id ID 선택 과목 경로 그룹을 식별합니다. 여러 행routes.txt 같은 것을 가질 수 있습니다network_id .

trips.txt

파일: 필수

기본 키(trip_id )

분야 명 유형 있음 설명
route_id 외국 신분증 참조routes.route_id 필수의 경로를 식별합니다.
service_id 외국 신분증 참조calendar.service_id 또는calendar_dates.service_id 필수의 하나 이상의 경로에 대해 서비스를 사용할 수 있는 날짜 집합을 식별합니다.
trip_id 고유 ID 필수의 여행을 식별합니다.
trip_headsign 텍스트 선택 과목 라이더에게 여행의 목적지를 식별하는 표지판에 나타나는 텍스트. 동일한 경로에서 서로 다른 서비스 패턴을 구별하는 데 사용해야 합니다.

여행 중 헤드 사인이 변경되면 값은trip_headsign 값을 정의하여 재정의할 수 있습니다.stop_times.stop_headsign 특정stop_time 여행을 따라 s.
trip_short_name 텍스트 선택 과목 예를 들어 통근 열차 운행을 위한 열차 번호를 식별하기 위해 승객의 이동을 식별하는 데 사용되는 공개 텍스트입니다. 라이더가 일반적으로 여행 이름에 의존하지 않는 경우,trip_short_name 비어 있어야 합니다. ㅏtrip_short_name 값이 제공되는 경우 서비스 날짜 내 여행을 고유하게 식별해야 합니다. 목적지 이름 또는 제한/특급 지정에 사용해서는 안 됩니다.
direction_id 열거 선택 과목 여행의 이동 방향을 나타냅니다. 이 필드는 라우팅에 사용하면 안 됩니다. 시간표를 게시할 때 방향별로 여행을 구분하는 방법을 제공합니다. 유효한 옵션은 다음과 같습니다.

0 - 한 방향으로 여행합니다(예: 아웃바운드 여행).
1 - 반대 방향으로 이동합니다(예: 인바운드 이동).
예:trip_headsign 그리고direction_id 필드를 함께 사용하여 일련의 이동에 대해 각 방향으로 이동하는 이름을 지정할 수 있습니다. ㅏtrips.txt 파일에는 시간표에 사용하기 위해 다음 레코드가 포함될 수 있습니다.
trip_id,...,trip_headsign,direction_id
1234,...,Airport,0
1505,...,Downtown,1
block_id ID 선택 과목 여행이 속한 블록을 식별합니다. 블록은 동일한 차량을 사용하여 단일 이동 또는 여러 개의 연속 이동으로 구성되며 공유 서비스 날짜 및block_id . ㅏblock_id 서비스 요일이 다른 여행이 있을 수 있으며, 별개의 블록을 만들 수 있습니다. 참조 아래 예
shape_id 외국 신분증 참조shapes.shape_id 조건부 필수 여행을 위한 차량 이동 경로를 설명하는 지리 공간적 모양을 식별합니다.

조건부 필수:
- 필수의 여행에 연속 픽업 또는 하차 동작이 정의된 경우routes.txt 또는 안에stop_times.txt .
- 그렇지 않으면 선택 사항입니다.
wheelchair_accessible 열거 선택 과목 휠체어 접근성을 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 여행에 대한 접근성 정보가 없습니다.
1 - 이 특정 여행에 사용되는 차량은 휠체어에 적어도 한 명의 라이더를 수용할 수 있습니다.
2 - 이 여행에는 휠체어를 탄 승객이 탑승할 수 없습니다.
bikes_allowed 열거 선택 과목 자전거 허용 여부를 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 여행에 대한 자전거 정보가 없습니다.
1 - 이 특정 여행에 사용되는 차량은 최소 한 대의 자전거를 수용할 수 있습니다.
2 - 이 여행에는 자전거가 허용되지 않습니다.

예: 차단 및 서비스 날짜

아래 예는 요일마다 고유한 블록이 있는 유효합니다.

route_id trip_id service_id block_id (첫 번째 중지 시간) (마지막 중지 시간)
빨간색 여행_1 월-화-수-목-금-토-일 red_loop 22:00:00 22:55:00
빨간색 여행_2 금토일 red_loop 23:00:00 23:55:00
빨간색 여행_3 금-토 red_loop 24:00:00 24:55:00
빨간색 여행_4 월-화-수-목 red_loop 20:00:00 20:50:00
빨간색 여행_5 월-화-수-목 red_loop 21:00:00 21:50:00

위 표에 대한 참고 사항:

  • 예를 들어 금요일부터 토요일 아침까지 단일 차량이 trip_1 , trip_2trip_3 (오후 10시 \~ 오전 12시 55분)을 운행합니다. 마지막 이동은 토요일 오전 12:00\~12:55에 발생하지만 시간이 24:00:00\~24:55:00이므로 금요일 "서비스 일"의 일부입니다.
  • 월,화,수,목요일 오후 8시부터 10시 55분까지 한 블록의 trip_1 , trip_4 , trip_5 를 차량 한 대가 운행합니다.

stop_times.txt

파일: 필수

기본 키(trip_id ,stop_sequence )

분야 명 유형 있음 설명
trip_id 외국 신분증 참조trips.trip_id 필수의 여행을 식별합니다.
arrival_time 시간 조건부 필수 정류장에 도착하는 시간(에 의해 정의됨stop_times.stop_id ) 특정 여행(에 의해 정의됨stop_times.trip_id ).

정류장에 도착과 출발 시간이 분리되어 있지 않은 경우,arrival_time 그리고departure_time 동일해야합니다.

운행일 자정 이후에 발생하는 시간의 경우 운행일의 HH:MM:SS 현지 시간으로 24:00:00보다 큰 값으로 시간을 입력하십시오.Schedule 시작합니다.

정확한 도착 및 출발 시간(timepoint=1 또는 비어 있음)을 사용할 수 없음, 예상 또는 보간된 도착 및 출발 시간(timepoint=0 )를 제공해야 합니다.

조건부 필수:
- 필수의 여행의 첫 번째이자 마지막 정류장(에 의해 정의됨stop_times.stop_sequence ).
- 필수의 ~을 위한timepoint=1 .
- 그렇지 않으면 선택 사항입니다.
departure_time 시간 조건부 필수 정류장에서 출발 시간(에 의해 정의stop_times.stop_id ) 특정 여행(에 의해 정의됨stop_times.trip_id ).

정류장에 도착과 출발 시간이 분리되어 있지 않은 경우,arrival_time 그리고departure_time 동일해야합니다.

운행일 자정 이후에 발생하는 시간의 경우 운행일의 HH:MM:SS 현지 시간으로 24:00:00보다 큰 값으로 시간을 입력하십시오.Schedule 시작합니다.

정확한 도착 및 출발 시간(timepoint=1 또는 비어 있음)을 사용할 수 없음, 예상 또는 보간된 도착 및 출발 시간(timepoint=0 )를 제공해야 합니다.

조건부 필수:
- 필수의 ~을 위한timepoint=1 .
- 그렇지 않으면 선택 사항입니다.
stop_id 외국 신분증 참조stops.stop_id 필수의 서비스 정류장을 식별합니다. 여행 중 서비스를 제공하는 모든 정류장에는 다음 기록이 있어야 합니다.stop_times.txt . 참조 위치는 정류장/플랫폼이어야 합니다.stops.location_type 값은 다음과 같아야 합니다.0 또는 비어 있습니다. 정류장은 동일한 여행에서 여러 번 서비스될 수 있으며 여러 여행 및 경로가 동일한 정류장에 서비스를 제공할 수 있습니다.
stop_sequence 음이 아닌 정수 필수의 특정 여행에 대한 정류장 순서. 값은 이동을 따라 증가해야 하지만 연속적일 필요는 없습니다.
예: 여행의 첫 번째 위치는stop_sequence =1 , 여행의 두 번째 위치는stop_sequence =23 , 세 번째 위치에는stop_sequence =40 , 등등.
stop_headsign 텍스트 선택 과목 라이더에게 여행의 목적지를 식별하는 표지판에 나타나는 텍스트. 이 필드는 기본값을 재정의합니다.trips.trip_headsign 정류장 사이에 헤드 사인이 바뀔 때. 전체 여행에 대해 헤드 사인이 표시되는 경우trips.trip_headsign 대신 사용해야 합니다.

stop_headsign 하나에 대해 지정된 값stop_time 이후에는 적용되지 않음stop_time 같은 여행에 있습니다. 재정의하고 싶다면trip_headsign 여러stop_time 같은 여행에서,stop_headsign 값은 각각에서 반복되어야 합니다.stop_time 열.
pickup_type 열거 선택 과목 픽업 방법을 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 정기적으로 예약된 픽업.
1 - 픽업 불가.
2 - 픽업을 예약하려면 에이전시에 전화해야 합니다.
3 - 픽업을 준비하기 위해 운전사와 협의해야 합니다.
drop_off_type 열거 선택 과목 하차 방법을 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 정기적으로 예정된 하차.
1 - 하차 불가.
2 - 하차를 주선하려면 대행사에 전화해야 합니다.
3 - 운전기사와 협의하여 하차를 준비해야 합니다.
continuous_pickup 열거 선택 과목 라이더가 다음에 설명된 대로 차량의 이동 경로를 따라 어느 지점에서나 대중교통 차량에 탑승할 수 있음을 나타냅니다.shapes.txt , 이것으로부터stop_time 다음에stop_time 여행에서stop_sequence . 유효한 옵션은 다음과 같습니다.

0 - 연속 정지 픽업.
1 또는 비어 있음 - 연속 중지 픽업 없음.
2 - 연속 정차 픽업을 예약하려면 에이전시에 전화해야 합니다.
3 - 연속 정차 픽업을 위해 운전자와 협의해야 합니다.

이 필드가 채워지면 에 정의된 모든 연속 픽업 동작을 재정의합니다.routes.txt . 이 필드가 비어 있으면stop_time 에 정의된 모든 연속 픽업 동작을 상속합니다.routes.txt .
continuous_drop_off 열거 선택 과목 라이더가 다음에 설명된 대로 차량의 이동 경로를 따라 어느 지점에서든 운송 차량에서 내릴 수 있음을 나타냅니다.shapes.txt , 이것으로부터stop_time 다음에stop_time 여행에서stop_sequence . 유효한 옵션은 다음과 같습니다.

0 - 연속 정지 하차.
1 또는 비어 있음 - 연속 정지 드롭오프가 없습니다.
2 - 연속 정차 하차를 예약하려면 에이전시에 전화해야 합니다.
3 - 연속 정차 하차를 조정하기 위해 운전자와 협력해야 합니다.

이 필드가 채워지면routes.txt . 이 필드가 비어 있으면stop_time 에 정의된 모든 지속적인 이탈 동작을 상속합니다.routes.txt .
shape_dist_traveled 음수가 아닌 부동 소수점 선택 과목 첫 번째 정류장에서 이 레코드에 지정된 정류장까지 연결된 셰이프를 따라 이동한 실제 거리입니다. 이 필드는 여행 중 두 정거장 사이에 그릴 모양의 정도를 지정합니다. 에 사용된 것과 동일한 단위여야 합니다.shapes.txt . 에 사용된 값shape_dist_traveled 와 함께 증가해야 합니다.stop_sequence ; 경로를 따라 역방향 이동을 표시하는 데 사용되어서는 안 됩니다.
예: 버스가 모양의 시작 부분에서 정류장까지 5.25km의 거리를 이동하는 경우,shape_dist_traveled =5.25 .
timepoint 열거 선택 과목 차량이 정류장의 도착 및 출발 시간을 엄격하게 준수하는지 아니면 대략적인 시간 및/또는 보간된 시간인지를 나타냅니다. 이 필드는GTFS 생산자가 보간된 정지 시간을 제공하면서 시간이 대략적인 것임을 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 - 시간은 대략적인 것으로 간주됩니다.
1 또는 비어 있음 - 시간이 정확한 것으로 간주됩니다.

calendar.txt

파일: 조건부 필수

기본 키(service_id )

분야 명 유형 있음 설명
service_id 고유 ID 필수의 하나 이상의 경로에 대해 서비스를 사용할 수 있는 날짜 집합을 식별합니다. 각service_id 값은 다음에서 고유해야 합니다.calendar.txt 파일.
monday 열거 필수의 서비스가 지정된 날짜 범위의 모든 월요일에 작동하는지 여부를 나타냅니다.start_date 그리고end_date 필드. 특정 날짜에 대한 예외는 다음 항목에 나열될 수 있습니다.calendar_dates.txt . 유효한 옵션은 다음과 같습니다.

1 - 서비스는 해당 기간의 모든 월요일에 이용 가능합니다.
0 - 해당 날짜의 월요일은 서비스가 제공되지 않습니다.
tuesday 열거 필수의 와 같은 기능을 합니다monday 화요일에 적용되는 것을 제외하고
wednesday 열거 필수의 와 같은 기능을 합니다monday 수요일 제외
thursday 열거 필수의 와 같은 기능을 합니다monday 목요일 제외
friday 열거 필수의 와 같은 기능을 합니다monday 금요일 제외
saturday 열거 필수의 와 같은 기능을 합니다monday 토요일에 적용되는 것을 제외하고.
sunday 열거 필수의 와 같은 기능을 합니다monday 일요일에 적용되는 것을 제외하고.
start_date 날짜 필수의 서비스 간격에 대한 서비스 날짜를 시작합니다.
end_date 날짜 필수의 서비스 간격에 대한 서비스 종료일. 이 서비스 날짜는 간격에 포함됩니다.

calendar_dates.txt

파일: 조건부 필수

기본 키(service_id , date )

그만큼calendar_dates.txt 테이블은 날짜별로 서비스를 명시적으로 활성화하거나 비활성화합니다. 두 가지 방법으로 사용할 수 있습니다.

  • 권장: 사용calendar_dates.txt 와 함께calendar.txt 에 정의된 기본 서비스 패턴에 대한 예외를 정의하기 위해calendar.txt . 서비스가 일반적으로 정기적이고 명시적인 날짜에 약간의 변경이 있는 경우(예: 특별 이벤트 서비스 또는 학교Schedule ), 이것은 좋은 접근 방식입니다. 이 경우 calendar_dates. service_idservice_id calendar. service_idservice_id .
  • 대안: 생략calendar.txt , 각 서비스 날짜를 지정하십시오.calendar_dates.txt . 이것은 상당한 서비스 변동을 허용하고 정상적인 주간 일정 없이 서비스를 수용합니다. 이 경우service_id 아이디입니다.
분야 명 유형 있음 설명
service_id 외국 신분증 참조calendar.service_id 또는 아이디 필수의 하나 이상의 경로에 대해 서비스 예외가 발생한 날짜 집합을 식별합니다. 각 (service_id ,date ) 쌍은 다음에서 한 번만 나타날 수 있습니다.calendar_dates.txt 사용하는 경우calendar.txt 그리고calendar_dates.txt 함께. 만약service_id 값은 둘 다에 나타납니다.calendar.txt 그리고calendar_dates.txt , 정보calendar_dates.txt 에 지정된 서비스 정보를 수정합니다.calendar.txt .
date 날짜 필수의 서비스 예외가 발생한 날짜입니다.
exception_type 열거 필수의 날짜 필드에 지정된 날짜에 서비스를 사용할 수 있는지 여부를 나타냅니다. 유효한 옵션은 다음과 같습니다.

1 - 지정된 날짜에 서비스가 추가되었습니다.
2 - 지정된 날짜에 서비스가 제거되었습니다.
예: 경로에 휴일에 사용할 수 있는 여행 세트가 있고 다른 모든 날에 사용할 수 있는 다른 여행 세트가 있다고 가정합니다. 하나service_id 정규 서비스에 해당할 수 있습니다.Schedule 그리고 또 다른service_id 휴일에 해당할 수 있습니다Schedule . 특정 공휴일에는calendar_dates.txt 파일을 사용하여 휴일에 휴일을 추가할 수 있습니다.service_id 그리고 정기 휴일을 없애기 위해service_idSchedule .

fare_attributes.txt

파일: 선택 사항

기본 키(fare_id )

버전
요금을 설명하기 위한 두 가지 모델링 옵션이 있습니다.GTFS -Fares V1은 최소 운임 정보를 설명하기 위한 레거시 옵션입니다.GTFS -Fares V2는 대행사의 요금 구조에 대한 보다 자세한 설명을 허용하는 업데이트된 방법입니다. 둘 다 데이터 세트에 존재할 수 있지만 데이터 소비자는 주어진 데이터 세트에 대해 한 가지 방법만 사용해야 합니다. 다음을 수행하는 것이 좋습니다.GTFS - 운임 V2가 우선 적용됩니다.GTFS - 운임 V1.

와 관련된 파일GTFS - 운임 V1은 다음과 같습니다.
-fare_attributes.txt
-fare_rules.txt

와 관련된 파일GTFS - 운임 V2는 다음과 같습니다.
-fare_media.txt
-fare_products.txt
-fare_leg_rules.txt
-fare_transfer_rules.txt


분야 명 유형 있음 설명
fare_id 고유 ID 필수의 운임 클래스를 식별합니다.
price 음수가 아닌 부동 소수점 필수의 에서 지정한 단위의 운임currency_type .
currency_type 통화 코드 필수의 요금 지불에 사용되는 통화입니다.
payment_method 열거 필수의 요금을 지불해야 하는 시기를 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 - 운임은 선상에서 지불합니다.
1 - 탑승 전에 요금을 지불해야 합니다.
transfers 열거 필수의 이 운임에 허용된 환승 횟수를 나타냅니다. 유효한 옵션은 다음과 같습니다.

0 - 이 운임에는 환승이 허용되지 않습니다.
1 - 라이더는 1회 환승이 가능합니다.
2 - 라이더는 두 번 환승할 수 있습니다.
비어 있음 - 무제한 전송이 허용됩니다.
agency_id 외국 신분증 참조agency.agency_id 조건부 필수 요금에 대한 관련 기관을 식별합니다.

조건부 필수:
- 필수의 여러 기관이 정의된 경우agency.txt .
- 그렇지 않으면 선택 사항입니다.
transfer_duration 음이 아닌 정수 선택 과목 전송이 만료되기 전의 시간(초)입니다. 언제transfers =0 이 필드는 티켓의 유효 기간을 나타내는 데 사용되거나 비어 있을 수 있습니다.

fare_rules.txt

파일: 선택 과목

기본 키( * )

그만큼fare_rules.txt 표는 운임 방법을 지정합니다fare_attributes.txt 일정에 적용합니다. 대부분의 요금 구조는 다음 규칙의 일부 조합을 사용합니다.

  • 요금은 출발역 또는 도착역에 따라 다릅니다.
  • 요금은 여정이 통과하는 구역에 따라 다릅니다.
  • 요금은 여정이 사용하는 경로에 따라 다릅니다.

다음을 사용하여 요금 구조를 지정하는 방법을 보여주는 예는fare_rules.txt 그리고fare_attributes.txt , GoogleTransitDataFeed 오픈 소스 프로젝트 위키에서 FareExamples 를 참조하세요.

분야 명 유형 있음 설명
fare_id 외국 신분증 참조fare_attributes.fare_id 필수의 운임 클래스를 식별합니다.
route_id 외국 신분증 참조routes.route_id 선택 과목 요금 클래스와 연결된 경로를 식별합니다. 요금 속성이 동일한 여러 경로가 있는 경우 다음에서 레코드를 생성합니다.fare_rules.txt 각 경로에 대해.
예: 운임 클래스 "b"가 "TSW" 및 "TSE" 경로에서 유효한 경우fare_rules.txt 파일에는 요금 등급에 대한 다음 레코드가 포함됩니다.
fare_id,route_id
b,TSW
b,TSE
origin_id 외국 신분증 참조stops.zone_id 선택 과목 오리진 영역을 식별합니다. 운임 클래스에 여러 출발지가 있는 경우 다음 위치에 레코드를 생성하십시오.fare_rules.txt 각각origin_id .
예: 운임 클래스 "b"가 구역 "2" 또는 구역 "8"에서 출발하는 모든 여행에 유효한 경우,fare_rules.txt 파일에는 요금 클래스에 대한 다음 레코드가 포함됩니다.
fare_id,...,origin_id
b,...,2
b,...,8
destination_id 외국 신분증 참조stops.zone_id 선택 과목 대상 영역을 식별합니다. 운임 클래스에 여러 목적지 구역이 있는 경우 다음에서 레코드를 생성하십시오.fare_rules.txt 각각destination_id .
예:origin_id 그리고destination_id 필드를 함께 사용하여 운임 클래스 "b"가 구역 3과 4 사이의 여행에 유효하고 구역 3과 5 사이의 여행에 유효함을 지정할 수 있습니다.fare_rules.txt 파일에는 요금 클래스에 대한 다음 레코드가 포함됩니다.
fare_id,...,origin_id,destination_id
b,...,3,4
b,...,3,5
contains_id 외국 신분증 참조stops.zone_id 선택 과목 지정된 운임 클래스를 사용하는 동안 탑승자가 들어갈 구역을 식별합니다. 일부 시스템에서 올바른 운임 등급을 계산하는 데 사용됩니다.
예: 요금 클래스 "c"가 구역 5, 6 및 7을 통과하는 GRT 경로의 모든 여행과 연결된 경우fare_rules.txt 다음 레코드가 포함됩니다.
fare_id,route_id,...,contains_id
c,GRT,...,5
c,GRT,...,6
c,GRT,...,7
* 왜냐하면 모든contains_id 운임이 적용되려면 구역이 일치해야 하며 구역 5와 6을 통과하지만 구역 7은 통과하지 않는 여정은 운임 등급 "c"가 없습니다. 자세한 내용은 https://code.google.com/p/googletransitdatafeed/wiki/FareExamples GoogleTransitDataFeed 프로젝트 위키에서*

fare_media.txt

파일: 선택 사항

기본 키(fare_media_id)

요금 상품을 사용하는 데 사용할 수 있는 다양한 요금 매체를 설명합니다. 요금 매체는 요금 상품의 표시 및/또는 확인에 사용되는 물리적 또는 가상 소유자입니다.

분야 명 유형 있음 설명
fare_media_id 고유 ID 필수의 운임 매체를 식별합니다.
fare_media_name 텍스트 선택 과목 운임 매체의 이름입니다.

대중교통 카드인 요금 매체의 경우(fare_media_type =2 ) 또는 모바일 앱(fare_media_type =4 ),fare_media_name 포함되어야 하며 이를 제공하는 조직에서 사용하는 탑승자용 이름과 일치해야 합니다.
fare_media_type 열거 수의 요금 매체의 유형입니다. 유효한 옵션은 다음과 같습니다.

0 - 없음. 실물 티켓이 제공되지 않은 상태에서 기사나 차장에게 현금을 지불하는 것과 같이 운임 제품 구매 또는 확인과 관련된 운임 매체가 없을 때 사용됩니다.
2 - 티켓, 패스 또는 금전적 가치가 저장된 물리적 교통 카드.
3 - cEMV(비접촉식 Europay, Mastercard 및 Visa)는 계정 기반 발권을 위한 개방형 루프 토큰 컨테이너입니다.
4 - 가상 교통 카드, 티켓, 패스 또는 금전적 가치를 저장한 모바일 앱.

fare_products.txt

파일: 선택 사항

기본 키(fare_product_id, fare_media_id)

승객이 구매할 수 있는 다양한 유형의 티켓 또는 요금을 설명합니다.

분야 명 유형 있음 설명
fare_product_id ID 필수의 운임 상품을 식별합니다.
fare_product_name 텍스트 선택 과목 승객에게 표시되는 운임 상품의 이름입니다.
fare_media_id 외국 신분증 참조 fare_media.fare_media_id 텍스트 여행 중 요금 상품을 사용하기 위해 사용할 수 있는 요금 매체를 식별합니다. 요금 fare_media_id 가비어 있는 , 운임 매체는알려지지 않은 .
amount 통화 금액 필수의 운임 제품의 비용입니다. 전송 할인을 나타내기 위해 음수일 수 있습니다. 무료인 운임 제품을 나타내기 위해 0일 수 있습니다.
currency 통화 코드 필수의 운임 제품 비용의 통화입니다.

fare_leg_rules.txt

파일: 선택 사항

기본 키(network_id network_id , from_area_id , to_area_id , fare_product_idfrom_area_id network_id , from_area_id , to_area_id , fare_product_idto_area_id network_id , from_area_id , to_area_id , fare_product_idfare_product_id )

개별 여행 구간에 대한 운임 규정.

운임fare_leg_rules.txt 라이더가 이동할 다리와 일치하는 규칙을 찾기 위해 파일의 모든 레코드를 필터링하여 쿼리해야 합니다.

구간 비용을 처리하려면:

  1. 파일fare_leg_rules.txt 여행의 특성을 정의하는 필드로 필터링해야 하며 이러한 필드는 다음과 같습니다.

  2. fare_leg_rules. network_idnetwork_id

  3. fare_leg_rules. from_area_idfrom_area_id
  4. fare_leg_rules. to_area_idto_area_id

  5. 다리가 레코드와 정확히 일치하는 경우fare_leg_rules.txt 여행의 특성에 따라 해당 기록을 처리하여 구간 비용을 결정해야 합니다.

  6. 정확히 일치하는 항목이 없으면 요금_레그_규칙에 빈 항목이 fare_leg_rules. network_idnetwork_id , fare_leg_rules. from_area_idfrom_area_id , 그리고 fare_leg_rules. to_area_idto_area_id 다리 비용을 처리하려면 다음을 확인해야 합니다.

  7. fare_leg_rules. network_idnetwork_id 에 정의된 모든 네트워크에 해당routes.txt fare_leg_rules. network_idnetwork_id
  8. fare_leg_rules. from_area_idfrom_area_id 영역에 정의된 모든 영역에 해당 areas. area_idarea_id fare_leg_rules. from_area_idfrom_area_id
  9. fare_leg_rules. to_area_idto_area_id 영역에 정의된 모든 영역에 해당 areas. area_idarea_id fare_leg_rules. to_area_idto_area_id

  10. 구간이 위에 설명된 규칙과 일치하지 않는 경우 요금을 알 수 없습니다.

분야 명 유형 있음 설명
leg_group_id ID 선택 과목 항목 그룹을 식별합니다.fare_leg_rules.txt .

간의 운임 환승 규칙을 설명하는 데 사용됩니다.fare_transfer_rules.from_leg_group_id 그리고fare_transfer_rules.to_leg_group_id .

여러 항목fare_leg_rules.txt 동일에 속할 수 있습니다fare_leg_rules.leg_group_id .

같은 항목fare_leg_rules.txt (를 포함하지 않는fare_leg_rules.leg_group_id )는 여러 개에 속해서는 안 됩니다.fare_leg_rules.leg_group_id .
network_id 외국 신분증 참조routes.network_id 선택 과목 요금 구간 규칙에 적용되는 경로 네트워크를 식별합니다.

일치하는 항목이 없는 경우fare_leg_rules.network_id 가치network_id 필터링 중, 비어 있음fare_leg_rules.network_id 기본적으로 일치합니다.

빈 항목fare_leg_rules.network_id 에 정의된 모든 네트워크에 해당routes.txt 아래 나열된 것을 제외하고fare_leg_rules.network_id
from_area_id 외국 신분증 참조areas.area_id 선택 과목 출발 지역을 식별합니다.

일치하는 항목이 없는 경우fare_leg_rules.from_area_id 가치area_id 필터링 중, 비어 있음fare_leg_rules.from_area_id 기본적으로 일치합니다.

빈 항목fare_leg_rules.from_area_id 에 정의된 모든 영역에 해당합니다.areas.area_id 아래 나열된 것을 제외하고fare_leg_rules.from_area_id
to_area_id 외국 신분증 참조areas.area_id 선택 과목 도착 지역을 식별합니다.

일치하는 항목이 없는 경우fare_leg_rules.to_area_id 가치area_id 필터링 중, 비어 있음fare_leg_rules.to_area_id 기본적으로 일치합니다.

빈 항목fare_leg_rules.to_area_id 에 정의된 모든 영역에 해당합니다.areas.area_id 아래 나열된 것을 제외하고fare_leg_rules.to_area_id
fare_product_id 외국 신분증 참조fare_products.fare_product_id 필수의 구간을 이동하는 데 필요한 운임 제품입니다.

fare_transfer_rules.txt

파일: 선택 사항

기본 키(from_leg_group_id from_leg_group_id , to_leg_group_id , fare_product_id , transfer_count , duration_limitto_leg_group_id from_leg_group_id , to_leg_group_id , fare_product_id , transfer_count , duration_limitfare_product_id from_leg_group_id , to_leg_group_id , fare_product_id , transfer_count , duration_limittransfer_count from_leg_group_id , to_leg_group_id , fare_product_id , transfer_count , duration_limitduration_limit )

에 정의된 구간 간 환승에 대한 운임 규정fare_leg_rules.txt .

다구간 여행 비용을 처리하려면:

  1. 에 정의된 해당 운임 구간 그룹fare_leg_rules.txt 라이더의 여정을 기반으로 모든 개별 여행 구간에 대해 결정해야 합니다.

  2. 파일fare_transfer_rules.txt 전송 특성을 정의하는 필드로 필터링해야 합니다. 이러한 필드는 다음과 같습니다.

  3. fare_transfer_rules. from_leg_group_idfrom_leg_group_id

  4. fare_transfer_rules. to_leg_group_idto_leg_group_id

  5. 전송이 레코드와 정확히 일치하는 경우fare_transfer_rules.txt 전송의 특성에 따라 전송 비용을 결정하기 위해 해당 레코드를 처리해야 합니다.

  6. 정확히 일치하는 항목이 없으면 빈 항목이from_leg_group_id 또는 안에to_leg_group_id 이전 비용을 처리하려면 다음을 확인해야 합니다.

  7. fare_transfer_rules. from_leg_group_idfrom_leg_group_id Fare_transfer_rules 아래에 나열된 그룹을 제외하고 fare_leg_rules.leg_group_id 아래에 정의된 모든 레그 그룹에 해당합니다 fare_transfer_rules. from_leg_group_idfrom_leg_group_id

  8. fare_transfer_rules. to_leg_group_idto_leg_group_id Fare_transfer_rules 아래에 나열된 그룹을 제외하고 fare_leg_rules.leg_group_id 아래에 정의된 모든 레그 그룹에 해당합니다 fare_transfer_rules. to_leg_group_idto_leg_group_id

  9. 이적이 위에 설명된 규칙과 일치하지 않는 경우 이적 계약이 없으며 레그는 별도의 것으로 간주됩니다.

분야 명 유형 있음 설명
from_leg_group_id 외국 신분증 참조fare_leg_rules.leg_group_id 선택 과목 이전 요금 구간 규칙 그룹을 식별합니다.

일치하는 항목이 없는 경우fare_transfer_rules.from_leg_group_id 가치leg_group_id 필터링 중, 비어 있음fare_transfer_rules.from_leg_group_id 기본적으로 일치합니다.

빈 항목fare_transfer_rules.from_leg_group_id 아래에 정의된 모든 레그 그룹에 해당fare_leg_rules.leg_group_id 아래 나열된 것을 제외하고fare_transfer_rules.from_leg_group_id
to_leg_group_id 외국 신분증 참조fare_leg_rules.leg_group_id 선택 과목 환승 후 운임 구간 규칙 그룹을 식별합니다.

일치하는 항목이 없는 경우fare_transfer_rules.to_leg_group_id 가치leg_group_id 필터링 중, 비어 있음fare_transfer_rules.to_leg_group_id 기본적으로 일치합니다.

빈 항목fare_transfer_rules.to_leg_group_id 아래에 정의된 모든 레그 그룹에 해당fare_leg_rules.leg_group_id 아래 나열된 것을 제외하고fare_transfer_rules.to_leg_group_id
transfer_count 0이 아닌 정수 조건부 금지 전송 규칙을 적용할 수 있는 연속 전송 수를 정의합니다.

유효한 옵션은 다음과 같습니다.
-1 - 제한 없음.
1 이상 - 전송 규칙이 적용될 수 있는 전송 수를 정의합니다.

하위 여정이 서로 다른 여러 레코드와 일치하는 경우transfer_count s, 다음 최소 규칙transfer_count 하위 여정의 현재 전송 횟수보다 크거나 같은 항목이 선택됩니다.

조건부 금지:
- 금지 만약에fare_transfer_rules.from_leg_group_id 같지 않다fare_transfer_rules.to_leg_group_id .
- 필수의 만약에fare_transfer_rules.from_leg_group_id 같음fare_transfer_rules.to_leg_group_id .
duration_limit 양의 정수 선택 과목 전송 기간 제한을 정의합니다.

초 단위의 정수 증분으로 표현해야 합니다.

기간 제한이 없는 경우,fare_transfer_rules.duration_limit 비어 있어야 합니다.
duration_limit_type 열거 조건부 필수 의 상대적 시작과 끝을 정의합니다.fare_transfer_rules.duration_limit .

유효한 옵션은 다음과 같습니다.
0 - 현재 구간의 출발 요금 확인과 다음 구간의 도착 요금 확인 사이.
1 - 현재 구간의 출발 요금 확인과 다음 구간의 출발 요금 확인 사이.
2 - 현재 구간의 도착 요금 확인과 다음 구간의 출발 요금 확인 사이.
3 - 현재 구간의 도착 요금 확인과 다음 구간의 도착 요금 확인 사이.

조건부 필수:
- 필수의 만약에fare_transfer_rules.duration_limit 정의됩니다.
- 금지 만약에fare_transfer_rules.duration_limit 비었다.
fare_transfer_type 열거 필수의 여정에서 구간 간 이동의 비용 처리 방법을 나타냅니다.

유효한 옵션은 다음과 같습니다.
0 - 다리에서fare_leg_rules.fare_product_id ...을 더한fare_transfer_rules.fare_product_id ; A + AB.
1 - 다리에서fare_leg_rules.fare_product_id ...을 더한fare_transfer_rules.fare_product_id 플러스 투 레그fare_leg_rules.fare_product_id ; A + AB + B.
2 -fare_transfer_rules.fare_product_id ; AB.

여정에서 여러 전송 간의 비용 처리 상호 작용:

fare_transfer_type 처리 A > B B > C 처리
0 A + AB 에스 + BC
1 A + AB + B 에스 + BC + C
2 AB 에스 + BC
여기서 S는 이전 구간 및 이전의 총 처리 비용을 나타냅니다.
fare_product_id 외국 신분증 참조fare_products.fare_product_id 선택 과목 두 운임 구간 간에 환승하는 데 필요한 운임 상품입니다. 비어 있는 경우 전송 규칙의 비용은 0입니다.

areas.txt

파일: 선택 사항

기본 키(area_id )

영역 식별자를 정의합니다.

분야 명 유형 있음 설명
area_id 고유 ID 필수의 영역을 식별합니다. 에서 고유해야 합니다.areas.txt .
area_name 텍스트 선택 과목 라이더에게 표시되는 영역의 이름입니다.

stop_areas.txt

파일: 선택 사항

기본 키( * )

다음에서 정류장 지정stops.txt 지역에.

분야 명 유형 있음 설명
area_id 외국 신분증 참조areas.area_id 필수의 하나 또는 여러 개의 영역을 식별합니다.stop_id 속합니다. 똑같다stop_id 많은 것으로 정의될 수 있다area_id 에스.
stop_id 외국 신분증 참조stops.stop_id 필수의 정류장을 식별합니다. 역인 경우(예:stops.location_type=1 )가 이 필드에 정의되어 있는 경우 해당 플랫폼의 모든 플랫폼(즉,stops.location_type=0 이 스테이션이 다음과 같이 정의됩니다.stops.parent_station ) 같은 영역에 속합니다. 이 동작은 플랫폼을 다른 영역에 할당하여 무시할 수 있습니다.

shapes.txt

파일: 선택 사항

기본 키(shape_id ,shape_pt_sequence )

모양은 차량이 경로 정렬을 따라 이동하는 경로를 설명하고 파일에 정의됩니다.shapes.txt . 모양은 Trips와 연관되어 있으며 차량이 순서대로 통과하는 일련의 점으로 구성됩니다. 셰이프는 정류장의 위치를 정확히 가로챌 필요는 없지만 여행의 모든 정류장은 해당 여행에 대한 셰이프의 작은 거리 내에 있어야 합니다. 즉, 셰이프 점을 연결하는 직선 세그먼트에 가깝습니다.

분야 명 유형 있음 설명
shape_id ID 필수의 모양을 식별합니다.
shape_pt_lat 위도 필수의 모양 점의 위도입니다. 의 각 레코드shapes.txt 모양을 정의하는 데 사용되는 모양 점을 나타냅니다.
shape_pt_lon 경도 필수의 모양 점의 경도입니다.
shape_pt_sequence 음이 아닌 정수 필수의 셰이프 포인트가 연결되어 셰이프를 형성하는 순서입니다. 값은 이동을 따라 증가해야 하지만 연속적일 필요는 없습니다.
예: "A_shp" 모양의 정의에 세 개의 점이 있는 경우shapes.txt 파일에는 모양을 정의하기 위해 다음 레코드가 포함될 수 있습니다.
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence
A_shp,37.61956,-122.48161,0
A_shp,37.64430,-122.41070,6
A_shp,37.65863,-122.30839,11
shape_dist_traveled 음수가 아닌 부동 소수점 선택 과목 첫 번째 모양 점에서 이 레코드에 지정된 점까지 모양을 따라 이동한 실제 거리입니다. 여행 계획자가 지도에 모양의 올바른 부분을 표시하는 데 사용합니다. 값은 다음과 함께 증가해야 합니다.shape_pt_sequence ; 경로를 따라 역방향 이동을 표시하는 데 사용되어서는 안 됩니다. 거리 단위는 다음에서 사용된 것과 일치해야 합니다.stop_times.txt .
예: 버스가 A_shp에 대해 위에 정의된 세 지점을 따라 이동하는 경우 추가shape_dist_traveled 값(킬로미터로 표시)은 다음과 같습니다.
shape_id,shape_pt_lat,shape_pt_lon,shape_pt_sequence,shape_dist_traveled
A_shp,37.61956,-122.48161,0,0
A_shp,37.64430,-122.41070,6,6.8310
A_shp,37.65863,-122.30839,11,15.8765

frequencies.txt

파일: 선택 사항

기본 키(trip_id ,start_time )

frequencies.txt 정기적인 운행 간격(이동 사이의 시간)으로 운행되는 운행을 나타냅니다. 이 파일은 두 가지 다른 유형의 서비스를 나타내는 데 사용할 수 있습니다.

  • 서비스가 정해진 시간을 따르지 않는 빈도 기반 서비스( exact_times = 0 )Schedule 하루 종일. 대신 운영자는 미리 정해진 이동 간격을 엄격하게 유지하려고 합니다.
  • 압축된 표현Schedule 지정된 기간 동안의 이동에 대해 정확히 동일한 진행 간격을 갖는 기반 서비스( exact_times = 1 ). \~ 안에Schedule 기반 서비스 운영자는 엄격하게 준수하려고 노력합니다.Schedule .
분야 명 유형 있음 설명
trip_id 외국 신분증 참조trips.trip_id 필수의 지정된 운행 간격이 적용되는 이동을 식별합니다.
start_time 시간 필수의 첫 번째 차량이 지정된 차간으로 이동의 첫 번째 정류장에서 출발하는 시간입니다.
end_time 시간 필수의 이동의 첫 번째 정류장에서 서비스가 다른 헤드웨이로 변경(또는 중단)되는 시간입니다.
headway_secs 양의 정수 필수의 에 의해 지정된 시간 간격 동안 여행에 대해 동일한 정류장(진행 방향)에서 출발하는 사이의 시간(초)start_time 그리고end_time . 동일한 이동에 대해 여러 간격을 정의할 수 있지만 겹치지 않아야 합니다. 새로운 헤드웨이는 이전 헤드웨이가 끝나는 정확한 시간에 시작될 수 있습니다.
exact_times 열거 선택 과목 여행에 대한 서비스 유형을 나타냅니다. 자세한 내용은 파일 설명을 참조하십시오. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 빈도 기반 이동.
1 -Schedule - 하루 종일 정확히 동일한 진행 상황을 기반으로 하는 여행. 이 경우end_time 값은 마지막으로 원하는 여행보다 커야 합니다.start_time 그러나 마지막으로 원하는 여행보다 적은start_time +headway_secs .

transfers.txt

파일: 선택 사항

기본 키(from_stop_id ,to_stop_id ,from_trip_id ,to_trip_id ,from_route_id ,to_route_id )

여정을 계산할 때,GTFS -소비 애플리케이션은 허용 시간 및 정지 근접성을 기반으로 전송을 보간합니다.transfers.txt 선택한 전송에 대한 추가 규칙 및 재정의를 지정합니다.

필드from_trip_id ,to_trip_id ,from_route_id 그리고to_route_id 전송 규칙에 대해 더 높은 차수를 허용합니다. 와 함께from_stop_id 그리고to_stop_id , 특이도의 순위는 다음과 같습니다.

  1. 둘 다trip_id 정의:from_trip_id 그리고to_trip_id .
  2. 하나trip_id 그리고route_id 정의된 집합: (from_trip_id 그리고to_route_id ) 또는 (from_route_id 그리고to_trip_id ).
  3. 하나trip_id 한정된:from_trip_id 또는to_trip_id .
  4. 둘 다route_id 정의:from_route_id 그리고to_route_id .
  5. 하나route_id 한정된:from_route_id 또는to_route_id .
  6. 뿐from_stop_id 그리고to_stop_id 정의됨: 경로 또는 여행 관련 필드가 설정되지 않았습니다.

도착 여행과 출발 여행의 지정된 순서 쌍에 대해 이 두 여행 사이에 적용되는 가장 큰 특이성을 가진 환승이 선택됩니다. 어떤 쌍의 여행에 대해서도 적용할 수 있는 동일한 최대 특이성을 가진 두 번의 전송이 있어서는 안 됩니다.

분야 명 유형 있음 설명
from_stop_id 외국 신분증 참조stops.stop_id 필수의 경로 간의 연결이 시작되는 정류장 또는 역을 식별합니다. 이 필드가 역을 참조하는 경우 환승 규칙은 모든 하위 정류장에 적용됩니다.
to_stop_id 외국 신분증 참조stops.stop_id 필수의 경로 간의 연결이 끝나는 정류장 또는 역을 식별합니다. 이 필드가 역을 나타내는 경우 환승 규칙은 모든 하위 정류장에 적용됩니다.
from_route_id 외국 신분증 참조routes.route_id 선택 과목 연결이 시작되는 경로를 식별합니다.

만약에from_route_id 지정된 경로에 도착하는 여정에 환승이 적용됩니다.from_stop_id .

만약 둘 다from_trip_id 그리고from_route_id 정의되고,trip_id 에 속해야 합니다.route_id , 그리고from_trip_id 우선합니다.
to_route_id 외국 신분증 참조routes.route_id 선택 과목 연결이 끝나는 경로를 식별합니다.

만약에to_route_id 지정된 경로로 출발하는 여행에 환승이 적용됩니다.to_stop_id .

만약 둘 다to_trip_id 그리고to_route_id 정의되고,trip_id 에 속해야 합니다.route_id , 그리고to_trip_id 우선합니다.
from_trip_id 외국 신분증 참조trips.trip_id 선택 과목 경로 간의 연결이 시작되는 이동을 식별합니다.

만약에from_trip_id 지정된 시간 동안 도착하는 여행에 환승이 적용됩니다.from_stop_id .

만약 둘 다from_trip_id 그리고from_route_id 정의되고,trip_id 에 속해야 합니다.route_id , 그리고from_trip_id 우선합니다.
to_trip_id 외국 신분증 참조trips.trip_id 선택 과목 경로 간의 연결이 끝나는 이동을 식별합니다.

만약에to_trip_id 지정된 기간 동안 출발하는 여행에 환승이 적용됩니다.to_stop_id .

만약 둘 다to_trip_id 그리고to_route_id 정의되고,trip_id 에 속해야 합니다.route_id , 그리고to_trip_id 우선합니다.
transfer_type 열거 필수의 지정된(from_stop_id ,to_stop_id ) 쌍. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 경로 간 권장 환승 지점입니다.
1 - 두 노선 사이의 정기 환승 지점. 출발하는 차량은 도착하는 차량을 기다리며 승객이 경로 간 환승에 충분한 시간을 두어야 합니다.
2 - 환승은 연결을 보장하기 위해 도착과 출발 사이에 최소한의 시간이 필요합니다. 전송에 필요한 시간은 다음과 같이 지정됩니다.min_transfer_time .
3 - 해당 지역의 노선 간 환승은 불가능합니다.
min_transfer_time 음이 아닌 정수 선택 과목 지정된 정류장에서 경로 간 환승을 허용하는 데 사용할 수 있어야 하는 시간(초)입니다. 그만큼min_transfer_time 일반적인 라이더가 두 정류장 사이를 이동할 수 있도록 충분해야 하며, 여기에는 완충 시간이 포함되어야 합니다.Schedule 각 노선의 편차.

pathways.txt

파일: 선택 사항

기본 키(pathway_id )

파일pathways.txt 그리고levels.txt 그래프 표현을 사용하여 위치를 나타내는 노드와 경로를 나타내는 모서리로 지하철이나 기차역을 설명합니다.

역 입구/출구( location_type=2 인 위치로 표시되는 노드)에서 플랫폼( location_type=0 인 위치로 표시되는 노드)으로 이동하기 위해 라이더는 보도, 개찰구, 계단, 및 경로로 표시된 다른 가장자리. 일반 노드( location_type=3 으로 표시되는 노드)는 스테이션 전체의 경로를 연결하는 데 사용할 수 있습니다.

경로는 스테이션에서 철저하게 정의되어야 합니다. 경로가 정의되면 스테이션 전체의 모든 경로가 표시되는 것으로 가정합니다. 따라서 다음 지침이 적용됩니다.

  • 매달린 위치 없음: 역 내 위치에 통로가 있는 경우 탑승 구역이 있는 플랫폼을 제외하고 해당 역 내의 모든 위치에 통로가 있어야 합니다( location_type=4 , 아래 지침 참조).
  • 탑승 구역이 있는 플랫폼에 대한 경로 없음: 탑승 구역( location_type=4 )이 있는 플랫폼( location_type=0 또는 비어 있음)은 점이 아니라 상위 개체로 처리됩니다. 이러한 경우 플랫폼에 경로가 할당되지 않아야 합니다. 모든 경로는 플랫폼의 각 탑승 구역에 할당되어야 합니다.
  • 잠긴 플랫폼 없음: 각 플랫폼( location_type=0 또는 비어 있음) 또는 탑승 구역( location_type=4 )은 일부 경로 체인을 통해 하나 이상의 입구/출구( location_type=2 )에 연결되어야 합니다. 주어진 플랫폼에서 역 외부로의 통로를 허용하지 않는 역은 드뭅니다.
분야 명 유형 있음 설명
pathway_id 고유 ID 필수의 경로를 식별합니다. 시스템에서 레코드의 내부 식별자로 사용합니다. 데이터세트에서 고유해야 합니다.

다른 경로는 동일한 값을 가질 수 있습니다.from_stop_id 그리고to_stop_id .
예: 두 개의 에스컬레이터가 반대 방향으로 나란히 있는 경우 또는 계단 세트와 엘리베이터가 같은 장소에서 같은 장소로 이동할 때 다른pathway_id 같은 것을 가질 수 있습니다from_stop_id 그리고to_stop_id 가치.
from_stop_id 외국 신분증 참조stops.stop_id 필수의 경로가 시작되는 위치입니다.

포함해야 함stop_id 플랫폼(location_type=0 또는 비어 있음), 입구/출구(location_type=2 ), 일반 노드(location_type=3 ) 또는 탑승 구역(location_type=4 ).

stop_id 스테이션을 식별하는 (location_type=1 ) 금지되어 있습니다.
to_stop_id 외국 신분증 참조stops.stop_id 필수의 경로가 끝나는 위치입니다.

포함해야 함stop_id 플랫폼(location_type=0 또는 비어 있음), 입구/출구(location_type=2 ), 일반 노드(location_type=3 ) 또는 탑승 구역(location_type=4 ).

stop_id 스테이션을 식별하는 (location_type=1 ) 금지되어 있습니다.
pathway_mode 열거 필수의 지정된(from_stop_id ,to_stop_id ) 쌍. 유효한 옵션은 다음과 같습니다.

1 - 산책로.
2 - 계단.
3 - 이동 보도/여행자.
4 - 에스컬레이터.
5 - 엘리베이터.
6 - 개찰구(또는 정산기) : 역내에서 정산증명서가 필요한 구역으로 넘어가는 통로. 개찰구는 역의 유료 구역을 무료 구역과 분리하거나 동일한 역 내에서 서로 다른 지불 구역을 분리할 수 있습니다. 이 정보는 승객이 버스 정류장에 도달하기 위해 지하철 플랫폼을 통해 걸어가도록 지시하는 것과 같이 승객이 불필요한 지불을 해야 하는 바로 가기를 사용하여 역을 통해 승객을 라우팅하는 것을 방지하는 데 사용할 수 있습니다.
7 - 출구 게이트: 유료 구역을 빠져나와 지불 증명서가 필요하지 않은 무보수 구역으로 들어가는 통로.
is_bidirectional 열거 필수의 경로를 취할 수 있는 방향을 나타냅니다.

0 - 에서만 사용할 수 있는 단방향 경로from_stop_id 에게to_stop_id .
1 - 양방향 사용이 가능한 양방향 통로.

출구 게이트(pathway_mode=7 ) 양방향이 아니어야 합니다.
length 음수가 아닌 부동 소수점 선택 과목 원점에서 경로의 수평 길이(미터)(에 정의됨from_stop_id ) 대상 위치(에 정의됨to_stop_id ).

이 필드는 산책로(pathway_mode=1 ), 개찰구(pathway_mode=6 ) 및 출구 게이트(pathway_mode=7 ).
traversal_time 양의 정수 선택 과목 원래 위치에서 경로를 통과하는 데 필요한 평균 시간(초)(from_stop_id ) 대상 위치(에 정의됨to_stop_id ).

이 필드는 인도를 이동하는 데 권장됩니다(pathway_mode=3 ), 에스컬레이터(pathway_mode=4 ) 및 엘리베이터(pathway_mode=5 ).
stair_count null이 아닌 정수 선택 과목 통로의 계단 수입니다.

긍정적 인stair_count 라이더가 걸어 올라오는 것을 의미합니다.from_stop_id 에게to_stop_id . 그리고 부정적인stair_count 라이더가 아래로 내려오는 것을 의미합니다.from_stop_id 에게to_stop_id .

이 필드는 계단(pathway_mode=2 ).

예상 계단 수만 제공할 수 있는 경우 1층에 대략 15개의 계단을 권장합니다.
max_slope 뜨다 선택 과목 경로의 최대 경사 비율입니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 경사가 없습니다.
Float - 경로의 기울기 비율, 위쪽은 양수, 아래쪽은 음수입니다.

이 필드는 통로(pathway_mode=1 ) 및 움직이는 인도(pathway_mode=3 ).
예: 미국에서 수동 휠체어의 최대 경사 비율은 0.083(8.3%로 표기됨)으로 1m당 0.083m(8.3cm)씩 증가합니다.
min_width 포지티브 플로트 선택 과목 경로의 최소 너비(미터)입니다.

이 필드는 최소 너비가 1미터 미만인 경우 권장됩니다.
signposted_as 텍스트 선택 과목 라이더가 볼 수 있는 물리적 간판의 공개 텍스트입니다.

'표지판을 따라'와 같이 라이더에게 텍스트 방향을 제공하는 데 사용할 수 있습니다. 의 텍스트singposted_as 표지판에 인쇄된 대로 정확하게 나타나야 합니다.

물리적 간판이 다국어인 경우 이 필드는 다음 예에 따라 채워지고 번역될 수 있습니다.stops.stop_name 필드 정의에서feed_info.feed_lang .
reversed_signposted_as 텍스트 선택 과목 와 동일signposted_as , 그러나 경로가 다음에서 사용되는 경우to_stop_id ~로from_stop_id .

levels.txt

파일: 조건부 필수

기본 키(level_id )

스테이션의 레벨을 설명합니다. 와 함께 유용pathways.txt , 그리고 엘리베이터로 경로를 탐색하는 데 필요합니다( pathway_mode=5 ).

분야 명 유형 있음 설명
level_id 고유 ID 필수의 스테이션의 레벨을 식별합니다.
level_index 뜨다 필수의 상대 위치를 나타내는 수준의 숫자 인덱스입니다.

지면 수준에는 색인이 있어야 합니다.0 , 지상 레벨은 양수 지수로 표시되고 지하 레벨은 음수 지수로 표시됩니다.
level_name 텍스트 선택 과목 건물이나 역 내부에서 탑승자가 보는 레벨의 이름입니다.
예: "Mezzanine" 또는 "Platform" 또는 "-1"까지 엘리베이터를 타십시오.

translations.txt

파일: 선택 사항

기본 키(table_name ,field_name ,language ,record_id ,record_sub_id ,field_value )

여러 공식 언어를 사용하는 지역에서 대중 교통 기관/운영자는 일반적으로language -특정 이름 및 웹 페이지. 해당 지역의 라이더에게 최상의 서비스를 제공하려면 데이터 세트에 다음을 포함하는 것이 유용합니다.language - 종속 값.

분야 명 유형 있음 설명
table_name 열거 필수의 번역할 필드가 포함된 테이블을 정의합니다. 허용되는 값은 다음과 같습니다.

-agency
-stops
-routes
-trips
-stop_times
-pathways
-levels
-feed_info
-attributions

추가된 모든 파일GTFS 가질 것이다table_name 위에 나열된 파일 이름과 동일한 값(즉,.txt파일 확장자).
field_name 텍스트 필수의 번역할 필드의 이름입니다. 유형이 있는 필드Text 번역될 수 있음, 유형이 있는 필드URL ,Email 그리고Phone number 올바른 리소스를 제공하기 위해 "번역"될 수도 있습니다.language . 다른 유형의 필드는 번역하면 안 됩니다.
language language 암호 필수의 language 번역의.

만약language 에서와 동일하다feed_info.feed_lang , 필드의 원래 값은 특정 번역이 없는 언어에서 사용할 기본값으로 간주됩니다(만약default_lang 달리 지정하지 않음).
예: 스위스에서 공식적으로 이중 언어를 사용하는 주에 있는 도시는 공식적으로 "Biel/Bienne"이라고 하지만 프랑스어에서는 "Bienne", 독일어에서는 "Biel"이라고 합니다.
translation 문자 또는 URL 또는 이메일 또는 전화번호 필수의 번역된 값입니다.
record_id 외국인 신분증 조건부 필수 번역할 필드에 해당하는 레코드를 정의합니다. 값record_id 각 테이블 및 아래의 기본 키 속성에 정의된 대로 테이블 기본 키의 첫 번째 또는 유일한 필드여야 합니다.

-agency_id ~을 위한agency.txt
-stop_id ~을 위한stops.txt ;
-route_id ~을 위한routes.txt ;
-trip_id ~을 위한trips.txt ;
-trip_id ~을 위한stop_times.txt ;
-pathway_id ~을 위한pathways.txt ;
-level_id ~을 위한levels.txt ;
-attribution_id ~을 위한attribution.txt .

위에 정의되지 않은 테이블의 필드는 번역되지 않아야 합니다. 그러나 생산자는 때때로 공식 사양을 벗어난 추가 필드를 추가하며 이러한 비공식 필드는 번역될 수 있습니다. 다음은 권장 사용 방법입니다.record_id 해당 테이블의 경우:

-service_id ~을 위한calendar.txt ;
-service_id ~을 위한calendar_dates.txt ;
-fare_id ~을 위한fare_attributes.txt ;
-fare_id ~을 위한fare_rules.txt ;
-shape_id ~을 위한shapes.txt ;
-trip_id ~을 위한frequencies.txt ;
-from_stop_id ~을 위한transfers.txt .

조건부 필수:
- 금지 만약에table_name ~이다feed_info .
- 금지 만약에field_value 정의됩니다.
- 필수의 만약에field_value 비었다.
record_sub_id 외국인 신분증 조건부 필수 테이블에 고유 ID가 없을 때 번역할 필드가 포함된 레코드를 돕습니다. 따라서 의 값은record_sub_id 아래 표에 정의된 대로 테이블의 보조 ID입니다.

- 없음agency.txt ;
- 없음stops.txt ;
- 없음routes.txt ;
- 없음trips.txt ;
-stop_sequence ~을 위한stop_times.txt ;
- 없음pathways.txt ;
- 없음levels.txt ;
- 없음attributions.txt .

위에 정의되지 않은 테이블의 필드는 번역되지 않아야 합니다. 그러나 생산자는 때때로 공식 사양을 벗어난 추가 필드를 추가하며 이러한 비공식 필드는 번역될 수 있습니다. 다음은 권장 사용 방법입니다.record_sub_id 해당 테이블의 경우:

- 없음calendar.txt ;
-date ~을 위한calendar_dates.txt ;
- 없음fare_attributes.txt ;
-route_id ~을 위한fare_rules.txt ;
- 없음shapes.txt ;
-start_time ~을 위한frequencies.txt ;
-to_stop_id ~을 위한transfers.txt .

조건부 필수:
- 금지 만약에table_name ~이다feed_info .
- 금지 만약에field_value 정의됩니다.
- 필수의 만약에table_name=stop_times 그리고record_id 정의됩니다.
field_value 문자 또는 URL 또는 이메일 또는 전화번호 조건부 필수 다음을 사용하여 번역해야 하는 레코드를 정의하는 대신record_id 그리고record_sub_id , 이 필드는 번역되어야 하는 값을 정의하는 데 사용할 수 있습니다. 사용 시 다음으로 식별된 필드가 번역될 때 적용됩니다.table_name 그리고field_name 에 정의된 정확히 동일한 값을 포함합니다.field_value .

필드에는 다음이 있어야 합니다. 바로 그거죠 에 정의된 값field_value . 값의 하위 집합만 일치하는 경우field_value , 번역이 적용되지 않습니다.

두 개의 번역 규칙이 동일한 레코드와 일치하는 경우(하나는field_value , 그리고 다른 하나는record_id ), 규칙record_id 우선합니다.

조건부 필수:
- 금지 만약에table_name ~이다feed_info .
- 금지 만약에record_id 정의됩니다.
- 필수의 만약에record_id 비었다.

feed_info.txt

파일: 선택 사항 ( 필요한 경우translations.txt 제공됨)

기본 키(없음)

파일에는 데이터세트가 설명하는 서비스가 아닌 데이터세트 자체에 대한 정보가 포함되어 있습니다. 어떤 경우에는 데이터 세트의 게시자가 에이전시와 다른 엔터티입니다.

두 참조 방법 모두(record_id ,record_sub_id ) 그리고field_value 2개의 다른 행에서 동일한 값을 번역하는 데 사용되며, 번역은 (record_id ,record_sub_id )가 우선합니다.

분야 명 유형 있음 설명
feed_publisher_name 텍스트 필수의 데이터세트를 게시하는 조직의 전체 이름입니다. 이것은 다음 중 하나와 같을 수 있습니다.agency.agency_name 가치.
feed_publisher_url URL 필수의 데이터세트 게시 기관 웹사이트의 URL입니다. 이것은 다음 중 하나와 같을 수 있습니다.agency.agency_url 가치.
feed_lang language 암호 필수의 기본language 이 데이터세트의 텍스트에 사용됩니다. 이 설정은 도움이 됩니다GTFS 소비자는 대문자 규칙 및 기타를 선택합니다.language - 데이터 세트에 대한 특정 설정. 파일translations.txt 텍스트가 기본 언어가 아닌 다른 언어로 번역되어야 하는 경우 사용할 수 있습니다.

기본값language 원본 텍스트가 여러 언어로 된 데이터 세트의 경우 다국어일 수 있습니다. 그러한 경우,feed_lang 필드에는 다음이 포함되어야 합니다.language 암호mul 표준 ISO 639-2에 의해 정의되고 각각에 대한 번역language 데이터 세트에 사용된translations.txt . 데이터 세트의 모든 원본 텍스트가 동일한 경우language , 그 다음에mul 사용해서는 안됩니다.
예: 스위스와 같은 다국어 국가의 데이터 세트를 고려하십시오.stops.stop_name 다른 언어로 된 정류장 이름으로 채워진 필드. 각 중지 이름은 지배적 인 순서에 따라 작성됩니다.language 해당 정류장의 지리적 위치, 예:Genève 프랑스어를 사용하는 제네바의 경우,Zürich 독일어권 도시 취리히의 경우Biel/Bienne Biel/Bienne의 이중 언어 도시. 데이터세트feed_lang 해야한다mul 번역은 다음에서 제공됩니다.translations.txt , 독일어로:Genf ,Zürich 그리고Biel ; 프랑스어:Genève ,Zurich 그리고Bienne ; 이탈리아어:Ginevra ,Zurigo 그리고Bienna ; 그리고 영어:Geneva ,Zurich 그리고Biel/Bienne .
default_lang language 암호 선택 과목 다음을 정의합니다.language 데이터 소비자가 알지 못할 때 사용해야 합니다.language 라이더의. 그것은 종종en (영어).
feed_start_date 날짜 선택 과목 데이터 세트는 완전하고 신뢰할 수 있는Schedule 서비스 개시일부터 서비스 제공에 관한 정보feed_start_date 하루가 끝날 때까지feed_end_date 낮. 사용할 수 없는 경우 두 날 모두 비어 있을 수 있습니다. 그만큼feed_end_date 날짜는 이전일 수 없습니다.feed_start_date 둘 다 주어진 경우 날짜. 데이터세트 제공자가 제공하는 것이 좋습니다.Schedule 이 기간을 벗어난 데이터는 향후 서비스 가능성에 대해 조언하지만 데이터 세트 소비자는 신뢰할 수 없는 상태를 염두에 두고 처리해야 합니다. 만약에feed_start_date 또는feed_end_date 에 정의된 활성 달력 날짜 이상으로 연장calendar.txt 그리고calendar_dates.txt , 데이터 세트는 해당 기간 내에 날짜에 대한 서비스가 없다는 명시적인 주장을 하고 있습니다.feed_start_date 또는feed_end_date 범위이지만 활성 달력 날짜에는 포함되지 않습니다.
feed_end_date 날짜 선택 과목 (위 참조)
feed_version 텍스트 선택 과목 현재 버전을 나타내는 문자열GTFS 데이터세트.GTFS -소비 응용 프로그램은 데이터 집합 게시자가 최신 데이터 집합이 통합되었는지 여부를 결정하는 데 도움이 되도록 이 값을 표시할 수 있습니다.
feed_contact_email 이메일 선택 과목 관련 커뮤니케이션을 위한 이메일 주소GTFS 데이터세트 및 데이터 게시 관행.feed_contact_email 에 대한 기술 담당자입니다.GTFS - 소모 애플리케이션. 통해 고객 서비스 연락처 정보 제공agency.txt .
feed_contact_url URL 선택 과목 연락처 정보 URL, 웹 양식, 지원 데스크 또는 기타 커뮤니케이션 도구GTFS 데이터세트 및 데이터 게시 관행.feed_contact_url 에 대한 기술 담당자입니다.GTFS - 소모 애플리케이션. 통해 고객 서비스 연락처 정보 제공agency.txt .

attributions.txt

파일: 선택 사항

기본 키(attribution_id )

파일은 데이터세트에 적용된 속성을 정의합니다.

분야 명 유형 있음 설명
attribution_id 고유 ID 선택 과목 데이터세트 또는 데이터세트의 하위 집합에 대한 속성을 식별합니다. 이것은 주로 번역에 유용합니다.
agency_id 외국 신분증 참조agency.agency_id 선택 과목 저작자 표시가 적용되는 대행사입니다.

하나라면agency_id ,route_id , 또는trip_id 속성이 정의된 경우 다른 속성은 비어 있어야 합니다. 둘 중 아무 것도 지정하지 않으면 속성이 전체 데이터 세트에 적용됩니다.
route_id 외국 신분증 참조routes.route_id 선택 과목 와 같은 기능을 합니다agency_id 속성이 경로에 적용되는 경우를 제외하고. 동일한 경로에 여러 속성이 적용될 수 있습니다.
trip_id 외국 신분증 참조trips.trip_id 선택 과목 와 같은 기능을 합니다agency_id 귀속이 여행에 적용되는 경우를 제외하고. 동일한 여행에 여러 속성이 적용될 수 있습니다.
organization_name 텍스트 필수의 데이터세트가 속한 조직의 이름입니다.
is_producer 열거 선택 과목 조직의 역할은 생산자입니다. 유효한 옵션은 다음과 같습니다.

0 또는 비어 있음 - 조직에 이 역할이 없습니다.
1 - 조직에 이 역할이 있습니다.

필드 중 하나 이상is_producer ,is_operator , 또는is_authority 에 설정해야 합니다.1 .
is_operator 열거 선택 과목 와 같은 기능을 합니다is_producer 조직의 역할이 운영자인 경우를 제외하고.
is_authority 열거 선택 과목 와 같은 기능을 합니다is_producer 조직의 역할이 권위라는 점을 제외하고.
attribution_url URL 선택 과목 조직의 URL입니다.
attribution_email 이메일 선택 과목 조직의 이메일입니다.
attribution_phone 전화 번호 선택 과목 조직의 전화번호입니다.