Repository navigation
Troubleshooting
קובץ ההתקנה עדיין לא חתום בתעודה מסחרית, ולכן Windows SmartScreen מציג אזהרה.
פתרון:
- לחצו "מידע נוסף"
- לחצו "הפעל בכל זאת"
הקובץ נבנה אוטומטית מקוד המקור הפתוח ב-GitHub Actions. אפשר לאמת את ה-SHA-256 שלו מול ה-Releases.
האפליקציה משתמשת ב-WebView2 של Microsoft לתצוגת החלון.
WebView2 מותקן מראש ב:
- Windows 11
- Windows 10 מעודכן
אם WebView2 לא מותקן: start-windows.cmd (וקיצור הדרך בשולחן העבודה) פותחים את הדפדפן הרגיל במקום חלון האפליקציה. הכול עובד בדיוק אותו הדבר – רק ללא חלון ייעודי עם לשוניות.
תסמין: עדכון הנתונים נכשל.
פתרון: בקשו מהסינון לפתוח את הכתובות הבאות:
github.com
release-assets.githubusercontent.com
objects.githubusercontent.com
לתצלומי האוויר (אופציונלי):
cdn.govmap.gov.il (govmap)
tiles.maps.eox.at (Sentinel-2, חלופה)
למה זה בטוח? שלמות כל קובץ נבדקת מול SHA-256 לפני ההתקנה – הסינון לא יכול לשנות תוכן קבצים.
אם Python דוחה את תעודת הסינון: התוכנה שולחת אוטומטית ניסיון נוסף ללא אימות תעודה (כמו tools/terrain.py). הבדיקה בכל מקרה מתבצעת לפי SHA-256.
| תסמין | פתרון |
|---|---|
| "Docker Desktop is not installed / not running" | התקינו והפעילו Docker Desktop, ואז הריצו שוב setup.cmd
|
| הבנייה נעצרת עם "Killed" או "out of memory" | הגדילו זיכרון Docker ל-6–8GB: Settings ← Resources |
| "שירות הניווט אינו זמין כרגע" | הניווט עדיין בהכנה. עקבו: docker compose logs -f routing
|
| מוצגת "מפה פשוטה" | מפת הבסיס עדיין לא נבנתה: docker compose run --rm tiles
|
| הפורט 8080 תפוס | הגדירו HMAPS_PORT=8090 בקובץ .env ואז הריצו start.cmd
|
| שמות בעברית מוצגים הפוך במפה | בנו מחדש את האימג': docker compose build --no-cache api
|
- לחצו "כפתור השכבות" וודאו שהמתג "תצלום אווירי" דלוק
- בדקו את חיבור האינטרנט
- הריצו
download-satellite.cmd --testלאבחון:- אם
cdn.govmap.gov.ilמחזיר "דף חסימה" – הסינון חוסם. בקשו לפתוח - אם מופיעה שגיאת רשת – בעיית חיבור כללית
- אם
- אם govmap חסום לחלוטין – תוצג חלופת Sentinel-2 (רזולוציה נמוכה יותר, עד זום 14)
בדקו:
python -m hmaps update --check :: רק בדיקהאם ההורדה נקטעת – היא ממשיכה מאותה נקודה בהרצה הבאה (HTTP Range).
אם מוצגת שגיאת "מגבלת הקצב של GitHub" (60 בקשות בשעה) – ממתינים ומנסים שוב. ההודעה תציין מתי אפשר לנסות.
- ודאו שהשרת לא כבר רץ: הריצו
stop-windows.cmd, ואזstart-windows.cmd - בדקו שהפורט 8080 פנוי (ברירת מחדל)
- בפעם הראשונה – ודאו שהשלמת ההתקנה: תפריט ← עדכונים ← "עדכן הכול"
ראו שאלות נפוצות, או פתחו Issue ב-GitHub.