시작하기

이 가이드에서는 Google 지도, Google 검색 등 다양한 Google 플랫폼에서 사용자에게 원활한 교통 검색 환경을 제공하기 위해 Google과 통합하는 방법을 설명합니다. 개략적으로 주요 통합 사양은 다음과 같습니다.

  • 정적 데이터를 제공하는 두 가지 옵션이 있습니다.
    • GTFS 기반 통합: 일정 데이터 제공자인 경우 티켓팅 확장 프로그램이 포함된 GTFS 피드를 제공합니다. GTFS 기반 통합에는 몇 가지 추가 요구사항이 있습니다.
    • 정류장만 통합: Google에 이미 다른 소스의 일정 데이터가 있는 경우 정류장 목록만 제공합니다.
  • 동적 데이터를 제공하기 위한 파트너 API 사양:

여행 운송과 통합하는 단계

다음은 Google의 교통 기능을 지원하는 엔드 투 엔드 시스템을 빌드하고 테스트하는 데 필요한 단계의 개요입니다. 통합에는 세 가지 주요 단계가 있습니다.

  1. 참여 요구사항을 검토합니다.
  2. Google에 정적 데이터 피드를 제공합니다.
  3. 가격 및 이용 가능 여부와 같이 빠르게 변하는 데이터의 동적 쿼리를 지원하는 Travel Transport API 지원 API는 1단계의 정적 데이터 피드에서 제공하는 식별자(예: ticketing_stop_id)를 활용하여 정류장을 식별합니다.

1. 참여 요건

Google의 대중교통 기능 단위에는 가격과 함께 일정 및 예약 옵션이 표시됩니다. 목록에 혜택을 표시하려면 품질이 우수한 링크와 일치하는 최종 가격이 필요합니다. 자세한 내용은 참여 요구사항을 참고하세요.

2. 정적 데이터 피드 제공

정적 데이터를 제공하는 데는 두 가지 옵션이 있으며, 각 옵션은 특정 상황에 적용됩니다. 어떤 옵션을 사용할지 결정하는 주요 기준은 예약 기능을 제공하려는 대중교통 연결의 일정 데이터를 제공하는지 여부입니다. Google에 이미 일정 데이터가 있는지 확인하는 가장 쉬운 방법은 Google 지도에서 특정 운영자의 연결을 찾아보는 것입니다.

기능 GTFS 기반 통합 중지 전용 통합
사용 사례 이미 일정 및 티켓팅 정보와 함께 GTFS를 제공하고 있습니다. Google에 이미 다른 소스에서 가져온 운송업체의 일정 데이터가 있습니다.
필수 데이터 GTFS ID입니다. 정류장 ID 목록과 지리적 좌표입니다.
노력 낮음 보통

옵션 1은 운영자의 GTFS 피드 제공자인 경우에 적용됩니다. 이 경우 먼저 Google에 시간표 정보를 제공하도록 GTFS 피드를 설정해야 합니다. 그런 다음 GTFS 기반 통합 섹션의 안내를 따릅니다.

Google이 이미 다른 소스에서 운송업체의 일정 데이터를 수신하는 경우 옵션 2가 적용됩니다. 이 경우 전체 일정 정보는 필요하지 않지만 Travel Transport API에서 사용할 수 있는 정류장 ID 목록은 필요합니다 (아래 참고). 정류장 목록을 제공하려면 정류장 전용 통합 섹션의 안내를 따르세요.

3. Travel Transport API 지원

운송 단위로 가격이 표시되는 예약 파트너로 등록되려면 Google에서 파트너로부터 최신 가격 및 예약 가능 여부 정보를 가져올 수 있어야 합니다. 이를 사용 설정하려면 파트너가 파트너 서버 API를 구현하는 서비스를 제공해야 합니다.

3.1. 파트너 서버 API 구현

파트너 서버 API 구현 방법에 관한 자세한 내용은 API 참조 및 파트너 서버 가이드를 참고하세요. 이 API를 통해 Google은 파트너로부터 최신 가격 및 재고 정보를 가져올 수 있으며, Google에서 다음과 같은 용도로 호출합니다.

  1. 반환 가격의 캐시를 빠르게 생성합니다.
  2. 사용자가 특정 운항 일정을 클릭할 때 최신 가격을 가져옵니다.

파트너가 Google에 가격을 표시하려면 파트너 서버 API를 구현해야 합니다.

3.2. API 검증 및 테스트

API 구현이 거의 완료되고 이를 구현하는 서비스가 실행되면 transport-help@google.com으로 서버 정보를 보내 구현 유효성 검사를 시작할 수 있도록 하세요.

향후 API 구현을 검증하기 위한 자동화된 도구를 제공할 계획이지만 아직 사용할 수 없습니다.