הגדרת פידים

המידע הבא יעזור לכם להגדיר את הפידים ולהפעיל אותם בצורה נכונה.

אירוח קבצים של פידים

מערכת רכישת התוכן של Waze מאחזרת באופן אוטומטי את נתוני הפיד שלכם מעת לעת. כדי לוודא ש-Waze מאחזר את קובץ הפיד הנכון:

  • הופכים אותו לנגיש: משתמשים בפרוטוקולים סטנדרטיים של רשת (HTTP,‏ HTTPS,‏ FTP או SFTP) או ב-Google Cloud Storage‏ (GCS).
  • מאבטחים את הנתונים (אופציונלי):
    • אתם יכולים להגן על הפיד באמצעות שם משתמש וסיסמה, עם אימות מסוג BASIC דרך HTTPS. אתם מספקים את שילוב שם המשתמש והסיסמה דרך מרכז השותפים.
    • בנוסף, אנחנו תומכים בשילובים של API שמשתמשים באימות מבוסס-כותרת באמצעות כותרת KeyID או Ocp-Apim-Subscription-Key.
    • לקבצים ב-GCS, אפשר להגביל את הגישה לחשבון שירות שאנחנו נספק.
  • בודקים את הנגישות: צריך לוודא שאפשר לגשת לקובץ מכל מקום בעולם.
    • כדי למנוע שיבושים באחזור הנתונים, חשוב לוודא שחומת האש לא חוסמת גישה על סמך מדינה, כתובת IP או אזור גיאוגרפי. יכול להיות שההגבלות האלה ימנעו מאיתנו לאחזר את נתוני הפיד שלכם.
    • אנחנו משתמשים במערכת דינמית כדי לשלוף מידע על סגירות ואירועים. המשמעות היא שאנחנו לא משתמשים בכתובות IP סטטיות ולא תומכים בהרשאה מראש של כתובת URL, דומיין או תו כללי לחיפוש, או בהרשאה של רשומת DNS.

תדירות העדכון של הפיד

מערכת רכישת התוכן מאחזרת נתונים כל כמה דקות. אם יש לכם דרישות מיוחדות לגבי תדירות הפיד, תוכלו להוסיף הערה עם הבקשה כשאתם שולחים את הפיד, או לפנות לצוות Waze כדי שנוכל להתאים את תקופות הסקר שלנו למחזור העדכון של הפיד.

אימות XML

מערכת Waze משתמשת בסכימת ה-XML הבאה כדי להגדיר את המבנה הקביל של פיד Closure and Incidents Feed Specifications (CIFS): https://www.gstatic.com/road-incidents/cifsv2.xsd.

יש באינטרנט מספר כלים שיכולים לעזור לכם לאמת את המבנה של פידים בפורמט XML. בין השאר:

שינויים קריטיים בפיד

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

  • שינוי של אזורים או מדינות בפיד, הוספה או הסרה שלהם.
  • עדכון של כתובת ה-URL של הפיד או של פרטי הכניסה שנדרשים כדי לגשת למידע.
  • שינוי מבנה הפיד או שמות התגים.

מפרט הפיד

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