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

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

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

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

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

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

실시간 대중교통

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

실시간 피드에서 무시되는 공식 사양

일부 무시되는 사양은 시험용입니다. 자세한 내용은 gtfs.org를 참고하세요.

표 1에는 실시간 피드에서 대중교통에 의해 무시되는 GTFS 정의 필드가 나열됩니다.

표 1. 실시간 피드에서 무시되는 공식 필드
메시지 GTFS에 정의된 무시되는 필드 필드 유형
메시지 Alert image TranslatedImage
메시지 Alert image_alternative_text TranslatedString
메시지 Alert severity_level 열거형
메시지 Alert tts_description_text Proto
메시지 Alert tts_header_text Proto
메시지 CarriageDetails id 문자열
메시지 CarriageDetails occupancy_percentage int32
메시지 Position bearing 부동 소수점 수
메시지 Position odometer 실수(Double)
메시지 Position speed 부동 소수점 수
메시지 Shape encoded_polyline 문자열
메시지 Shape shape_id 문자열
메시지 StopTimeUpdate(TripUpdate에서) arrival.uncertainty int32
메시지 StopTimeUpdate(TripUpdate에서) stop_time_properties Proto
메시지 TripUpdate trip_properties Proto
메시지 TripUpdate vehicle VehicleDescriptor
메시지 VehicleDescriptor license_plate 문자열
메시지 VehicleDescriptor wheelchair_accessible WheelchairAccessible
메시지 VehiclePosition congestion_level 열거형
메시지 VehiclePosition current_status VehicleStopStatus
메시지 VehiclePosition current_stop_sequence uint32
메시지 VehiclePosition multi_carriage_details.id 문자열
메시지 VehiclePosition occupancy_percentage uint32
메시지 VehiclePosition stop_id 문자열

실시간 피드에서 해석의 차이

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

표 2에는 실시간 피드의 GTF 정의 필드이며 대중교통에서 선택사항 또는 조건부 필수인 필드가 나열되어 있습니다. 선택사항인 필드의 경우 표에 대중교통에서 열거형 값이 지원되는지 여부가 표시됩니다.

표 2. 다르게 해석된 실시간 피드 필드
파일 이름 GTFS에 정의된 필드 필드 유형 Google 대중교통에서 필수 여부 Google 대중교통 구현 세부정보
메시지 StopTimeUpdate(TripUpdate에서) stop_id 문자열 조건부 필수

stop_id 문자열이 제공되는 경우 다음 조건 중 하나를 충족해야 합니다.

  • stop_id 문자열은 상응하는 GTFS 피드의 stops.txt 파일에 있는 것과 같아야 합니다.
  • 다른 stop_id 문자열을 사용하는 경우 제공된 stop_id 문자열은 정적 GTFS에 제공된 원본 stop_id 문자열의 동위 문자열 또는 하위 문자열이어야 합니다. 상응하는 stop_sequence 필드도 제공되어야 합니다.
메시지 StopTimeUpdate schedule_relationship 열거형 선택사항

Google 대중교통에서는 다음 열거형 값을 지원합니다.

  • SCHEDULED
  • SKIPPED
  • NO_DATA
메시지 TripDescriptor schedule_relationship 열거형 선택사항

Google 대중교통에서는 다음 열거형 값을 지원하지 않습니다.

  • DUPLICATED
  • CANCELED: TripUpdate 기록용이 아닌 경우

Google은 다음 열거형 값을 지원합니다.

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED: TripUpdate 기록용으로만 지원

실시간 피드의 시험적 지원

새로운 시험용 필드를 통합하는 데 지원이 필요하면 Google 대중교통에 문의하세요.

실시간 피드의 Google 대중교통 지원 확장

이 도움말을 게시한 시점에 이 카테고리에 속하는 필드가 없습니다. 도움이 필요한 경우 Google 대중교통에 문의하세요.