CIFS स्पेसिफ़िकेशन

CIFS (Closure and Incident Feed Specification), Waze का स्टैंडर्ड प्रोटोकॉल है. इसका इस्तेमाल, पार्टनर के फ़ीड में समस्याओं और सड़क बंद होने की जानकारी देने के लिए किया जाता है.

यहां दी गई पैरामीटर टेबल में, हर एलिमेंट को इस तरह से कैटगरी में बांटा गया है:

  • ज़रूरी है: ज़रूरी टैग के लिए सही फ़ॉर्मैट में वैल्यू न देने पर, आपके फ़ीड को अमान्य माना जाता है.
  • अनुरोध किया गया: तकनीकी तौर पर इसकी ज़रूरत नहीं होती, लेकिन अनुरोध किए गए टैग इस्तेमाल करने का सुझाव दिया जाता है.
  • ज़रूरी नहीं: ऐसे टैग जिनकी मदद से ज़्यादा डेटा दिया जा सकता है.

फ़ाइल को पार्स करने वाले इंजन के लिए, एलिमेंट का क्रम मायने नहीं रखता.

type टैग की वैल्यू के हिसाब से, ये टैग किसी घटना या सड़क बंद होने के बारे में जानकारी दे सकते हैं. जहां ज़रूरी है वहां मामूली अंतर के बारे में बताया गया है.

यहां फ़ीड में सड़क बंद होने की जानकारी के कुछ उदाहरण दिए गए हैं
यहां फ़ीड में घटनाओं की जानकारी के कुछ उदाहरण दिए गए हैं
ध्यान रखें कि एक ही फ़ीड फ़ाइल में सड़क बंद होने और घटनाओं की जानकारी को शामिल किया जा सकता है.

CIFS एलिमेंट

एलिमेंट ज़रूरी है टैग इनपुट ब्यौरा
अनुरोध का आईडी ज़रूरी है फ़्री टेक्स्ट

यह अक्षर और अंक या संख्या वाला आइडेंटिफ़ायर तय करता है.
आईडी, आपके फ़ीड में यूनीक होना चाहिए. साथ ही, समस्या के दौरान यह स्टेबल रहना चाहिए.

<incident id="LND11DEayKr">...</incident>
टाइप ज़रूरी है इनमें से कोई एक:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM

टाइप से यह तय होगा कि Waze ऐप्लिकेशन में आपका इवेंट किस तरह दिखेगा.
ROAD_CLOSED का मतलब है कि सड़क पूरी तरह से बंद है.

अन्य सभी तरह की सूचनाएं, Waze के मैप पर दिखेंगी. साथ ही, आस-पास के Wazers के लिए पॉप-अप सूचना ट्रिगर करेंगी. हालांकि, इससे रूटिंग पर कोई सीधा असर नहीं पड़ेगा.

<type>ROAD_CLOSED</type>
उप-प्रकार अनुरोध किया गया अनुमति वाले सबटाइप की सूची देखें

रिपोर्ट की गई घटना के टाइप के बारे में ज़्यादा सटीक जानकारी.
सबटाइप, टाइप टैग में दी गई वैल्यू से मेल खाना चाहिए.
हर टाइप के लिए अनुमति वाले सबटाइप की पूरी सूची यहां दी गई है

पॉलीलाइन ज़रूरी है स्पेस से अलग किए गए
lat lon जोड़े की सूची

दशमलव डिग्री (डीडी, प्रोजेक्शन एसआरआईडी 4326) में अक्षांश और देशांतर के निर्देशांक. इनसे सड़क बंद होने या किसी घटना की जगह की जानकारी मिलती है. सटीक जानकारी के लिए, इनमें दशमलव के बाद कम से कम छह अंक होने चाहिए.

कोऑर्डिनेट का क्रम, उस ट्रैफ़िक की दिशा के हिसाब से होना चाहिए जिस पर असर पड़ा है.

हम किसी एक पॉइंट से ट्रैफ़िक की दिशा का पता नहीं लगा सकते.
अगर समस्या का असर सिर्फ़ एक दिशा में जाने वाले ट्रैफ़िक पर पड़ता है, तो दिशा के बारे में बताने के लिए एक और कोऑर्डिनेट देना चाहिए.

नीचे दी गई पॉलीलाइन से, ट्रैफ़िक की एक दिशा पर असर पड़ेगा. दोनों दिशाओं पर असर डालने के लिए, 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>
सड़क ज़रूरी है फ़्री टेक्स्ट

इससे उस सड़क का नाम पता चलता है जिस पर इवेंट हो रहा है.

<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

आईएसओ8601 फ़ॉर्मैट का इस्तेमाल करके, सेकंड के हिसाब से इवेंट खत्म होने की तारीख और समय बताएं. साथ ही, टाइमज़ोन ऑफ़सेट शामिल करें

अगर आपने इसे शामिल नहीं किया है, तो फ़िलहाल यह शुरू होने के समय के 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 लेन फ़ॉर्मैट या इसी तरह के फ़ॉर्मैट का इस्तेमाल करें.
लेन पर असर पड़ने की जानकारी दो फ़ॉर्मैट में दी जा सकती है - पूरी और आंशिक.

पूरे फ़ॉर्मैट का उदाहरण:
<order>1</order> सबसे बाईं ओर की लेन को दिखाता है.

<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
POLICE_WITH_MOBILE_CAMERA