일반 대중교통 피드 사양 (GTFS)은 대중교통 일정 및 관련 지리 정보에 대한 기존 형식입니다. GTFS 기반 통합은 GTFS와 Google 대중교통 티켓팅 확장 프로그램을 사용하여 여행 교통 통합의 1단계인 정적 데이터 피드 제공을 완료합니다.
파트너 서버 API는 GTFS에서 제공하는 ticketing_trip_id와 같은 식별자를 사용하므로 API를 사용하려면 유효한 GTFS 피드가 있어야 합니다.
유효한 GTFS 피드를 제공하려면 아래 단계를 따르세요.
GTFS Static 피드 만들기
사용자가 GTFS 기반 통합을 사용하여 도시 간 이동 경로와 일정을 검색하고 찾을 수 있도록 하려면 파트너의 GTFS 피드가 필요합니다. GTFS 피드 데이터에는 일정, 경로, 티켓 정보에 관한 정적 정보가 포함되며, 이 정보는 Google에서 파트너 API에 연결하는 데 사용됩니다.
1. 대중교통 계정 만들기
아직 완료하지 않은 경우 Google 대중교통 시작하기로 이동하여 양식을 사용하여 계정을 요청하세요. 검토가 완료되면 계정이 생성되고 GTFS 대시보드를 사용할 수 있게 됩니다. 대시보드에 액세스하고 구성하는 방법에 대한 자세한 내용은 대중교통 파트너 대시보드 액세스를 참고하세요.
2. 확장 프로그램을 사용하여 GTFS 피드 만들기
Google 대중교통 티켓팅 확장 프로그램의 필수 섹션을 포함하여 GTFS 피드를 만듭니다 (자세한 내용은 GTFS 확장 프로그램 섹션 참고). 최상의 사용자 환경을 보장하려면 GTFS 품질 요구사항 및 권장사항을 읽고 따르세요.
3. 피드 이름 지정
권장되는 피드 명명 규칙은 agency-region-country_code(예: gbus-ca-us) 또는 지역이 필요하지 않은 경우 agency-country_code(예: gbus-br)입니다. 테스트 피드의 경우 권장되는 피드 이름 지정 규칙은 test-agency-country_code입니다(예: test-gbus-ca-us 또는 test-gbus-br).
4. 피드 업로드 및 업데이트
GTFS 피드 데이터 게시 가이드에 따라 GTFS 데이터를 업로드하고 업데이트합니다. 데이터가 업로드될 때마다 데이터는 자동 유효성 검사 (최대 30분 소요)를 거치고 유효성 검사 보고서가 생성됩니다. 다음 단계로 이동하기 전에 오류를 수정하세요.
5. 미리보기 환경 요청
GTFS 데이터가 검증을 통과하면 비공개 미리보기를 사용하여 피드 데이터 테스트의 안내에 따라 미리보기 환경을 사용 설정합니다. 사용 설정되면 업로드된 피드 데이터가 허용된 사용자의 Google 지도에 표시됩니다. 이제 이 시점에서 GTFS 데이터를 API 서버와의 테스트에도 사용할 수 있습니다.
6. 출시 품질보증 검토 요청
미리보기 환경에서 문제가 있는 경고와 데이터 품질 문제를 해결한 후에는 공개 출시 전에 최종 Google QA 검토가 필요합니다. QA 검토 프로세스를 통해 발견된 문제는 대시보드에 표시됩니다. 미해결 문제가 모두 해결되면 GTFS를 출시할 수 있습니다.
7. 피드 실행
피드를 공개하는 방법에 관한 안내는 피드 출시를 참고하세요.