개요
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를 지정하여 모든 환승을 포함한 경로를 완전히 지정합니다.