Спецификация CIFS
CIFS (спецификация каналов информации о перекрытиях дорог и инцидентах) — стандартный протокол Waze для описания инцидентов и перекрытий дорог в каналах партнеров.
Таблица параметров ниже классифицирует каждый элемент следующим образом:
- Обязательно: без правильно отформатированного значения обязательного тега ваш фид считается недействительным.
- Запрошено: хотя технически это не является обязательным, запрошенные теги считаются рекомендуемыми.
- Необязательно: необязательные теги, позволяющие предоставить больше данных.
Порядок элементов не имеет значения для движка, анализирующего файл.
Эти теги могут описывать как инцидент, так и перекрытие дороги в зависимости от значения тега type . Незначительные различия поясняются при необходимости.
Вот несколько примеров перекрытий дорог в ленте.
Вот несколько примеров инцидентов в ленте.
Помните, что вы можете смешивать закрытия и инциденты в одном файле фида.
Элементы CIFS
| Элемент | Необходимый | Ввод тега | Описание |
|---|---|---|---|
| идентификатор инцидента | Необходимый | Свободный текст | Указывает буквенно-цифровой или числовой идентификатор. <incident id="LND11DEayKr">...</incident> |
| тип | Необходимый | Один из:ROAD_CLOSEDACCIDENTHAZARDPOLICECHIT_CHATJAM | Тип определит, как ваше событие будет использовано приложением Waze. Все остальные типы будут отображаться на карте Waze и вызывать всплывающее уведомление для находящихся поблизости пользователей Waze, но не будут оказывать прямого влияния на маршрутизацию. <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> |
| направление | Запрошено | BOTH_DIRECTIONS или ONE_DIRECTION | Указывает, влияет ли нарушение или закрытие на одно или оба направления движения на дороге. Настоятельно рекомендуется указывать направление, даже если используется ломаная линия. Если можно указать только один набор координат, поле направления обязательно, чтобы событие отображалось с указанием правильного направления движения. <direction>BOTH_DIRECTIONS</direction> |
| улица | Необходимый | Свободный текст | Указывает название улицы или дороги, на которой происходит событие. <street>NW 12th St</street> |
| время начала | Необходимый | yyyy-MM-dd'T'HH:mm:ss+HH:mm | Указывает дату и время начала одного периода нарушения. Для инцидентов, не относящихся к типу ROAD_CLOSED, это значение можно опустить, и мы будем считать, что инцидент в настоящее время активен. Метка времени должна быть в формате ISO8601 с точностью до секунд и включать смещение часового пояса. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| конец времени | Запрошено | 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 | |