Спецификация CIFS
CIFS (Спецификация ленты закрытий и происшествий) — это стандартный протокол Waze для описания происшествий и закрытий дорог в лентах партнеров.
В таблице параметров ниже каждый элемент классифицируется следующим образом:
- Обязательно. Без правильно отформатированного значения обязательного тега ваш фид считается недействительным.
- Запрошено: хотя технически это не требуется, запрошенные теги считаются рекомендуемыми.
- Необязательно: необязательные теги, позволяющие предоставить больше данных.
Порядок элементов не имеет значения для движка, анализирующего файл.
Эти теги могут описывать либо происшествие, либо перекрытие дороги в зависимости от значения тега type . Незначительные различия поясняются там, где это уместно.
Вот несколько примеров перекрытия дорог в ленте.
Вот несколько примеров инцидентов в ленте
Помните, что вы можете смешивать замыкания и инциденты в одном файле ленты.
Элементы CIFS
| Элемент | Необходимый | Ввод тегов | Описание |
|---|---|---|---|
| идентификатор инцидента | Необходимый | Произвольный текст | Указывает буквенно-цифровой или цифровой идентификатор. <incident id="LND11DEayKr">...</incident> |
| тип | Необходимый | Один из:ROAD_CLOSEDACCIDENTHAZARDPOLICECHIT_CHATJAM | Тип будет определять способ использования вашего мероприятия в приложении 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> |
| направление | Запрошено | 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 | |