בניית פיד של שותף

כדי ליצור פיד של שותף, צריך לבצע את התהליך הבא.

1. יוצרים את קובצי הפיד בפורמט XML או JSON.
2. מאכלסים את הפיד בנתונים רלוונטיים (לדוגמה: סגירת כבישים, אירועים או כלי רכב בתנועה). הערה: אפשר לספק מידע על חסימות כבישים ועל אירועי תנועה באותו פיד.

   מומלץ להשתמש בבודק סכימות כדי לוודא שהפורמט של הקובץ תקין ושהוא כולל את כל הפרמטרים הנדרשים. פרטים ספציפיים על רכיבי הפיד זמינים במאמרים בנושא אימות XML (לגבי ארגון הקובץ), רכיבים של סגירת כבישים, רכיבים של אירועים ורכיבים של כלי רכב בתנועה. המערכת לא תעבד קבצים בפורמט שגוי או קבצים חלקיים לצורך פרסום.

3. מפרסמים את הקובץ במקום שאפשר לגשת אליו באמצעות דפדפן אינטרנט. הוראות לגבי הדרישה הזו מופיעות במאמר בנושא אירוח של קובץ פיד.
4. אם כבר הצטרפתם ל מרכז השותפים, אתם יכולים להתחבר לחשבון הפורטל של הארגון שלכם ולהוסיף קישור או להעלות את הקובץ למערך הנתונים הרלוונטי. אם עדיין לא נרשמתם כשותפים בתוכנית Waze לערים (WFC), עליכם למלא בקשה. כדי שקבצים של פידים יתקבלו לפרסום, צריך להיות שותפות.
5. אחרי פרסום הקובץ, נוודא שהפורמט והסכימה שלו נכונים. אנחנו יכולים לבצע שינויים קלים, אבל אם יש פגמים משמעותיים יותר, נחזיר לכם את הקובץ כדי שתתקנו אותו. אם קובץ הפיד מוחזר אליכם, אתם צריכים לתקן את הקובץ ואז לעדכן את הבקשה בפורטל עם קישור ישיר לקובץ הפיד המתוקן.
6. אחרי שהפיד שלכם יוטמע במערכות שלנו, Waze תאחזר באופן אוטומטי את הנתונים ותוסיף למפה את האירועים הרלוונטיים, את החסימות ומידע נוסף. הנתונים נשלפים אוטומטית כל כמה דקות, ואחרי שהם נשלפים, יכול לעבור עוד כמה דקות עד שהמידע יופיע באפליקציית Waze. אם יש לכם דרישה מיוחדת לגבי תדירות העדכון, אתם יכולים לפנות לצוות Waze.

שיתוף פורמטים של פידים שאינם CIFS

‫ESRI (ArcGIS)

משתמשי ArcGIS יכולים להגדיר פידים תואמים על ידי שיתוף שכבת RoadClosures_public בפתרון Road Closures. כדי להשתמש בשכבת RoadClosures_public, פועלים לפי ההוראות האלה בדף ESRI ArcGIS Solutions. מאגנים את הנתונים בשכבה Closures ומשתפים אותם עם Waze. שכבות מעקפים וחסימות לא אפשריות.

‫Waze דורשת את הנתונים ומשתמשת בהם באופן הבא:

שדה שכבת החסימות	שדות של Waze (רכיב CIFS)	חובה	דרישות ושימוש בנתונים
globalID	מזהה האירוע	חובה	מזהה ייחודי ראשי. צריך לספק UUID קבוע שנוצר על ידי המערכת ולא משתנה לאורך כל מחזור החיים של התכונה.
reason + laneimpact	type, subtype	חובה	המאפיינים reason ו-laneimpact ממופים לסוגים/סוגי משנה של Waze CIFS. ‫"reason" ערכים מקודדים: "Construction",‏ "Event",‏ "Hazard" ‫"laneimpact" ערכים מקודדים: "All Lanes" (כל הנתיבים), "Some Lanes" (חלק מהנתיבים), "Alternating One Way" (נתיב חד-סטרי לסירוגין) חשוב: הערך laneimpact שמשותף עם 'כל הנתיבים' או 'חלק מהנתיבים' מציין סגירה פונקציונלית של נתיבים, ולא רק צמצום של הכביש. הערך 'כל הנתיבים' מתפרש כסגירה מלאה. שאר הערכים המקודדים ממופים להתראות. דוגמאות: המיפוי של 'סיבה' = 'בנייה' ושל 'השפעה על הנתיב' = 'כל הנתיבים' הוא לסוג ROAD_CLOSED ולסוג משנה ROAD_CLOSED_CONSTRUCTION ב-Waze. המיפוי של 'סיבה' = 'אירוע' ו'השפעה על הנתיב' = 'חלק מהנתיבים' הוא לסוג Waze‏ HAZARD ולסוג משנה Waze‏ HAZARD_ON_ROAD_LANE_CLOSED. ‫'reason' = 'Hazard', ו-'laneimpact' = 'Alternating One Way' ממופים לסוג Waze‏ HAZARD ולסוג המשנה של Waze‏ HAZARD_ON_ROAD.
geometry/paths	קו פוליגוני	חובה	צריך לספק קואורדינטות של קווי אורך ורוחב בשיטת מעלות עשרוניות (DD, הקרנה SRID 4326) שמתארות את המיקום של התקרית או של חסימת הכביש. כדי להבטיח רמת דיוק מספקת, מומלץ להזין לפחות 6 ספרות אחרי הנקודה העשרונית. סדר הקואורדינטות צריך לשקף את כיוון התנועה שמושפע.
direction	direction	נשלחה בקשה	מציינים אם השיבוש או הסגירה משפיעים על כיוון תנועה אחד בכביש או על שני הכיוונים. ‫One Direction ממופה ל-ONE_DIRECTION, ו-Both Directions ממופה ל-BOTH_DIRECTIONS.
street	רחוב	חובה	מציין את שם הרחוב או הכביש שבהם מתרחשת התקרית. אי אפשר להוסיף ל-Waze אירוע שלא מצוין בו רחוב.
starttime	starttime	חובה	מציין את תאריך ושעת ההתחלה של תקופת שיבוש אחת. חותמת הזמן יכולה להיות בפורמט Epoch או בפורמט ISO8601 ברמת דיוק של שניות, והיא כוללת את ההפרש מאזור הזמן.
endtime	endtime	נשלחה בקשה	מציינים את תאריך ושעת הסיום בפורמט Epoch או ISO8601 ברמת דיוק של שניות, וכוללים את ההפרש מאזור הזמן. אם לא מציינים את הערך הזה, כרגע ברירת המחדל היא 14 ימים אחרי שעת ההתחלה.
description	תיאור	נשלחה בקשה	הגורם לשיבוש בתנועה. התיאור צריך לכלול פחות מ-40 תווים. תיאור באורך של יותר מ-40 תווים יתקבל, אבל יכול להיות שהוא לא יוצג בצורה תקינה באפליקציית Waze.
activeincid	לא רלוונטי	אופציונלי	כל אירוע שבו הערך של activeincid הוא No, יידלג ולא יוכנס ל-Waze.
accessallowed	לא רלוונטי	אופציונלי	ללא התייחסות. אירועים ב-Waze משפיעים על כל הנהגים.