CIFS 사양
CIFS (폐쇄 및 사고 피드 사양)는 파트너 피드에서 사고 및 도로 폐쇄를 설명하는 Waze의 표준 프로토콜입니다.
아래 매개변수 표에서는 각 요소를 다음과 같이 분류합니다.
- 필수: 필수 태그의 형식이 올바른 값이 없으면 피드가 유효하지 않은 것으로 간주됩니다.
- 요청됨: 기술적으로는 필수가 아니지만 요청된 태그는 권장되는 것으로 간주됩니다.
- 선택사항: 더 많은 데이터를 제공할 수 있는 선택적 태그입니다.
파일을 파싱하는 엔진에는 요소의 순서가 중요하지 않습니다.
이러한 태그는 type 태그의 값에 따라 사고 또는 도로 폐쇄를 설명할 수 있습니다.
관련된 경우 사소한 차이점이 설명됩니다.
다음은 피드의 도로 폐쇄의 예입니다.
다음은 피드의 사고의 예입니다.
동일한 피드 파일에 폐쇄와 사고를 함께 사용할 수 있습니다.
CIFS 요소
| 요소 | 필수 | 태그 입력 | 설명 |
|---|---|---|---|
| incident id | 필수 | 자유 텍스트 | 영숫자 또는 숫자 식별자를 지정합니다.
<incident id="LND11DEayKr">...</incident> |
| 유형 | 필수 | 다음 중 하나:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
유형에 따라 Waze 앱에서 이벤트가 소비되는 방식이 결정됩니다.
다른 모든 유형은 Waze 지도에 표시되고 근처에 있는 Wazer에게 팝업 알림을 트리거하지만 경로 안내에는 직접적인 영향을 미치지 않습니다. <type>ROAD_CLOSED</type> |
| 하위유형 | 요청됨 | 허용되는 하위 유형 목록을 참고하세요. | 신고된 사고 유형에 대한 더 정확한 설명입니다.
|
| 다중선 | 필수 | 공백으로 구분된 lat lon 쌍의 목록 |
사고 또는 도로 폐쇄 위치를 설명하는 십진수 (DD, 투영 SRID 4326) 위도 및 경도 좌표입니다. 이러한 값은 충분한 정확도를 위해 소수점 이하 자릿수가 6자리 이상이어야 합니다. 좌표 순서는 영향을 받는 트래픽의 방향을 반영해야 합니다. 단일 지점에서 트래픽 방향을 추론할 수 없습니다. 다음 폴리라인은 한 방향의 교통에 영향을 미칩니다 (양방향에 영향을 미치려면 <polyline>51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640 51.503796 0.001051 51.499218 0.001687 51.497365 0.002020</polyline> |
| direction | 요청됨 | BOTH_DIRECTIONS 또는 ONE_DIRECTION |
통행 장애 또는 폐쇄가 도로의 한 방향 또는 양방향 교통에 영향을 미치는지 지정합니다. 폴리라인이 제공된 경우에도 방향을 제공하는 것이 좋습니다. 좌표를 하나만 제공할 수 있는 경우 이벤트가 올바른 운전 방향으로 표시되도록 방향 필드가 필요합니다. <direction>BOTH_DIRECTIONS</direction> |
| 길 | 필수 | 자유 텍스트 | 이벤트가 발생하는 거리 또는 도로의 이름을 지정합니다. <street>NW 12th St</street> |
| starttime | 필수 | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
한 기간의 중단 시작 시간을 지정합니다. ROAD_CLOSED 유형이 아닌 사고의 경우 이를 생략할 수 있으며, 사고가 현재 활성 상태인 것으로 간주됩니다. 타임스탬프는 초 단위의 ISO8601 형식이어야 하며 시간대 오프셋을 포함해야 합니다. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | 요청됨 | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
초 단위의 ISO8601 형식을 사용하여 종료 날짜 및 시간을 지정하고 시간대 오프셋을 포함합니다. 이 값을 생략하면 현재 시작 시간으로부터 14일 후로 기본 설정됩니다. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| 설명 | 요청됨 | 자유 텍스트 | 트래픽 중단의 원인입니다. 이 설명은 40자(영문 기준) 미만이어야 합니다. 40자를 초과하는 설명도 허용되지만 Waze 앱에서 제대로 표시되지 않을 수 있습니다. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| 차선 영향 | 선택사항 | 구조화된 차선 영향 정보 | 사고가 전체 도로 폐쇄가 아니고 한 방향의 교통에 영향을 미치는 경우에만 차선 영향 데이터를 제공하세요.
WZDx 차선 형식 또는 유사한 형식을 사용하여 차선 배열을 지정하여 모든 차선에 관한 정보를 제공합니다.
전체 형식 예: <lanes>
<lane>
<order>1</order>
<type>LANE</type>
<status>CLOSED</status>
</lane>
<lane>
<order>2</order>
<type>LANE</type>
<status>OPEN</status>
</lane>
</lanes>
부분 형식 예: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
| 일정 | 선택사항 | <dayname>hh:mm-hh:mm</dayname> |
인시던트의 모든 시작 및 종료 시간을 캡슐화합니다. <schedule> <monday>09:00-11:00,17:00-21:00</monday> <thursday>09:00-11:00,17:00-21:00</thursday> <friday>09:00-11:00,17:00-21:00</friday> <saturday>00:00-05:00</saturday> <sunday>09:00-18:00</sunday> </schedule> |
사고 및 폐쇄 하위 유형
사고의 성격에 관한 세부정보를 추가로 제공합니다. 허용되는 하위 유형은 제공된 유형에 따라 결정됩니다.
| 유형 | 가능한 하위 유형 |
|---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|