FAQ and Troubleshooting he - msupino/NavigationApp GitHub Wiki

🇬🇧 English

שאלות ותשובות ופתרון בעיות

שאלות נפוצות

האם NavAid הוא כלי תכנון טיסות רשמי?

לא. NavAid הוא פרויקט תחביב חינמי. אין להשתמש בו כמקור יחיד לניווט במהלך טיסה. תמיד בדקו מול מפות רשמיות עדכניות ותוכנת EFB מאושרת.

האם זה עובד מחוץ לישראל?

כן להצגת המפה (ניתן לגלול לכל מקום; OSM / Esri מכסים את כל העולם). שכבות נקודות הנתיב ושדות התעופה הן נתונים ישראליים בלבד.

האם המסלול שלי מועלה לאנשהו?

המסלול הפעיל והעריכה נשמרים מקומית כברירת מחדל, אך NavAid אינו מערכת מקומית בלבד: סנכרון Drive, בקשות AI והגשת תכנית טיסה שולחים את המידע הנדרש כאשר מפעילים אותם. מפות, נכסי אפליקציה ונתוני מזג אוויר/תעופה נטענים משירותים חיצוניים, ובזמן הפעלה נטען קובץ tuning קטן מ־GitHub Gist ללא תוכן מסלול/פרופיל. אתר האינטרנט הציבורי טוען גם Google Analytics (GA4), שרואה שימוש אנונימי בלבד — לעולם לא מסלול, מיקום, תוכנית טיסה או פרופיל. הוא סופר שלושה כפתורים לפי שמם, בלי שום פרט נוסף: פתיחת תוכנית הטיסה ה-ICAO, תוכנית השיוט או בקשת חניה באפליקציית הדואר. כך יודעים כמה משתמשים בתכונה, לא מי השתמש בה או מה נשלח. הוא אינו נטען באפליקציית Android/iOS, בגרסאות staging, בתצוגות מקדימות של PR או ענף, או בהרצה מקומית.

האם אפשר להשתמש במצב לא מקוון?

כן — התקינו כ-PWA וטענו את המסלול לפחות פעם אחת עם אינטרנט.

למה אריחי המפה מטושטשים לפעמים?

ספק המפה מגיש פירמידת אריחים קבועה (מקסימום z13 ל-CVFR). מעבר לזום זה, NavAid מגדיל אריחים בדפדפן. לפרטי הדפסה, השתמשו בשמור PNG.

למה הנטייה המגנטית שלילית?

NavAid משתמש במוסכמה: מגנטי = אמיתי + נטייה. ישראל היא בערך 5° מזרחה מצפון אמיתי, כך שהערך הוא -5. הרמז ליד השדה מציג (5°E) לבהירות.

איך מדפיסים רק את תוכנית הטיסה, לא את המפה?

פתחו את תוכנית הטיסה (📋) ולחצו על הדפס.

איך משתפים מסלול?

כן, בשתי דרכים:

  • 🔗 Share — מעתיק ללוח כתובת URL עצמאית של המסלול הנוכחי (קואורדינטות מקודדות polyline + שמות ב-base64url, עד 64 נקודות). הנמען פשוט פותח את הקישור ו-NavAid טוען את אותו מסלול.
  • ייצוא/ייבוא קובץ — מייצאים JSON (או GPX / PLN) ושולחים; הנמען מייבא.

האם NavAid יכול לפתוח את דפיות השדה?

כן. לחצו על נקודת ציון ששמה תואם קוד ICAO של שדה (למשל LLBG), והחלונית תציג את הדפיות הזמינות מקובצות לפי סוג (גישה, SID, STAR, קרקע, VFR/שדה, אחר). לחיצה על תווית פותחת את ה-PDF במציג מסך מלא עם כפתורי סגירה, הורדה ופתיחה בלשונית.

האם יש התראות בזמן טיסה?

כן, כשמקליטים מסלול, כשהאפשרות מיקום פעילה או כשסימולטור מחובר: הקטע הבא, קריאת הטופ, חריגת גובה, סחיפה מהמסלול ויציאה מכל הקטעים. ההתראות הן התראות מכשיר רגילות, ולכן כל שעון או מסך שמשקף את הטלפון יציג אותן. ראו הקלטת מסלול GPS.

למה כפתור העוזר החכם לא מופיע?

הוא כבוי כברירת מחדל באתר החי. ראו עוזר AI להפעלה.

פתרון בעיות

"המסלול שלי נעלם אחרי רענון"

סיבות אפשריות:

  1. מצב גלישה פרטית / אנונימי — localStorage נמחק בסגירת החלון.
  2. חריגה ממכסת localStorage — NavAid מציג התראה כדי שתוכלו לייצא את המסלול לפני המשך העבודה. נסו לייצא ולמחוק מסלולים שמורים שאינם נחוצים.
  3. דפדפן אחר — localStorage הוא לדפדפן, למכשיר.
  4. מסלול שמור פגום — הגרסה הנוכחית מתריעה ושומרת את הערך המקורי localStorage["navaid.route"] במקום לדרוס אותו במצב ריק.

תמיד ייצאו מסלולים חשובים לקובץ JSON כגיבוי.

"יבוא אומר שקובץ ה-JSON לא תקין"

האימות מחמיר: שדות חובה חייבים להיות נוכחים ומסוג נכון. שדות נוספים מותרים, אך שדות חסרים נדחים.

"תוצאת שמור PNG נראית לא נכונה / ריקה / קטועה"

  • המפה ננעלת בזמן הייצוא לשמירה על יישור האריחים.
  • בהירות המפה מוחלת על שכבת הבסיס; השכבות העליונות נשארות בשקיפות מלאה.

"נקודות הנתיב או שדות התעופה נעלמו"

כבו והדליקו את השכבה, או רעננו אם הרשת לא זמינה.

"הערה שהונחה על נקודת ציון לא נבחרת"

זום פנימה או גררו אלמנט אחד הצידה.

"טקסט בעברית מוצג כריבועים / תוים שגויים"

וודאו שלגופני הדפדפן יש תמיכה בעברית.

"ניקיתי מטמון ועכשיו NavAid לא נטען במצב לא מקוון"

פתחו את האתר פעם אחת עם אינטרנט כדי שה-Service Worker יירשם מחדש.

"Bing / Google לא מוצאים את NavAid"

לאתר יש מטא-נתוני SEO, sitemap, hreflang ואימות Bing. אינדוקס במנועי החיפוש עדיין עשוי לפגר אחרי הפריסות בכמה ימים.

"כפתור לא עושה כלום באפליקציה המותקנת"

זה קרה, והסיבה תמיד הייתה אותה אחת. דף אינו הבעלים של alert(), confirm() או prompt(): דפדפן רשאי להשתיק אותם, ו-WebView באנדרואיד מציג כזה רק אם האפליקציה המארחת מממשת אותו — והמעטפת של NavAid לא. לכן ב-APK כל סירוב היה שקט, והפקד נראה שבור: תכנית הטיסה לא נפתחה, "הפסק שיתוף" נראה תקוע, וכפתור שם המעקב לא עשה דבר.

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

דיווח על באג

  1. בדקו רשימת Issues.
  2. אם הבעיה חדשה, פתחו Issue עם דפדפן + מערכת הפעלה, צעדים לשחזור, ותוצאה צפויה מול בפועל.
  3. אם זה דחוף ואתם יכולים לתקן — ראו תרומה.
⚠️ **GitHub.com Fallback** ⚠️