GTFS Realtime 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
을 참고하세요.
사용자에게 실시간으로 대중교통 데이터 업데이트를 제공하면 대중교통 서비스 경험이 크게 향상됩니다. 현재 도착 시간과 출발 시간에 대한 최신 정보를 제공하면 사용자가 경로를 원활하게 계획할 수 있습니다. 예를 들어 지연이 발생하는 경우 탑승자는 마음 편하게 집에서 좀 더 기다릴 수 있습니다.
GTFS Realtime은 대중교통 기관이 애플리케이션 개발자에게 차량에 대한 실시간 업데이트를 제공할 수 있는 피드 사양입니다. 이는 대중교통 일정 및 관련 지리 정보에 대한 공공 데이터 형식인 GTFS(일반 대중교통 피드 사양)에 대한 확장 프로그램입니다. GTFS Realtime은 구현의 용이성 및 우수한 GTFS 상호 운용성을 바탕으로 하여 승객 정보에 중점을 두고 설계되었습니다.
이 사양은 초기 실시간 대중교통 업데이트 파트너 기관, 다수의 대중교통 개발자 및 Google의 파트너십을 통해 설계되었습니다. 이 사양은 Apache 2.0 라이선스에 따라 게시됩니다.
Google 지도의 실시간 대중교통 업데이트 정의
실시간 대중교통 업데이트는 Google 지도 및 Google 모바일 지도 사용자에게 실시간 대중교통 업데이트를 제공하는 서비스입니다. 이러한 업데이트에는 정류장의 출발 시각과 도착 시각 및 서비스 알림이 포함됩니다.
실시간 대중교통 업데이트는 실시간 출발 시간과 서비스 알림이라는 두 가지 유형의 실시간 업데이트를 사용자에게 제공합니다. 대중교통 파트너는 피드에서 이러한 업데이트를 제공합니다. GTFS Realtime 피드 양식을 만들어 정적 대중교통 일정에 널리 사용되는 GTFS 형식을 보완했습니다. 피드는 주기적으로 가져올 수 있는 위치에서 사용할 수 있어야 합니다. 시스템은 즉시 실시간 대중교통 업데이트 정보로 피드 업데이트를 처리합니다.
시작 방법
- 아래 개요를 숙지합니다.
- 제공할 피드 항목을 결정합니다.
- 예제 피드를 검토합니다.
- 참조를 사용하여 피드를 직접 만듭니다.
- 피드를 게시합니다.
GTFS Realtime 피드 개요
이 사양은 현재 다음 유형의 정보를 지원합니다.
- 경로 업데이트: 지연, 취소, 경로 변경
- 서비스 알림: 역, 경로 또는 전체 네트워크에 영향을 미치는 예기치 않은 이벤트, 정류장 이동
- 차량 위치: 위치 및 혼잡도를 포함한 차량 관련 정보
피드는 다양한 유형의 항목을 결합할 수 있습니다. 피드는 HTTP를 통해 제공되며 자주 업데이트됩니다. 파일 자체는 정규 바이너리 파일이므로 모든 유형의 웹 서버가 파일을 호스팅하고 게재할 수 있습니다(다른 전송 프로토콜도 사용 가능). 또는 유효한 HTTP GET
요청에 대한 응답으로 피드를 반환하는 웹 애플리케이션 서버를 사용할 수도 있습니다. 피드의 업데이트 또는 검색 빈도나 그 방법에 대한 제약이 없습니다.
GTFS Realtime은 차량의 실제 상태를 표시할 수 있으므로 정기적으로 피드를 업데이트해야 합니다. 자동 차량 위치 시스템에서 새 데이터가 나올 때마다 업데이트하는 것이 좋습니다.
피드 항목에 대해 자세히 알아보기
GTFS Realtime 데이터 교환 형식은 프로토콜 버퍼를 기반으로 합니다.
프로토콜 버퍼는 구조화된 데이터를 직렬화하는 데 언어 및 플랫폼에 구애를 받지 않는 플랫폼입니다(XML과 유사하지만 더 작고 빠르며 간단함). 데이터 구조는 gtfs-realtime.proto 파일에 정의되어 있으며, 이는 Java, C++, Python 같은 다양한 언어를 사용하여 다양한 데이터 스트림에서 구조화된 데이터를 쉽게 읽고 쓸 수 있는 소스 코드를 생성하는 데 사용됩니다.
프로토콜 버퍼에 대해 자세히 알아보기
데이터 구조
요소의 계층 구조와 그 유형에 대한 정의는 gtfs-realtime.proto 파일에 지정됩니다.
이 텍스트 파일은 사용자가 선택한 프로그래밍 언어로 필요한 라이브러리를 생성하는 데 사용됩니다. 이 라이브러리는 유효한 GTFS Realtime 피드를 생성하는 데 필요한 클래스와 함수를 제공합니다. 라이브러리를 사용하면 피드를 더 쉽게 생성할 수 있을 뿐만 아니라 유효한 피드만 생성되도록 할 수 있습니다.
데이터 구조에 대해 자세히 알아보기
도움말 보기
GTFS Realtime 관련 토론에 참여하고 사양에 대한 변경사항 및 추가사항을 제안하려면 GTFS Realtime 메일링 리스트에 가입하세요.
Google 지도 및 실시간 대중교통 업데이트
실시간 대중교통 업데이트는 Google 지도에서 사용자에게 대중교통 정보를 실시간으로 제공하는 기능입니다. Google 지도에 실시간 업데이트 정보를 제공하려는 대중교통 기관에서 근무하고 있다면 Google 대중교통 파트너 페이지를 방문해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eGTFS Realtime allows public transportation agencies to provide real-time updates, like delays and vehicle positions, to applications, enhancing the rider experience.\u003c/p\u003e\n"],["\u003cp\u003eThe data is provided in a feed based on Protocol Buffers, allowing for efficient and flexible data exchange.\u003c/p\u003e\n"],["\u003cp\u003eLive Transit Updates within Google Maps uses GTFS Realtime feeds to give users access to real-time departure times and service alerts.\u003c/p\u003e\n"],["\u003cp\u003eTransit agencies can create their own feeds using the provided specification and examples to integrate their data with applications like Google Maps.\u003c/p\u003e\n"],["\u003cp\u003eThe GTFS Realtime specification was designed with ease of implementation in mind and focuses on providing accurate passenger information.\u003c/p\u003e\n"]]],["GTFS Realtime provides transit agencies a method to share live updates with app developers, enhancing user experience with real-time arrival/departure times and service alerts. Key information types include trip updates (delays, cancellations), service alerts (station issues), and vehicle positions. Agencies can start by defining feed entities, reviewing examples, creating feeds using provided references, and publishing the feed. Feeds use Protocol Buffers, a structured data format, and are updated regularly via HTTP. Agencies interested in Google Maps integration can visit the Google Transit Partner Page.\n"],null,["# GTFS Realtime Overview\n\n| **Note:** To see a detailed list of recommended practices for feeds about realtime public transportation information, refer to the [GTFS Realtime Best Practices](https://gtfs.mobilitydata.org/best-practices/gtfs-realtime) on the Mobility Data site.\n\nProviding users transit data updates in real time greatly enhances their experience of your transit services. Providing up-to-date information about current arrival and departure times allows users to smoothly plan their trips. As a result, in case of an unfortunate delay, a rider would be relieved to know that they can stay home a little bit longer.\n\nGTFS Realtime is a feed specification that allows public transportation agencies to provide realtime updates about their fleet to application developers. It is an extension to [GTFS](/transit/gtfs#SubmitFeedToGoogle) (General Transit Feed Specification), an open data format for public transportation schedules and associated geographic information. GTFS Realtime was designed around ease of implementation, good GTFS interoperability and a focus on passenger information.\n\nThe specification was designed through a partnership of the initial [Live Transit Updates](/transit/gtfs-realtime#what_is_live_transit_updates_for_google_maps) partner agencies, a number of transit developers and Google. The specification is published under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0.html).\n\nWhat is Live Transit Updates for Google Maps?\n---------------------------------------------\n\nLive Transit Updates is a service providing real-time transit updates to users of Google Maps and Google Maps for mobile. These updates include live departure and arrival times to transit stations and service alerts.\n\nLive Transit Updates provide two types of real-time updates to users: live departure times and service alerts. Transit partners provide these updates in their feeds. We created the GTFS realtime feed format to complement the widely-used GTFS format for static transit schedules. Your feed needs to be available on a location where we can fetch it periodically. The system immediately processes feed updates as Live Transit Updates information.\n\nHow do I start?\n---------------\n\n1. Continue reading the overview below.\n2. Decide which [feed entities](/transit/gtfs-realtime/guides/feed-entities) you will be providing.\n3. Take a look at [example feeds](/transit/gtfs-realtime/examples).\n4. Create your own feeds using the [reference](/transit/gtfs-realtime/reference).\n5. Publish your feed.\n\nOverview of GTFS Realtime feeds\n-------------------------------\n\nThe specification currently supports the following types of information:\n\n- **Trip updates** - delays, cancellations, changed routes\n- **Service alerts** - stop moved, unforeseen events affecting a station, route or the entire network\n- **Vehicle positions** - information about the vehicles including location and congestion level\n\nA feed may, although not required to, combine entities of different types. Feeds are served via HTTP and updated frequently. The file itself is a regular binary file, so any type of webserver can host and serve the file (other transfer protocols might be used as well). Alternatively, web application servers could also be used which as a response to a valid HTTP `GET` request will return the feed. There are no constraints on how frequently nor on the exact method of how the feed should be updated or retrieved.\n\nBecause GTFS Realtime allows you to present the *actual* status of your fleet, the feed needs to be updated regularly - preferably whenever new data comes in from your Automatic Vehicle Location system.\n\n[More about feed entities...](/transit/gtfs-realtime/guides/feed-entities)\n\nData format\n-----------\n\nThe GTFS Realtime data exchange format is based on [Protocol Buffers](https://developers.google.com/protocol-buffers/)\n\nProtocol buffers are a language- and platform-neutral mechanism for serializing structured data (think XML, but smaller, faster, and simpler). The data structure is defined in a [gtfs-realtime.proto](/static/transit/gtfs-realtime/gtfs-realtime.proto) file, which then is used to generate source code to easily read and write your structured data from and to a variety of data streams, using a variety of languages -- e.g. Java, C++ or Python.\n\n[More about Protocol Buffers...](/protocol-buffers).\n\nData structure\n--------------\n\nThe hierarchy of elements and their type definitions are specified in the [gtfs-realtime.proto](/static/transit/gtfs-realtime/gtfs-realtime.proto) file.\n\nThis text file is used to generate the necessary libraries in your choice of programming language. These libraries provide the classes and functions needed for generating valid GTFS Realtime feeds. The libraries not only make feed creation easier but also ensure that only valid feeds are produced.\n\n[More about the data structure...](/transit/gtfs-realtime/reference)\n\nGetting Help\n------------\n\nTo participate in discussions around GTFS Realtime and suggest changes and additions to the specification, join the [GTFS Realtime mailing list](http://groups.google.com/group/gtfs-realtime).\n\nGoogle Maps and Live Transit Updates\n------------------------------------\n\n[Live Transit Updates](/transit/gtfs-realtime#what_is_live_transit_updates_for_google_maps) is a feature within Google Maps that provides users with realtime transit information. If you are working for a public transportation agency that is interested in providing realtime updates to Google Maps, please visit the [Google Transit Partner Page](http://maps.google.com/help/maps/transit/partners/live-updates.html)."]]