개요
Google 지도의 GTFS 피드 제공자가 아닌 경우 통합은 정류장 전용입니다. 이 통합을 위해서는 다양한 기차역이나 버스 정류장을 식별하는 방법을 알아야 합니다.
일반 피드 사양
통합을 시작할 때 각 통합에 대해 고유 식별자를 만듭니다(예: ch_google_test(국가 코드, 파트너 이름, 통합) 또는 eu_google(지역 코드, 파트너 이름)).
파트너는 통합별로 적용되는 텍스트 파일이 CSV 형식으로 포함된 파일을 제공합니다. 각 CSV 파일에는 해당 피드 사양 표에 지정된 '필드 이름'과 일치하는 열 이름이 있는 헤더 행이 포함되어야 합니다.
파트너가 정류장 및 시장 파일의 새 버전을 업로드할 수 있도록 Google팀에서 온보딩 프로세스 중에 각 파일 유형에 대해 SFTP 드롭박스 세부정보를 공유합니다.
중지 피드 사양 (필수)
정지 파일에는 다음 열이 포함되어야 합니다.
| 필드 이름 | 유형 (GTFS 참고) | 설명 |
|---|---|---|
stop_id |
ID (필수) | 정류장 또는 역을 식별하는 고유 식별자입니다. 큰 방송국에는 하나의 항목만 포함되어야 합니다. 이는 파트너 서버 API를 호출할 때와 티켓팅 딥 링크에서 사용됩니다. |
stop_name |
텍스트(필수) | 디버깅 중지 매핑, 캐시 채우기, 가격 정확도 데이터를 위한 사람이 읽을 수 있는 이름입니다. |
stop_lat |
위도 (필수) | 정류장의 위도입니다. |
stop_lon |
경도 (필수) | 정류장의 경도입니다. |
파트너가 정보가 변경될 때 업데이트된 zip 파일을 지속적으로 제공할 수 있는 자동 수집 프로세스가 사용됩니다. 예를 들어 파트너는 정류장 목록을 확장하여 제공되는 인벤토리를 확장할 수 있습니다. 하지만 GTFS와 마찬가지로 stop_id는 안정적이어야 합니다.
시장 세트 피드 사양 (선택사항)
매핑된 정류장을 사용하여 이 통합의 시장 세트 (인기 출발지 / 도착지 쌍이 포함된 목록)를 생성합니다. 여기에서 시장 세트 피드를 제공하여 이 시장 세트를 줄일 수 있습니다.
시장 세트는 캐시 채우기 서비스의 허용 목록 역할을 합니다. 기본적으로 시장 세트가 제공되지 않으면 모든 시장이 사용 설정됩니다. 시장 세트를 제공하면 목록에 포함된 시장만 쿼리됩니다. 사용자가 이 허용 목록에 없는 시장을 쿼리하는 경우 Google 시스템은 요청된 특정 시장 및 날짜에 대한 실시간 쿼리를 계속 전송하지만 사전 캐시를 시도하지는 않습니다.
시장 세트 파일에는 다음 열이 포함되어야 합니다.
| 필드 이름 | 유형 (GTFS 참고) | 설명 |
|---|---|---|
origin_stop_id |
ID (필수) | 시장의 원산지 stop_id입니다. |
destination_stop_id |
ID (필수) | 시장의 대상 stop_id입니다. |
파트너 구성
정지 전용 통합을 사용하는 경우 파트너 구성 섹션에 설명된 대로 정적 파트너 구성에 대한 추가 정보가 필요합니다.
추천 링크 사양
예약 링크 (Ticketing link라고도 함)의 형식과 매개변수는 티켓팅 링크에 정의되어 있습니다.
파트너 API 매개변수
파트너 API(GetBulkTripOptionsRequest)의 SegmentKeys 매개변수는 딥 링크 사양을 기반으로 합니다. from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time, arrival_time만 포함하고 ticketing_trip_id은 비워 둔 SegmentKeys를 사용합니다. 세그먼트별로 하나씩 여러 SegmentKey를 지정하여 모든 환승을 포함한 경로를 완전히 지정합니다.