सीआईएफ़एस की खास जानकारी

CIFS (क्लोज़र ऐंड इंसिडेंट फ़ीड स्पेसिफ़िकेशन), Waze का स्टैंडर्ड प्रोटोकॉल है. यह पार्टनर के फ़ीड में, घटना और सड़क बंद होने की जानकारी देने के लिए है.

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

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

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

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

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

सीआईएफ़एस एलिमेंट

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

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

<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) अक्षांश और देशांतर निर्देशांक, जो घटना की जगह या सड़क बंद होने की जगह के बारे में बताते हैं. आम तौर पर, इनमें दशमलव के बाद कम से कम छह अंक होने चाहिए, ताकि सही तरीके से सटीक जानकारी मिल सके.

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

हम किसी एक जगह से ट्रैफ़िक के निर्देश की कटौती नहीं कर सकते.
अगर घटना से सिर्फ़ एक ट्रैफ़िक निर्देश पर असर पड़ता है, तो उस दिशा को साफ़ तौर पर बताने के लिए, अलग से दिशा-निर्देश भी दिए जाने चाहिए.

यह पॉलीलाइन एक ट्रैफ़िक दिशा को प्रभावित करेगी (दोनों दिशाओं को प्रभावित करने के लिए 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>
direction अनुरोध किया गया BOTH_DIRECTIONS या ONE_DIRECTION

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

हमारा सुझाव है कि आप निर्देश भी दें, भले ही पॉलीलाइन दिया गया हो. अगर कोऑर्डिनेट का सिर्फ़ एक सेट दिया जा सकता है, तो दिशा-निर्देश फ़ील्ड को डालना ज़रूरी है. इससे यह पक्का किया जा सकेगा कि इवेंट सही ड्राइविंग दिशा में दिखाया गया हो.

<direction>BOTH_DIRECTIONS</direction>
सड़क ज़रूरी है फ़्री टेक्स्ट

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

<street>NW 12th St</street>
शुरुआत का समय ज़रूरी है yyyy-MM-dd'T'HH:mm:ss+HH:mm

एक अवधि की रुकावट के शुरू होने की तारीख और समय बताता है. आप इसे ऐसी घटनाओं के लिए छोड़ सकते हैं जो रोड_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