정류장 전용 통합

개요

Google 지도용 GTFS 피드의 제공자가 아닌 경우 통합은 정류장 전용입니다. 이 통합을 위해 다양한 기차 또는 버스 정류장을 식별하는 방법을 알아야 합니다.

일반 피드 사양

통합을 시작할 때 각 통합에 고유 식별자(예: ch_google_test(국가 코드, 파트너 이름, 통합) 또는 eu_google(지역 코드, 파트너 이름))가 생성됩니다.

파트너는 전 세계적으로 또는 통합별로 적용되는 CSV 형식의 텍스트 파일이 포함된 ZIP 파일을 제공할 수 있습니다.

예시 1:

  • ch_google_test_stops.txt
  • ch_google_test_markets.txt

예시 2:

  • stops.txt (모든 통합에 적용됨)
  • eu_google_integration1_markets.txt
  • eu_google_integration2_markets.txt

중지 피드 사양 (필수)

중지 파일에는 다음 열이 포함되어야 합니다.

필드 이름 유형 (GTFS 참고) 설명
stop_id ID (필수) 정류장 또는 역을 식별하는 고유 식별자입니다. 규모가 큰 충전소에는 항목이 하나만 포함되어야 합니다. 파트너 서버 API를 호출할 때와 티켓 판매 딥 링크에서 사용됩니다.
stop_name 텍스트(필수) 중지 매핑, 캐시 채우기, 가격 정확성 데이터 디버깅을 위한 사람이 읽을 수 있는 이름입니다.
stop_lat 위도 (필수) 정류장의 위도입니다.
stop_lon 경도 (필수) 정류장의 경도입니다.

Google에서는 파트너가 포함된 정보가 변경될 때 업데이트된 ZIP 파일을 지속적으로 제공할 수 있는 자동 처리 프로세스를 사용합니다. 예를 들어 파트너는 정류장 목록을 확장하여 제공되는 인벤토리를 확장할 수 있습니다. 그러나 GTFS와 마찬가지로 stop_id는 안정적이어야 합니다.

시장 세트 피드 사양 (선택사항)

매핑된 정류장을 사용하여 이 통합을 위한 시장 세트 (인기 출발지 / 도착지 쌍이 포함된 목록)를 생성합니다. 그런 다음 시장 세트 피드를 제공하여 시장 세트를 줄일 수 있습니다.

시장 세트는 허용 목록으로 작동합니다. 시장 세트가 제공되지 않으면 통합에서 모든 시장이 사용 설정됩니다. 시장 세트를 제공하면 목록에 없는 시장은 사용 중지됩니다.

시장 세트 파일에는 다음 열이 포함되어야 합니다.

필드 이름 유형 (GTFS 참고) 설명
origin_stop_id ID (필수) 시장의 출처 stop_id입니다.
destination_stop_id ID (필수) 시장의 대상 stop_id입니다.

파트너 구성

중지 전용 통합을 사용하는 경우 파트너 구성 섹션에 설명된 대로 정적 파트너 구성에 관한 추가 정보가 필요합니다.

딥 링크의 형식과 매개변수는 티켓 판매 링크에 정의되어 있습니다.

Partner API 매개변수

파트너 API(GetBulkTripOptionsRequest)의 SegmentKeys 매개변수는 딥 링크 사양을 기반으로 합니다. from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time, arrival_time만 포함된 SegmentKeys를 사용하고 ticketing_trip_id는 비워 둡니다. 세그먼트당 하나씩 여러 개의 SegmentKey를 지정하여 모든 환승을 포함한 경로를 완전히 지정합니다.