자주 묻는 질문(FAQ)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
다음은 GTFS를 구현할 때 자주 발생하는 문제에 대한 질문과 답변입니다.
Q: 피드를 공개하기 전에 테스트할 수 있는 환경이 있나요?
A: 예, 피드가 성공적으로 업로드되면 테스트 환경이 준비됩니다.
Q: 업데이트가 있을 때마다 피드를 수동으로 업로드해야 하나요, 아니면 서버에서 가져오도록 Google에 요청할 수 있나요?
A: 일반적으로 Google은 FTP GET을 통해 정기적으로 가져오도록 설정하는 것을 선호합니다. 가져오는 빈도는 기본적으로 주1회입니다. 또한 콘솔에서 파일을 수동으로 업로드할 수도 있습니다.
Q: 고속 라인과 현지 라인이 모두 있는 경우 별도의 피드를 제출할 수 있나요?
A: 예, 기관에서 별도의 피드를 제출할 수 있지만 일반적으로 단일 피드를 선호합니다.
Q: 클래스 C와 클래스 A와 같이 좌석에 따라 가격이 다를 경우 어떻게 해야 하나요?
A: 가장 일반적인 가격을 포함하세요.
Q: 성수기 가격과 같이 날짜에 따라 가격이 다를 경우 어떻게 해야 하나요?
A: 별도의 노선을 만드세요.
Q: agency.agency_fare_url의 예약 도메인이 여러 개인 경우 모두 쉼표로 구분하여 추가할 수
있나요?
A: URL을 하나만 포함하세요. 하나만 표시하는 데 문제가 있으면 공백으로 두세요.
Q: routes.route_long_name에 동일한 이름을 사용해도 괜찮나요?
A: 예, 해당 속성에 대해 동일한 이름을 설정할 수 있습니다.
Q: 다음에 대해 상위 역과 하위 역을 모두 설정하는 경우 어떤 것이 사용되나요?
A:
stop_code: 정류장stop_name: 역(향후 정류장 사용이 가능할 수 있음)stop_desc: 없음stop_lat: 둘 모두stop_lon: 둘 모두zone_id: 정류장stop_url: 역wheelchair_boarding: 둘 모두
Q: 일정이 변경된 바로 그 날짜에 피드를 업데이트할 수 있나요?
A: GTFS에서 피드가 유효한 마지막 날짜를 지정할 수 있습니다. 피드는 게시되어야 하는
날짜로부터 2주 전에 업로드해야 합니다. 캘린더 정보가 겹쳐야 한다는 점에 유의하세요.
두 피드를 '병합'하는 도구가 있습니다.
Q: 내부적으로 사용하던 기존의 고유한 ID를 사용할 수 있나요?
A: 예, GTFS의 ID는 모든 값을 가질 수 있습니다.
Q: 피드 업로드가 계속 실패합니다. 무엇이 문제인가요?
A: 파일이 ZIP 파일의 최상위 디렉토리에 있는지 확인하세요.
Q: 대중교통 결과가 미리보기의 샘플 쿼리에서 생성되지 않습니다. 무엇이 문제인가요?
A: 해당 샘플의 시간을 확인하고 선택한 시간에 대중교통이 운행되고 있는지 확인하세요. 그렇지 않은 경우 결과가 생성되지 않을 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eGoogle prefers a regularly fetched GTFS feed via FTP, with weekly updates as the default.\u003c/p\u003e\n"],["\u003cp\u003eSeparate routes should be created for services with date-dependent pricing, such as peak season fares.\u003c/p\u003e\n"],["\u003cp\u003eFor stops with both parent and child stations defined, station information will be prioritized for \u003ccode\u003estop_name\u003c/code\u003e and \u003ccode\u003estop_url\u003c/code\u003e while stop information will be used for other attributes.\u003c/p\u003e\n"],["\u003cp\u003eGTFS feeds must be uploaded two weeks prior to their effective date and should specify the valid date range within the feed itself.\u003c/p\u003e\n"],["\u003cp\u003eTroubleshooting feed upload failures often involves ensuring all files are in the ZIP file's top-level directory and verifying transit schedules align with preview query times.\u003c/p\u003e\n"]]],["GTFS implementation involves a test environment after feed upload. Google prefers regular feed fetching (weekly default) via FTP, though manual uploads are possible. Multiple feeds are accepted, but a single feed is preferred. Include the most generic price; for date-dependent pricing, create separate routes. Only one URL is allowed for `agency_fare_url`. IDs can be internal values. Files should be at the top level of the ZIP. Feeds are needed two weeks prior to live date.\n"],null,["# Frequently Asked Questions\n\nThe following are questions and answers for common issues when implementing GTFS.\n\n##### Q: Is there a test environment for the feed before making it public?\n\nA: Yes, we will prepare the test environment once your feed is successfully uploaded.\n\n##### Q: Do we need to manually upload the feed every time there is an update or can we ask Google to\nfetch it from our server?\n\nA: In general, Google prefers to set up a regular fetch (via FTP GET). The frequency\nis weekly by default. In addition, you can manually upload a file from the console.\n\n##### Q: If we have both the express line and local line, can we submit separate feeds?\n\nA: Yes, it is possible for an agency to submit multiple separate feeds but we usually prefer having\na single feed.\n\n##### Q: In case the price is different depending on the seat --e.g., class C vs. class A, what do we need to do?\n\nA: Please include the most generic price.\n\n##### Q: If the price is different depending on the date --e.g., peak season price, what do we need to do?\n\nA: Please create separate routes.\n\n##### Q: When there are multiple booking domains for `agency.agency_fare_url`, can we add them all separating\nthem with comma?\n\nA: Please only include one URL. If there is a problem in just showing one, please leave it blank.\n\n##### Q: Is it ok to have the same name for `routes.route_long_name`?\n\nA: Yes, you can set the same name for that attribute.\n\n##### Q: If we set both the parent station and child station for the following, which will be used?\n\nA:\n\n- `stop_code`: stop\n- `stop_name`: station (in the future, we might use stop)\n- `stop_desc`: none\n- `stop_lat`: both\n- `stop_lon`: both\n- `zone_id`: stop\n- `stop_url`: station\n- `wheelchair_boarding`: both\n\n\u003cbr /\u003e\n\n##### Q: Can we update the feed exactly on the date when the schedule is changed?\n\nA: You can specify to which date the feed is valid in GTFS. The feeds must be uploaded\ntwo weeks prior to the date when it should go live. Note that the calendar information must overlap.\nThere is a tool for \"merging\" two feeds.\n\n##### Q: Can we use our existing unique ids we have been using internally?\n\nA: Yes, IDs in GTFS can be any value.\n\n##### Q: My feed upload keeps failing. What could be a problem?\n\nA: Please ensure that the files are in the top level directory in your ZIP file.\n\n##### Q: Transit results are not generated from the sample queries in Preview. What could be the issue?\n\nA: Please check the time of those samples and make sure that your transits are running at those selected\ntimes. If not, it is possible that there is no result generated."]]