הסבר קצר
הסקריפט מאפשר טעינה של מקומות שהוגדרו מראש בקובץ ייעודי.
ניתן להוריד את הקובץ לדוגמא במסך של הסקריפט ולמלא ידנית, או ליצור אותו באמצעות כלים אחרים.
לרוב הסקריפט יהיה שימושי כאשר יש רשימה של סניפים/חנויות/מקומות מגורים שצריך להוסיף למפה, והמידע שקיבלנו הוא טבלה עם שם המקום וקואורדינטות שלו.
בעתיד הסקריפט צפוי להתעדכן עם האפשרות לטעון עוד סוגי אובייקטים מלבד מקומות, ולכן שמו הוא יבוא אובייקטים.
מגבלות
- כרגע הסקריפט מאפשר טעינה של מקומות בלבד.
- טעינת המקומות תיעשה על ידי קובץ csv בלבד בעל מבנה מוגדר מראש. במידת הצורך צרו איתי קשר ואשתדל לסייע בהמרת הקובץ הקיים אצלכם לקובץ שהסקריפט ידע לקבל.
חוויית משתמש
כמו תמיד וכמו בכל סקריפט שלי, חשוב לי שהם יעבדו טוב, מהר, לא יפגעו בביצועי העורך, שיהיו אינטואיטיביים לשימוש, וכמובן שישמור על אותו קו עיצובי שהחברה משתמשת בו בשביל לספק את חוויית השימוש הכי טובה ואחידה.
אם נתקלתם במשהו שהוא לא נוח לשימוש, לא מתפקד כמו שצריך, גורם לירידות בביצועי העורך או כל בעיה אחרת, תשלחו לי הודעה בפרטי/בוואטסאפ/פה.
הפעלה
לאחר ההתקנה של הסקריפט, בחלון הסקריפטים בצד שמאל תופיע לשונית חדשה עם הסימן 
(סימן של העלאה וסימן של סיכת מפה). בריחוף על הכרטיסייה, לאחר מספר שניות יופיע הכיתוב “Import Objects”, או “יבוא אובייקטים” אם אתם משתמשים בעורך בשפה העברית.
שימוש (הסקריפט אינטואיטיבי אז תרגישו חופשי לדלג על החלק הזה)
[hide]
בשביל לייבא קובץ, גררו אותו על האזור המסומן, או לחצו עליו ובחרו את הקובץ מהמחשב. יופיע חיווי המסמן שהקובץ הנבחר כרגע נטען ונבדקת תקינותו.
במידה והקובץ נמצא כתקין, יתחלף המסך הראשי במסך התצוגה המקדימה וההגדרות של רשימת המקומות. ניתן יהיה לראות את שם הקובץ הנטען, ניתן יהיה לתת שם לרשימה ולצפות במקומות שצפויים להתווסף.
במסך הראשי ניתן למצוא כפתור המפנה לתיקיית הDrive, בה ניתן יהיה למצוא קבצי תבנית שהסקריפט תומך בהם. כאמור, מאוד רצוי להשתמש בתוכנה שתייצר את הקובץ ולא ליצור אותו ידנית.
כנהוג בסקריפטים שלי, אני משתדל להביא את חוויית המשתמש הכי טובה ואינטואיטיבית, תוך שמירה על קווי העיצוב של החברה, ולכן, כל המקומות כבר מופיעים אצלכם במפה, אולם עדיין לא נשלחו לשרתי Waze, ולכן, באפשרותכם לראותם במפה כמקומות חדשים. ניתן גם ללחוץ על כרטיסיית המקום שמופיע ברשימת התצוגה המקדימה על מנת לסמנו. על מנת למנוע טעויות ושגיאות עריכה, ומאחר והמקומות עוד לא נוספו למפה, עריכתם נעולה.
במידה והקובץ שנבחר חשוד כאחד שנוסף בעבר, תופיע אזהרה מתאימה. שימו לב כי הבדיקה נעשית אך ורק מול מאגר הרשימות הקיימות אצלכם בדפדפן, ולכן שימוש בדפדפן אחר יגרום לאי זיהוי של הקובץ כקיים. גם רשימות שנטענו על ידי עורך אחר לא יזוהו. כמו-כן שימו לב כי המנגנון לא מושלם ולעולם לא יהיה מושלם, ושינוי אפילו של תו אחד בתוכן הקובץ עלול לגרום לאי זיהוי שלו, ולכן, רצוי לוודא שהרשימה לא נטענה בעבר.
לאחר לחיצה על כפתור היבוא, תתחיל הפעולה של הוספת המקומות למפה. עד להשלמת התהליך לא תתאפשר עריכה והזזה של המפה. לאחר התחלת תהליך היבוא, תופיע הודעה שתשקף את המתרחש מאחורי הקלעים. אם לא יהיה ניתן להוסיף את המקומות מכל סיבה שהיא, תופיע הודעה מתאימה. אחרת, המפה תעודכן והרשימה תישמר בזיכרון הדפדפן, ותועברו למסך התצוגה של רשימה שמורה.
במסך של רשימה שמורה ניתן יהיה לצפות בשם הרשימה, במקומות שנוספו, או למחוק את כלל המקומות שנוספו וכן את הרשימה מהזיכרון.
שימו לב כי רשימת המקומות השייכים לרשימה שמורים גם כן בזיכרון הדפדפן ולא מתעדכנים לאחר מכן, ולכן, במידה ומקום כלשהו נמחק/מוזג, אומנם המפה “תקפוץ” למקום שבו היה המקום, אך הוא לא יסומן ופרטיו לא יופיע בחלון העריכה. הדבר נכון גם לגבי מקומות שהוזזו יתר על המידה וכבר לא נמצאים באזור המקורי שלהם, אם כי מחיקת הרשימה תוכל למחוק גם מקומות שהוזזו.
לחיצה על כפתור המחיקה תלווה בשאלת אישור. לאחר מתן האישור יתחיל תהליך המחיקה. כלל המקומות שנוספו יימחקו מהמפה. הודעה רלוונטית תוצג למשתמש עד לסיום התהליך.
הסקריפט יודע לזהות מקומות שנמחקו בעבר וימשיך במחיקת יתר המקומות, תוך כדי הצגת הודעה מתאימה. לאחר סיום תהליך המחיקה, הרשימה תימחק מזיכרון הדפדפן ותוסר מרשימת הרשימות, וכן תוצג הודעה המאשרת את מחיקת הרשימה.
במידה ומסיבה כלשהי לא היה ניתן למחוק חלק מהמקומות, הרשימה לא תימחק מזיכרון הדפדפן ויישארו בה רק המקומות שלא נמחקו.
שימו לב כי במידה ומקום כלשהו נעול מעל לרמתכם או נמצא בקמפיין פרסום או שאין לכם הרשאה מלאה למחיקתו, תיווצר בקשת עדכון מקום. מקום שכזה ייחשב כמקום שנמחק, אם כי עדיין יידרש אישור של עורך בעל הרשאה מתאימה למחיקתו הסופית.
אם אין כלל הרשאה למחיקתו של המקום, לדוגמא במקרה שהמקום נמצא מחוץ לאזור העריכה שלכם, הרי שלא תיווצר בקשת עדכון מקום, והסקריפט יציג אותו כמקום שלא נמחק.
[/hide]
מבנה הקובץ (csv)
הסקריפט תומך בטעינת קבצים מסוג csv. קבצים אלה נוחים לשימוש ולצפייה של כל משתמש ודומה במבנו לקובץ מסוג Excel.
תוכן הקובץ בנוי במבנה של טבלה עם עמודות ושורות. כל שורה בקובץ מסמלת מקום ייחודי. העמודות בקובץ מסמלות את המידע לגבי כל מקום, שימו לב כי אין לשנות את סדר העמודות בקובץ, שכן השם המופיע בשורה הראשונה נועד לשימוש על ידי העורכים או ממלאי הקובץ בלבד, והסקריפט לא משתמש במידע המופיע שם. לכן, חשוב גם לוודא שהמקומות נוספים לטבלה אך ורק מהשורה השנייה והלאה, אחרת, הסקריפט ידלג על המקום.
ככלל, אין צורך למלא אף עמודה בקובץ, פרט לאלה שבסופם מופיע סימון כוכבית (*) המסמל שדה נדרש.
רשימת העמודות
- סוג האובייקט. בשביל מקומות זה תמיד יהיה “venue” (בלי המירכאות)
- שם המקום. נדרש למילוי.
- שם הרחוב. במידה ואין שיוך לרחוב או שאין בכך צורך, יש להשאיר ריק.
- שם העיר. במידה ואין שיוך לעיר או שאין בכך צורך, יש להשאיר ריק. יש להשתמש אך ורק בשם עיר המדויק שמופיע במפה.
- שם המדינה (state). בשימוש בחלק ממדינות העולם, ביניהם ארה"ב. במידה ורלוונטי (לא בישראל) יש למלא את שם המדינה במדויק כפי שמופיע במפה. במידה ולא רלוונטי, יש להשאיר ריק.
- מספר בית. אם אין צורך יש להשאיר ריק.
- שם המדינה (country). נדרש למילוי. השם חייב להיות בדיוק כפי שמופיע במפה (לרוב בשפה האנגלית) או קיצור של שם המדינה בראשי תיבות בשפה האנגלית. לדוגמא, ישראל ניתן להכניס כIsrael או כIL.
- קו רוחב (latitude). נדרש למילוי. רצוי לספק לפחות 6 ספרות לאחר הנקודה העשרונית לדיוק מירבי.
- קו אורך (longitude). נדרש למילוי. רצוי לספק לפחות 6 ספרות לאחר הנקודה העשרונית לדיוק מירבי.
- קטגוריות. נדרש למילוי. ניתן לציין מספר קטגוריות על ידי הפרדתן באמצעות פסיק. ניתן לראות רשימה של הקטגוריות הזמינות לשימוש כאן.
- תיאור. במידה ואין יש להשאיר שדה זה ריק.
- רמת נעילה. כברירת מחדל רמת הנעילה תהיה 1.
- כתובת אתר אינטרנט. במידה ואין יש להשאיר ריק.
- מספר טלפון. במידה ואין יש להשאיר ריק.
להתקנה
ניתן להתקין את הסקריפט באמצעות שימוש בTampermonkey. את הסקריפט עצמו ניתן להוריד מכאן.
תודה מיוחדת ל@zeze13 על הרעיון והעזרה בפיתוח הסקריפט