مشخصات 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 را تعیین می کند. همه انواع دیگر در نقشه Waze نشان داده می شوند و یک اعلان بازشو برای Wazers در نزدیکی راه اندازی می کنند، اما هیچ تاثیر مستقیمی بر مسیریابی ندارند. <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> |
خیابان | ضروری | متن آزاد | نام خیابان یا جاده ای را که رویداد در آن رخ می دهد مشخص می کند. باید با نقشه 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 |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|