הגדרת פידים

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

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

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

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

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

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

אימות XML

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

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

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

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

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

מפרט הפיד

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