Repository navigation
Installation
ממגיעה בשתי דרכי התקנה: מתקין Windows (מומלץ) ו-Docker (חלופה).
- הורידו את HebrewMaps-Setup.exe
- הפעילו את הקובץ
- אם Windows מציג "Windows הגן על המחשב" – לחצו "מידע נוסף" ואז "הפעל בכל זאת" (ראו הסבר בפתרון תקלות)
- המתינו לסיום ההתקנה – נוצר קיצור דרך "מפות ישראל" בשולחן העבודה
בפתיחה הראשונה, עברו לתפריט ← עדכונים ← "עדכן הכול". התוכנה תוריד כ-2GB של נתונים: מפה, חיפוש, תחבורה ציבורית, טופוגרפיה וזמני תפילות. מכאן הכול עובד מהמחשב – גם בלי אינטרנט.
אם מתקינים מתיקיית הפרויקט (לא דרך המתקין):
- לחצו פעמיים על
setup-windows.cmdבתיקיית הפרויקט - לא צריך להתקין שום דבר מראש, ולא צריך הרשאות מנהל
- הדפדפן ייפתח אוטומטית בכתובת
http://localhost:8080
בהתחלה יוצגו נתוני הדגמה – המפה תשתדרג לבד כשהנתונים המלאים יהיו מוכנים.
| שלב | מה נעשה | זמן משוער |
|---|---|---|
| 1 | הורדת Python לתיקייה פרטית באמצעות uv (בלי התקנה במערכת) |
1–3 דקות |
| 2 | הורדת ספריית המפה והגופנים | דקה |
| 3 | הפעלת המפה + יצירת קיצור דרך בשולחן העבודה | מיידי |
| 4 | הורדת מפת ישראל מ-OpenStreetMap (כ-150MB) | 1–3 דקות |
| 5 | בניית המקומות, הרחובות, החיפוש והניווט | 15–30 דקות |
| 6 | בניית מפת הבסיס המלאה (Java נייד מורד אוטומטית) | 15–40 דקות |
אם שלב 6 נכשל – המפה ממשיכה לעבוד עם מפת בסיס פשוטה. אפשר לנסות שוב עם update-windows.cmd.
בסוף ההתקנה נבנות שכבות קווי גובה, הצללה ופרופיל גובה. זה אופציונלי:
- הורדה חד-פעמית של כ-530MB מ-Copernicus
- 10–20 דקות בנייה
- כ-200MB בדיסק
כדי לדלג: set HMAPS_SKIP_TERRAIN=1 לפני ההרצה.
אם השלב נכשל – כל השאר ממשיך לעבוד. אפשר לבנות מחדש עם build-terrain.cmd.
| קובץ | תפקיד |
|---|---|
start-windows.cmd |
הפעלת השרת ופתיחת הדפדפן / החלון |
stop-windows.cmd |
עצירת השרת |
update-online-windows.cmd |
עדכון הנתונים מהאינטרנט (מומלץ) |
update-windows.cmd |
בנייה מקומית מחדש של כל הנתונים (למתקדמים, שעה ויותר) |
update-transit-windows.cmd |
בנייה מקומית של לוחות זמנים בלבד (2–5 דקות) |
update-zmanim-windows.cmd |
משיכה מקומית של זמני תפילות (10–15 דקות) |
build-terrain.cmd |
בניית קווי גובה והצללה |
download-satellite.cmd |
הורדת תצלומי אוויר לכל הארץ |
המתקין כולל את hebrew-maps-desktop.exe – אפליקציית Tauri שפותחת את המפה בחלון משלה (ולא בדפדפן).
יתרונות:
- שורת כותרת מימין לשמאל, עם הסמל משמאל וכפתורי מזעור/הגדלה/סגירה מימין
- לשוניות כמו בדפדפן – כמה מבחלון אחד
- הלשוניות הפתוחות נפתחות מחדש בהפעלה הבאה
- סגירת החלון עוצרת את השרת; קריסה לא משאירה שרת ברקע
- קישורים חיצוניים (כמו ויקיפדיה) נפתחים בדפדפן הרגיל
קיצורי מקלדת בלשוניות:
| קיצור | פעולה |
|---|---|
Ctrl+T |
לשונית חדשה |
Ctrl+W |
סגירת לשונית |
Ctrl+Shift+T |
פתיחה מחדש של לשונית שנסגרה |
Ctrl+Tab / Ctrl+Shift+Tab
|
מעבר בין לשוניות |
Ctrl+1…9 |
מעבר ללשונית לפי מספר |
הערה: האפליקציה דורשת WebView2 של Microsoft. הוא מותקן מראש ב-Windows 11 וב-Windows 10 מעודכן. בלעדיו,
start-windows.cmdפותח את הדפדפן הרגיל.
כדי לכפדפן: set HMAPS_BROWSER=1 לפני ההפעלה.
בגרסת Docker הניווט רץ על OSRM (במקום המנוע הפנימי), ומפת הבסיס נבנית בקונטיינר.
- התקינו Docker Desktop והפעילו אותו. מומלץ להקצות לו 6GB זיכרון
- לחצו פעמיים על
setup.cmd - לאחר מכן השתמשו ב-
start.cmd,stop.cmdו-update-data.cmd
ב-Linux/macOS: ./setup.sh (או ./setup.sh --update).
אפשר להוריד את נתוני ישראל במחשב מחובר ולהעביר אותם בקובץ:
- הורידו את קובץ העדכון
HebrewMaps-Update.zipמה-Releases - העתיקו אותו למחשב היעד
- בתפריט ← עדכונים לחצו "עדכון מקובץ…"
או בשורת הפקודה:
python -m hmaps update --bundle E:\HebrewMaps-Update-2026-10-22.zip