مشخصات CIFS

CIFS (Closure and Incident Feed Specification) پروتکل استاندارد Waze برای توصیف حوادث و بسته شدن جاده ها در فیدهای شرکا است.

جدول پارامترهای زیر هر عنصر را به صورت زیر طبقه بندی می کند:

  • مورد نیاز: بدون یک مقدار فرمت شده مناسب برای یک برچسب مورد نیاز، فید شما نامعتبر در نظر گرفته می شود.
  • درخواست شده: در حالی که از نظر فنی مورد نیاز نیست، برچسب های درخواستی توصیه شده در نظر گرفته می شوند.
  • اختیاری: تگ های اختیاری که به شما امکان می دهد داده های بیشتری ارائه دهید.

ترتیب عناصر برای موتور تجزیه کننده فایل مهم نیست.

این برچسب ها می توانند یک حادثه یا یک جاده بسته را با توجه به مقدار برچسب type توصیف کنند. تفاوت های جزئی در موارد مرتبط توضیح داده شده است.

در اینجا چند نمونه از بسته شدن جاده ها در فید آورده شده است
در اینجا چند نمونه از حوادث در یک فید آورده شده است
به یاد داشته باشید که می توانید Closures و Incidents را در یک فایل فید مخلوط کنید.

عناصر CIFS

عنصر ضروری ورودی برچسب شرح
شناسه حادثه ضروری متن آزاد

یک شناسه الفبایی یا عددی را مشخص می کند.
شناسه باید در فید شما منحصر به فرد باشد و در طول عمر یک حادثه ثابت بماند.

<incident id="LND11DEayKr">...</incident>
نوع ضروری یکی از:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM

نوع نحوه مصرف رویداد شما توسط برنامه Waze را تعیین می کند.
ROAD_CLOSED منجر به بسته شدن کامل خواهد شد.

همه انواع دیگر در نقشه Waze نشان داده می شوند و یک اعلان بازشو برای Wazers در نزدیکی راه اندازی می کنند، اما هیچ تاثیر مستقیمی بر مسیریابی ندارند.

<type>ROAD_CLOSED</type>
زیرنوع درخواست شده است لیست زیرگروه های مجاز را ببینید

توضیح دقیق تر برای نوع حادثه گزارش شده.
نوع فرعی باید با مقدار ارائه شده در برچسب نوع مطابقت داشته باشد.
در اینجا لیست کامل زیرگروه های مجاز در هر نوع آمده است

چند خطی ضروری لیست جای خالی جدا شده است
جفت lat lon

مختصات طول و عرض جغرافیایی درجات اعشاری (DD، طرح ریزی SRID 4326) که مکان حادثه یا بسته شدن جاده را توصیف می کند. اینها در حالت ایده آل باید حداقل 6 رقم بعد از نقطه اعشار برای دقت کافی داشته باشند.

ترتیب مختصات باید منعکس کننده جهت ترافیکی باشد که تحت تأثیر قرار می گیرد.

ما نمی توانیم جهت ترافیک را از یک نقطه کسر کنیم.
اگر حادثه فقط یک جهت ترافیکی را تحت تأثیر قرار دهد ، باید مختصات دیگری برای روشن شدن جهت ارائه شود.

چند خط زیر بر یک جهت ترافیک تأثیر می گذارد (یک عنصر direction را اضافه کنید تا بر هر دو جهت تأثیر بگذارد):

<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>
خیابان ضروری متن آزاد

نام خیابان یا جاده ای را که رویداد در آن رخ می دهد مشخص می کند. باید با نقشه Waze مطابقت داشته باشد.

<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
ACCIDENT_MINOR
ACCIDENT_MAJOR
HAZARD
HAZARD_ON_ROAD
HAZARD_ON_ROAD_CAR_STOPPED
HAZARD_ON_ROAD_CONSTRUCTION
HAZARD_ON_ROAD_EMERGENCY_VEHICLE
HAZARD_ON_ROAD_ICE
HAZARD_ON_ROAD_LANE_CLOSED
HAZARD_ON_ROAD_OBJECT
HAZARD_ON_ROAD_OIL
HAZARD_ON_ROAD_POT_HOLE
HAZARD_ON_ROAD_ROAD_KILL
HAZARD_ON_ROAD_TRAFFIC_LIGHT_FAULT
HAZARD_ON_SHOULDER
HAZARD_ON_SHOULDER_ANIMALS
HAZARD_ON_SHOULDER_CAR_STOPPED
HAZARD_ON_SHOULDER_MISSING_SIGN
HAZARD_WEATHER
HAZARD_WEATHER_FLOOD
HAZARD_WEATHER_FOG
HAZARD_WEATHER_FREEZING_RAIN
HAZARD_WEATHER_HAIL
HAZARD_WEATHER_HEAT_WAVE
HAZARD_WEATHER_HEAVY_RAIN
HAZARD_WEATHER_HEAVY_SNOW
HAZARD_WEATHER_HURRICANE
HAZARD_WEATHER_MONSOON
HAZARD_WEATHER_TORNADO
ROAD_CLOSED

ROAD_CLOSED_HAZARD
ROAD_CLOSED_CONSTRUCTION
ROAD_CLOSED_EVENT
JAM

JAM_LIGHT_TRAFFIC
JAM_MODERATE_TRAFFIC
JAM_HEAVY_TRAFFIC
JAM_STAND_STILL_TRAFFIC
POLICE

POLICE_VISIBLE
POLICE_HIDING