GTFS 요구사항

파트너는 아래 나열된 표준 사양 외에도 모든 표준 사양을 충족하는 GTFS 피드를 제공해야 합니다. 이 피드는 파트너가 표시하려는 모든 여행 일정을 포함해야 합니다. 이 정보를 제공하면 Google에 일정 및 경로 정보가 표시될 수 있습니다. 파트너는 제공된 피드에서 일부 또는 전체 여행 일정의 추가 가격 및 이용 가능 여부 정보를 원하는 경우 노출할 수도 있습니다.

기본 요구사항

정적 GTFS 참조 - 모든 기본 요구사항이 적용됩니다.

GTFS 권장사항 - 권장사항을 필요한 것처럼 따르세요.

GTFS 피드 업로드 - GTFS 피드를 업로드하려면 다음 절차를 따르세요.

업데이트: 피드가 업로드된 후에는 여기에 설명된 절차에 따라 업데이트할 수 있습니다. 일반적으로 이러한 피드 업데이트가 완전히 전파되는 데 2~3일이 걸릴 수 있습니다.

추가 요구사항

범위

  • 단일 GTFS 피드는 단일 국가 또는 국가의 일부를 포함해야 합니다. 국경을 가로지르는 이동은 별도의 대륙 전체 피드로 제공해야 합니다. GTFS 피드가 국가보다 큰 범위를 다루는 경우 여행 운송팀에 문의하세요.
    • GTFS ZIP 파일 내의 파일은 4GB 미만이어야 합니다. 이보다 큰 파일은 일반적으로 frequencies.txt 또는 유사한 기능의 압축 옵션을 무시하는 것과 같은 잘못된 관행의 신호입니다. 이로 인해 처리 중에 문제가 발생할 수 있습니다. 4GB보다 큰 파일이 필요하다면 Transport-help@google.com을 통해 Travel Transport팀에 문의하세요.
    • GTFS 피드 내 서비스의 향후 전체 운영 기간에 대한 데이터는 GTFS 데이터가 업데이트될 때마다 제공되어야 합니다. 서로 다른 기간별로 서비스를 세분화하는 것은 허용되지 않습니다.
  • 지정된 연산자의 모든 날짜는 단일 피드에 포함되어야 합니다.

번역

  • 번역은 translations.txt를 통해 제공될 수 있으며 다음 국가에서는 필수입니다.
    • 사용자에게 정보가 다른 스크립트 또는 라틴어 이외 스크립트로 제공될 수 있습니다.
    • 사용자에게 정보가 여러 언어로 제공될 수 있거나 항목이 이러한 언어에서 다른 이름 지정을 사용할 수 있는 경우 (예: Brussels/Brussel/Bruxelles)
  • 변환할 항목
    • 기관/정류장/경로 이름
    • 이동/정류장 행선지

경로 이름, 이동 시 짧은 이름, 행선지

  • 행선지가 이동 중에 행선지가 일관적으로 유지되는 경우 trips.txt 또는 stop_times.txt(경로의 여러 단계에서 행선지가 변경되는 경우)의 모든 이동에 대해 행선지를 제공해야 합니다.
  • 행선지는 사용자가 지상에서 찾을 수 있는 정보와 일치해야 합니다. 예를 들어 차량이나 간판에 표시된 행선지가 있습니다.
  • 경로에 이름이 있으면 routes.txt의 long_name으로 제공해야 합니다.
  • 경로에 해당 경로의 모든 이동에 그리고 양방향으로 적용되는 특정 숫자 또는 영숫자 식별자가 있는 경우 routes.txt에 short_name으로 제공해야 합니다.
  • 경로 내 이동에 개별 식별자 (예: 기차 번호)가 있는 경우 이러한 식별자를 이동 별칭으로 제공해야 합니다.
  • 경로 번호나 이름이 없는 장거리 서비스의 경우 경로 이름을 선택하는 데 문제가 됩니다. 이러한 상황에서 일반적인 가이드라인은 경로 이름과 행선지를 조합하면 사용자가 차량을 명확하게 식별하는 데 도움이 되어야 한다는 것입니다. 예를 들어 운영 기관의 이름을 경로 이름으로 사용할 수 있으며, 이동의 목적지 (차량에 표시되는 경우)를 이동 행선 표지판으로 사용해야 합니다.

예

  • 뭄바이에서 바라나시까지 인도의 카마야니 급행 열차 11071입니다. 참고: 번호 11071은 뭄바이에서 바라나시까지의 특정 기차 이동을 나타내며 경로 자체가 아닙니다.
    • routes.txt:
      • short_name: <비어 있음>
      • long_name: Kamayani Express
    • trips.txt:
      • trip_short_name: 11071
      • 행선지: 바라나시
  • 부에노스아이레스에서 코르도바까지 가는 버스로, 슈발리에 버스가 운행합니다. 참고: 이 서비스를 운행하는 버스에는 특정 경로 이름이 표시되지 않습니다. 대신 운영 기관의 이름과 목적지를 눈에 띄게 표시합니다. 이 특정 이동에는 동일한 기관에서 운영하거나 동일한 경로를 제공하는 다른 이동과 구별하는 개별 번호/식별자가 없습니다. 이 경우 기관 이름 (agencies.txt)과 경로 long_name (routes.txt)로 'Chevallier'를 모두 사용할 수 있습니다. 목적지는 행선지에 사용해야 합니다. trip_short_name은 비워 두어야 합니다.
    • routes.txt:
      • short_name: <비어 있음>
      • long_name: 슈발리에
    • trips.txt:
      • trip_short_name: <empty>
      • 행선지: 코르도바

정차 시간

arrival_time 및 출발_시간은 모두 stop_times.txt로 제공되어야 합니다.

이동 구조

  • 여러 도시/지역을 대상으로 하는 장거리 이동은 세분화 없이 엔드 투 엔드로 제공되어야 합니다 (예: [A->B,A->C,B->C]가 아닌 A->B->C). 여기서 A, B, C는 도시 구역입니다. 예를 들어 로사리오에서 정류장이 있는 부에노스아이레스에서 코르도바까지 이동하는 장거리 버스는 '부에노스아이레스 - 로사리오', '부에노스아이레스 - 코르도바', '로사리오 - 코르도바'의 세 번의 운행으로 이루어지는 것이 아니라, 로사리오에서 정류장을 경유하는 여행으로 표현되어야 합니다.
  • 데이터 제공자가 올바른 이동 구조에 대한 정보를 가져오지 못하는 경우에는 도시 간 이동이 상황에 따라 나누어져 제공될 수 있습니다. 이러한 도시 간 이동의 경우 한 도시 (도시 지역) 내에 승차 또는 하차 지점이 여러 개 있는 경우에는 정류장-정류장 세분화가 허용되지 않습니다. 모든 승차 지점과 하차 지점은 한 이동에 나열되어야 합니다.

역 구조

승강장/만이 여러 개 있는 대규모 역의 경우 역-플랫폼 관계를 피드에 지정해야 하고 stops.txt의 platform_code 필드를 통해 특정 베이/플랫폼을 식별해야 합니다. 특정 만 또는 승강장에서 계속 출발하거나 도착하는 차량은 GTFS 피드에서 해당 만 또는 승강장에 연결되어야 합니다. 출발/도착 플랫폼 또는 만이 다른 출발 요일/시간에 따라 변경되는 경우 이 정보를 GTFS 실시간으로 제공할 수 있습니다.

역/정류장 위치

  • 승강장이나 만이 있는 대형 역의 경우 역 위치를 가장 눈에 띄는 보행자 입구 위치 (역에 건물 또는 구조물이 있는 경우) 또는 승객 대기 영역의 위치 (실외 역의 경우)로 설정해야 합니다.
  • 도로 옆 작은 정류장의 경우 정류장 위치를 버스 정류장이 식별될 수 있는 경우 버스 정류장의 위치로 설정해야 합니다. 특정 버스 기둥을 식별할 수 없는 경우에는 위치를 도로의 정확한 쪽에 배치해야 하며, 차량이 정차하는 도로의 실제 위치 (10m 이내)가 가장 좋습니다.

추가 GTFS 확장

파트너 API를 구현하여 가격/재고 정보를 표시하려는 파트너에게만 필요합니다.

Google 대중교통 티켓 판매 확장

  • 파트너는 GTFS 티켓 판매 확장의 하위 집합인 Google 대중교통 티켓 판매 확장 사양을 구현해야 합니다.
  • 티켓 판매 ID에 다음 요구사항을 적용합니다.
    • 티켓 판매 ID는 안정적이어야 합니다 (즉, 합당한 이유로 드물게 변경될 수 있음). 티켓 판매 ID가 변경되는 경우 이전 버전과의 호환성이 필요합니다 (최소 1주 동안).
    • API 요청에서 SegmentKey의 매개변수를 확인하려면 ticketing_trip_id (trips.txt) 및 ticketing_stop_id (ticketing_identifiers.txt)가 필요합니다. stop_sequence의 대체는 안정적이지 않으므로 지원되지 않습니다.

GTFS-Fares v1

정적 GTFS 참조는 선택사항인 fare_attributes.txt 및 fare_rules.txt 파일을 지정합니다. 파트너가 파트너 API와 통합하는 경우 이러한 파일을 제공하면 안 됩니다.