이 용어집에서는 대중교통 파트너 통합 문서에 사용되는 주요 용어를 정의합니다.
예약 토큰: Google 검색 결과와 파트너의 예약 페이지 간에 가격 및 운항 일정 일관성을 유지하는 데 도움이 되도록 티켓팅 딥 링크에 전달할 수 있는 선택적 파트너 생성 문자열입니다.
표준 JSON 매핑: 프로토콜 버퍼에서 프로토 메시지를 JSON 객체로 변환하기 위해 정의한 특정 규칙 집합입니다. 이 통합에서는 요청과 응답의 형식이 올바르게 지정되도록 특정 옵션과 함께 이 매핑을 사용해야 합니다.
GTFS (일반 대중교통 피드 사양): 대중교통 기관이 승객에게 일정, 노선, 요금 정보를 제공하는 데 사용하는 표준 데이터 형식입니다. 이 통합에서는 Google에 정적 데이터를 제공하는 두 가지 방법 중 하나입니다.
GTFS 기반 통합: GTFS 피드에서 자체 일정 데이터를 Google에 제공하는 파트너를 위한 통합 방법입니다. Google에 아직 운영자의 일정이 없는 경우에 사용됩니다.
known_itineraries: 파트너가 Google로부터 알려진 여정 목록을 수신하여 응답을 최적화할 수 있도록 지원하는 파트너 구성의 옵션입니다.
시장 세트: (정류장 전용 통합의 경우) 파트너가 가격을 제공할 출발지-도착지 쌍 (시장)의 특정 목록을 정의하기 위해 제공하는 선택적 피드입니다. 제공된 경우 허용 목록으로 작동합니다.
파트너 API / 파트너 서버 API: 파트너가 실시간 가격 및 재고와 같은 동적 데이터를 Google에 제공하기 위해 구현해야 하는 API 집합입니다.
가격 품질 테스트: Google 크롤러가 파트너 웹사이트에서 여행 일정을 샘플링하여 사용자에게 표시되는 가격이 Partner API를 통해 제공된 가격과 일치하는지 확인하는 지속적인 프로세스입니다.
QPS (초당 쿼리 수): Google이 파트너 API 서버에 요청(하나의 쿼리는 하나의 요청)을 보내는 평균 속도입니다. 이 비율은 트래픽이 약간 높거나 낮은 기간에 따라 변동될 수 있습니다.
SegmentKey: 출발지, 목적지, 서비스 날짜/시간을 비롯한 여정의 단일 구간을 고유하게 식별하기 위해 파트너 API에서 사용되는 객체입니다.
service_date: 대중교통 서비스가 운영되는 특정 날짜로, YYYYMMDD 형식입니다. 고유한 이동 인스턴스를 지정하기 위해 다른 식별자와 함께 사용됩니다.
중지만 통합: 일정 데이터의 소스가 아닌 파트너를 위한 통합 방법입니다. Google이 이미 다른 소스에서 운영자의 일정을 수신하는 경우에 사용됩니다. 파트너는 정류장 ID 목록만 제공하면 됩니다.
ticketing_stop_id: 정류장 또는 역의 파트너 고유 식별자입니다.
이 ID는 정적 데이터 피드 (GTFS 또는 정류장 전용)에 제공되며 파트너 API 및 티켓팅 딥 링크에서 사용됩니다.
ticketing_trip_id: (GTFS 기반 통합의 경우) 파트너의 GTFS 피드 trips.txt 파일에 제공된 특정 이동의 고유 식별자입니다. GTFS 기반 통합만 해당합니다.
티켓팅 딥 링크: 사용자를 Google 검색 결과에서 파트너의 웹사이트로 안내하여 특정 여정을 예약하는 URL입니다. URL에는 선택한 여행에 관한 인코딩된 세부정보가 포함되어 있습니다.
TripOptionsErrorType: 요청이 실패한 이유에 관한 자세한 정보를 제공하기 위해 파트너 API에서 반환될 수 있는 특정 오류 유형 집합입니다.
UNSPECIFIED 열거형 값: 프로토콜 버퍼를 사용할 때 모든 열거형 정의에서 필요한 첫 번째 값 (숫자 값이 0)입니다. 기본값으로 사용되며 요청에서 수신된 경우 일반적으로 오류로 처리해야 합니다.