גיאוגרפי שיתוף מידע ל פרוט יכולות מערכת אמצעות ב govmap

Transcription

‫פרוט יכולות לשיתוף מידע גיאוגרפי‬
‫באמצעות מערכת ‪govmap‬‬
‫תאריך עדכון – ‪42/6/402/‬‬
‫‪1‬‬
‫תוכן עיניינים‬
/.................................................................................................................. ‫הקדמה‬
.2
2......................................................................................................... URL ‫פונקציות‬
.4
5...................................................................................... ‫התמקדות לפי קואורדינאטות‬
4.2
6............................................................................................. ‫התמקדות לפי שאילתה‬
4.4
8.................................................................................................. ‫הוספת שכבות מידע‬
4./
9................................................................................ ‫הוספת בועית מידע על גבי המפה‬
4.2
22................................................................................................................. HTML
./
22..................................................................................................................... ‫כללי‬
/.2
2/............................................................................................. JavaScript ‫פונקציות‬
.2
2/..................................................................................................................... ‫כללי‬
2.2
22....................................................................................... ‫פרוט הפונקציות החיצוניות‬
4.2
22........................ GovMapGisApi_AddUserPoints - ‫ הוספת נקודות מאתר מארח למפה‬2.4.2
26................................................. GovMapGisApi_GeocodeString - ‫ גיאוקוד לכתובת‬2.4.4
28............................................ GovMapGisApi_GetSearchAccuracy - ‫ אימות כתובת‬2.4./
40..................................... GovMapGisApi_GeocodeAndZoom - ‫ איתור כתובת במפה‬2.4.2
44......... GovMapGisApi_ZoomToXYAndScaleLevel - ‫ התמקדות לקואורדינאטות וקנ"מ‬2.4.5
4/....................... GovMapGisApi_SwitchLayersVisibility - ‫ הדלקה וכיבוי שכבות במפה‬2.4.6
42........... GovMapGisApi_SearchByFieldAndValue - ‫ חיפוש והתמקדות לפי ערך מאפיין‬2.4.4
45....................................... GovMapGisApi_SetDefaultTool - ‫ חזור לכלי ברירת מחדל‬2.4.8
45...................................................... GovMapGisApi_GetXY - ‫ קבל קואורדינטות סמן‬2.4.9
46......................................................... GovMapGisApi_DrawRectangle - ‫ ציור מלבן‬2.4.20
44................................................................ GovMapGisApi_DrawCircle - ‫ ציור עיגול‬2.4.22
48.......................................................... GovMapGisApi_DrawPolygon - ‫ ציור מצולע‬2.4.24
49.................................................. GovMapGisApi_ZoomToDrawing - ‫ התמקד לציור‬2.4.2/
49......................................................... GovMapGisApi_ClearDrawing - ‫ מחיקת ציור‬2.4.22
49....................................... GovMapGisApi_SetActiveBackground - ‫ הגדר מפת רקע‬2.4.25
/0.....................GovMapGisApi_SearchByFieldAndValues - ‫ חיפוש על פי ערכי מאפיין‬2.4.26
- ‫ הרשמה לארוע שינוי תצוגת שכבות‬2.4.24
/2....................................................... GovMapGisApi_SubscribeToVisibleLayersChange
/2GovMapGisApi_SubscribeToMapExtenetChange - ‫ הרשמה לארוע שינוי תיחום מפה‬2.4.28
2
‫‪ .2‬הקדמה‬
‫פורטל המפות הממשלתי‪ ,GovMap ,‬מספק יכולות שיתוף מידע גיאוגרפי ושילוב רכיבי מפה בשלוש‬
‫דרכים עיקריות ובדירוג מורכבות עולה‪:‬‬
‫‪ – URL .2‬גלישה לפורטל המפות בתצורה התחלתית מוגדרת מראש (התמקדות לקואורדינאטות‪,‬‬
‫קביעת קנה מידה‪ ,‬סוג המפה‪ )...‬על ידי הוספת של פרמטרים לכתובת ה‪.URL-‬‬
‫‪ .4‬קוד ‪ – HTML‬הטמעת המפה על פי פרמטרים שמוגדרים ב‪ URL -‬באתר מארח אחר‪.‬‬
‫‪ ./‬פונקציות ‪ – JavaScript‬הפעלת פונקציונליות מתקדמת בחלונית המפה המוטמעת באמצעות‬
‫קוד ‪.HTML‬‬
‫‪3‬‬
‫‪ .4‬פונקציות ‪URL‬‬
‫השימוש ב‪ url -‬מאפשר למשתמש רגיל וללא כל פיתוח לשתף מפה אודות מקום עניין כלשהו‪ .‬למשל‪,‬‬
‫כתובת‪ ,‬סניף בנק‪ ,‬נק' מפגש וכדומה‪.‬‬
‫בכל רגע נתון‪ ,‬בעת הגלישה בפורטל המפות ‪ ,www.govmap.gov.il‬אפשר ללחוץ על כפתור 'שתף'‬
‫ולקבל קישור למפה המוצגת‪ .‬שילוב ה‪ url -‬באתר‪ ,‬מסמך או מייל יאפשר לפתוח את המערכת כשהמפה‬
‫משחזרת את מצבה לרגע השיתוף‪.‬‬
‫למשתמש מתקדם יותר קיימת האפשרות לבנות את ה‪ url -‬בהתאם לכללים המפורטים בהמשך‪.‬‬
‫‪4‬‬
‫‪ 1.2‬התמקדות לפי קואורדינאטות‬
‫במקרה זה נוסיף ל‪ URL-‬מידע על הקואורדינאטות (ברשת ישראל החדשה) אליהן תתמקד המפה‬
‫שתיפתח‪ ,‬באמצעות שימוש בפרמטר ‪ .C‬הפרמטר יכלול קואו' ‪( x‬מיקום מזרח‪-‬מערב) ו‪ -‬קואו' ‪( y‬מיקום‬
‫צפון‪-‬דרום) מופרדות ע"י |‪.‬‬
‫שם הפרמטר‬
‫‪C‬‬
‫ערכים‬
‫תיאור‬
‫קואורדינאטות ברשת ישראל החדשה או רשת ‪ :X‬בין ‪ 200,000‬ל‪/00,000 -‬‬
‫גיאוגרפית עולמית (‪ )WGS84‬אליהן תתמקד ‪ :Y‬בין ‪ /40,000‬ל‪820,000 -‬‬
‫מופרדים ע"י |‪.‬‬
‫המפה שתיפתח‪.‬‬
‫הפרמטר יכלול קואו' ‪( x‬מיקום מזרח‪-‬מערב) ו‪-‬‬
‫‪ :X‬בין ‪ /2‬ל‪/6 -‬‬
‫קואו' ‪( y‬מיקום צפון‪-‬דרום)‪.‬‬
‫‪ :Y‬בין ‪ 49.2‬ל‪//.2 -‬‬
‫אופציונאלי‪ ,‬ברירת מחדל מרכז מפה‪.‬‬
‫פרמטרים נוספים לשימוש בפונקציה זו‪:‬‬
‫‪Z‬‬
‫‪b‬‬
‫‪lay‬‬
‫‪ulay‬‬
‫תיאור‬
‫קביעת קנה המידה ורמת הפירוט של המפה‪.‬‬
‫אופציונאלי‪ ,‬ברירת מחדל ‪.0‬‬
‫הערה – יתכנו שינויים ברמות הפרוט כתלות‬
‫בסוג רקע נבחר בפרמטר ‪( b‬יותר או פחות מ‪-‬‬
‫‪ 22‬רמות)‪.‬‬
‫סוג מפת הרקע‬
‫הוספת שכבות נוספות של שרת המפות‬
‫הממשלתי‬
‫אופציונאלי‬
‫הוספת שכבות משתמש למפה‬
‫ערכים‬
‫בין ‪ 0‬ל‪-0( 20-‬קנה מידה קטן ופירוט‬
‫נמוך‪-20 ,‬קנה מידה גדול ופרוט‬
‫גבוה)‬
‫‪ -1‬ללא רקע‬
‫‪ 0‬מפה‬
‫‪ 2‬תצלום אוויר‬
‫‪ 4‬משולב‬
‫‪ /‬רחובות ומבנים ב ‪ 4.5‬ממדים‬
‫רשימה של ערכי ‪,layer_name‬‬
‫שמות השכבות כפי שהוגדרו בשרות‬
‫המפות (ראה נספח)‪ ,‬מופרדת ע"י |‬
‫רשימה של מזהי שכבה מופרדת ע"י‬
‫הסימן |‬
‫קוד‪:‬‬
‫‪http://www.govmap.gov.il/?c=179449|663927&z=8&b=0‬‬
‫‪5‬‬
‫‪ 1.1‬התמקדות לפי שאילתה‬
‫פונקציה זו מאפשרת להפעיל את מנוע החיפוש דרך ה‪ ,URL -‬באופן בו הכתובת כוללת ערכים‬
‫שמאפשרים לפתוח את המפה כשהיא ממוקדת לערכים הרצויים בדומה לשימוש בפורטל ב"חיפוש על פי‬
‫נושא" ‪ .‬במקרה זה עדיין ניתן לשלוט חלקית על תצורת המפה ולקבוע למשל את סוג מפת הרקע‪ ,‬בדומה‬
‫לפרמטרים שמשמשים בהתמקדות לפי קואורדינטות‪.‬‬
‫ארגומנטים לשימוש בפונקציה זו‪:‬‬
‫‪type‬‬
‫‪Param1‬‬
‫‪Param2‬‬
‫‪Param3‬‬
‫תיאור‬
‫קביעת הערך עליו יתבצע החיפוש‬
‫ערכים‬
‫‪ – 2‬כתובת (ישוב‪ ,‬רחוב‪ ,‬מס' בית)‬
‫‪ – 4‬גוש‪/‬חלקה (מס' גוש‪ ,‬מס'‬
‫חלקה)‬
‫‪ – /‬כבישים (מס' כביש)‬
‫‪ – 2‬צמתים (שם צומת)‬
‫‪ – 6‬שמורות טבע (שם שמורה‪/‬גן‬
‫לאומי)‬
‫‪ – 4‬שמות גיאוגרפים (שם)‬
‫‪ – 8‬מוסדות (שם)‬
‫ערך ראשון – חובה בכולם‬
‫ערך שני – אופציונאלי לרחוב או מס' חלקה‬
‫ערך שלישי ‪ -‬אופציונאלי למס' בית‬
‫‪C‬‬
‫‪Z‬‬
‫‪b‬‬
‫‪lay‬‬
‫‪ulay‬‬
‫ערכים‬
‫תיאור‬
‫‪ :X‬בין ‪ /2‬ל‪/6 -‬‬
‫‪ :Y‬בין ‪ 49.2‬ל‪//.2 -‬‬
‫גבוה)‬
‫‪ 22‬רמות)‪.‬‬
‫‪ 0‬מפה‬
‫הממשלתי‬
‫רשימה של מזהי שכבה מופרדת ע"י‬
‫הוספת שכבות משתמש למפה‬
‫הסימן |‬
‫‪6‬‬
‫הערות‪:‬‬
‫‪‬‬
‫המערכת תומכת בשדות מסוג מספר וטקסט באנגלית בלבד‪ .‬במידה ושם השדה או ערך השדה‬
‫מכילים תווים שאינם חוקיים ב‪( URL-‬למשל‪ ,‬תווים בעברית או רווחים) חובה לבצע ‪URL‬‬
‫‪ encoding‬של תווים אלו‪ .‬ניתן לבצע קידוד של כל המחרוזת (כולל שם השדה‪ ,‬התו המפריד ~‬
‫למשל‪:‬‬
‫קיים‪,‬‬
‫קידוד‬
‫כלי‬
‫כל‬
‫באמצעות‬
‫השדה)‬
‫וערך‬
‫‪ .http://meyerweb.com/eric/tools/dencoder‬הקידוד ישאיר את התווים החוקיים כמו שהם‬
‫ויקודד רק את התווים שאינם חוקיים‪.‬‬
‫דוגמאות‪:‬‬
‫התמקדות לפי כתובת "מודיעין‪-‬מכבים‪-‬רעות‪,‬אבני חושן‪"/0,‬‬
‫‪http://www.govmap.gov.il/?type=1&param1=%D7%9E%D7%95%D7%93%D7%‬‬
‫‪99%D7%A2%D7%99%D7%9F‬‬‫‪%D7%9E%D7%9B%D7%91%D7%99%D7%9D‬‬‫‪%D7%A8%D7%A2%D7%95%D7%AA&param2=%D7%90%D7%91%D7%A0%‬‬
‫‪D7%99%20%D7%97%D7%95%D7%A9%D7%9F&param3=30‬‬
‫התמקדות לפי גוש חלקה "‪”5842,2/‬‬
‫‪http://www.govmap.gov.il/?type=2&param1=5871&param2=13‬‬
‫התמקדות לפי מספר כביש "‪"22/‬‬
‫‪http://www.govmap.gov.il/?type=3&param1=443‬‬
‫התמקדות לפי שמורות טבע וגנים "אשכול"‬
‫‪http://www.govmap.gov.il/?type=6&param1=%D7%90%D7%A9%D7%9B%D7%‬‬
‫‪95%D7%9C‬‬
‫‪7‬‬
‫‪ 1.2‬הוספת שכבות מידע‬
‫אפשרות זו מספקת יכולת להוספה של שכבות מידע על גבי מפת הרקע‪.‬‬
‫במקרה זה נוסיף ל‪ URL-‬מידע על השכבות שאותן יש להוסיף על גבי המפה‪ ,‬באמצעות שימוש‬
‫בפרמטרים ‪ lay‬ו‪.ulay -‬‬
‫‪lay‬‬
‫‪ulay‬‬
‫תיאור‬
‫הממשלתי‪ .‬למשל‪ ,‬הוספת שכבת תחנות דלק‬
‫(‪.)t_delek‬‬
‫הוספת שכבות משתמש למפה‪ .‬למשל‪ ,‬הוספת‬
‫שכבת קניונים ומרכזי קניות שפורסמה ע"י אחד‬
‫ממשתמשי האתר‪.‬‬
‫ערכים‬
‫רשימה של מזהי שכבה מופרדים ע"י‬
‫הסימן |‬
‫‪C‬‬
‫‪Z‬‬
‫‪b‬‬
‫ערכים‬
‫תיאור‬
‫‪ :X‬בין ‪ /2‬ל‪/6 -‬‬
‫‪ :Y‬בין ‪ 49.2‬ל‪//.2 -‬‬
‫גבוה)‬
‫‪ 22‬רמות)‪.‬‬
‫‪ 0‬מפה‬
‫קוד‪:‬‬
‫‪http://www.govmap.gov.il/?c=179500|663900&z=4&b=1&lay=t_delek&ulay=1053‬‬
‫‪8‬‬
‫‪ 1.2‬הוספת בועית מידע על גבי המפה‬
‫שימוש בפרמטרים מתקדמים שמאפשרים לפתוח את המפה עם בועית מידע המציגה מידע נוסף‪.‬‬
‫לדוגמה הצגת בועית המציגה פרטי תחנת דלק מסוימת‪ .‬נקבע על ידי שימוש ברכיב ‪ bs‬והגדרת ‪4‬‬
‫פרמטרים שונים המופרדים על ידי הסימן |‪.‬‬
‫חשוב – יש לשמור תמיד על מבנה של ‪ 4‬פרמטרים המופרדים על ידי סימן | גם אם אין ערכים‪.‬‬
‫פרמטרים לשימוש בפונקציה זו‪ ,‬כל הפרמטרים חייבים להופיע‪ ,‬אולם רק אלו המסומנים (*) בכוכבית‬
‫חייבים להכיל ערכים‪:‬‬
‫*פורמט תוכן‬
‫הבועית‬
‫*סוג השכבה‬
‫*מזהה שכבה‬
‫תיאור‬
‫קביעה האם הבועית היא בועית סטנדרטית של‬
‫שכבת שרת המפות הממשלתי או בועית שנוצרה‬
‫על ידי המשתמש‬
‫קביעה האם השכבה היא שכבה סטנדרטית או‬
‫שכבת משתמש‬
‫מזהה השכבה בהתאם לסוג השכבה‬
‫ערך‬
‫להתמקדות‬
‫לפי איזה ערך בשכבה תהיה ההתמקדות‬
‫קואורדינאטת‬
‫‪X‬‬
‫קואורדינאטת‬
‫‪Y‬‬
‫מצב פתיחת‬
‫בועית‬
‫מיקום הבועית על ציר ה‪X-‬‬
‫ערכים‬
‫‪-25‬בועית סטנדרטית‬
‫‪-26‬בועית של שכבת משתמש‬
‫‪-2‬רגילה‬
‫‪-4‬משתמש‬
‫שכבה סטנדרטית – יש להזין את‬
‫הערך של ‪ layer_name‬בהתאם‬
‫לשמות השכבות כפי שהוגדרו‬
‫בשרות המפות (ראה נספח)‬
‫שכבת משתמש – מזהה מספרי של‬
‫השכבה‬
‫ערך של שדה מסוים – יש להכניס‬
‫את שם השדה ואת הערך ובינם‬
‫מפריד ~‪.‬‬
‫במקרה של שכבה סטנדרטית יש‬
‫להכניס את שם השדה כפי שהוא‬
‫מופיע בשכבה הגיאוגרפית שבבסיס‬
‫הנתונים הגיאוגרפי (‪feature class‬‬
‫ב‪ )SDE-‬ולא את הכינוי (‪)alias‬‬
‫שניתן במסמך המפה‪.‬‬
‫במקרה של שכבת משתמש יש‬
‫להזין את שם השדה כפי שהוגדר‬
‫ע"י המשתמש ‪.‬‬
‫מיקום הבועית על ציר ה‪Y-‬‬
‫קביעת מצב הבועית במפה‪.‬‬
‫ברירת המחדל היא בועית פתוחה‬
‫‪-0‬בועית סגורה‬
‫‪-2‬בועית פתוחה‬
‫בשכבות לא נקודתיות סמל הנעץ‬
‫יופיע גם אם נבחרה אפשרות של‬
‫בועית סגורה‪.‬‬
‫בשכבה נקודתית שהוגדרה לה‬
‫בועית סגורה – לא יופיע סמל הנעץ‬
‫ולא הבועית‪.‬‬
‫‪9‬‬
‫‪‬‬
‫‪‬‬
‫‪‬‬
‫אם מפ"י מעוניינים לאפשר התמקדות לפי ערך של שדה מוסתר‪ ,‬שערכיו אינם מופיעים בבועית‬
‫עצמה‪ ,‬יש להשאיר אותו דולק בשכבה ולתת לו ‪ alias‬של ‪.DONTSHOW‬‬
‫המערכת תומכת בשדות מסוג מספר וטקסט באנגלית בלבד‪ .‬במידה ושם השדה או ערך השדה‬
‫מכילים תווים שאינם חוקיים ב‪( URL-‬למשל‪ ,‬תווים בעברית או רווחים) חובה לבצע ‪URL‬‬
‫‪ encoding‬של תווים אלו‪ .‬ניתן לבצע קידוד של כל המחרוזת (כולל שם השדה‪ ,‬התו המפריד ~‬
‫וערך השדה) באמצעות כל כלי קידוד קיים‪ ,‬למשל‪:‬‬
‫‪ .http://meyerweb.com/eric/tools/dencoder‬הקידוד ישאיר את התווים החוקיים כמו שהם‬
‫ויקודד רק את התווים שאינם חוקיים‪.‬‬
‫יש לשים לב שהפונקציונאליות הנדרשת מחולקת לרכיבים אותם יש להוסיף באופן נפרד ל‪-‬‬
‫‪ .URL‬למשל‪ ,‬אם מבקשים להתמקד לפי ערך של שדה ומספקים את רכיב ה‪,bs-‬השכבה אינה‬
‫מתווספת אוטומטית ל‪ TOC-‬ולמפה‪ .‬לשם כך יש להשתמש ברכיב ה‪ lay -‬או ה‪.ulay-‬‬
‫דוגמה‪:‬‬
‫תחנת דלק הסיירים עם ערך של שדה "שם תחנה" (שדה ‪ NAME‬ב‪ )feature class-‬ללא‬
‫קואורדינטה ועם רקע של תצלום אוויר ‪:‬‬
‫‪http://www.govmap.gov.il?z=5&b=1&lay=t_delek&bs=15|1|t_delek|NAME~%D7%94‬‬
‫‪%D7%A1%D7%99%D7%99%D7%A8%D7%99%D7%9D|||1‬‬
‫‪10‬‬
‫‪HTML ./‬‬
‫‪ 2.2‬כללי‬
‫אתר המפות הממשלתי חושף יכולת שבאמצעותה ניתן לשלב חלונית מפה בדף מארח אחר‪ .‬על מנת‬
‫להוסיף מפה לדף מארח יש להוסיף לגוף הדף המארח ‪ iframe‬הכולל ‪ url‬להגדרת מצב המפה המבוקש‬
‫(מרכז מפה ראשוני‪ ,‬קנ"מ‪ ,‬סוג רקע‪ ,‬גודל וכו')‪.‬‬
‫דרך קלה להגדרת ה‪ iframe -‬יכולה להיות באמצעות שימוש בכפתור שתף ובחירת האפשרות קוד‬
‫‪ . HTML‬במידה ותצורה זו מספקת ניתן להעתיקה לדף המארח‪ ,‬במידה ולא ניתן לבחור באפשרות‬
‫לביצוע התאמה אישית ותצוגה מקדימה‪.‬‬
‫חשוב – בשונה מה‪ url -‬הרגיל לפתיחת האתר‪ ,‬במצב של שילוב חלונית מפה יש להקפיד על ‪ url‬שכולל‬
‫את ה‪ ./map.aspx -‬כמו כן‪ ,‬לאחר הגדרת פרמטרים למרכז מפה‪ ,‬רקע וקנ"מ יש להגדיר את עצם‬
‫השימוש במצב של חלונית מוטמעת וגודלה ‪.&mapMode=1&width=640&height=480 -‬‬
‫‪11‬‬
‫להלן פרוט הפרמטרים שיש להוסיף ב‪: url -‬‬
‫‪mapMode‬‬
‫‪width‬‬
‫‪height‬‬
‫תיאור‬
‫הגדרת העבודה כחלונית מפה‬
‫רוחב חלונית‬
‫גובה חלונית‬
‫ערכים‬
‫‪2‬‬
‫כתלות ברזולוציית מסך וכגודל ה‪-‬‬
‫‪iframe‬‬
‫כתלות ברזולוציית מסך וכגודל ה‪-‬‬
‫‪iframe‬‬
‫שאר הפרמטרים יכולים להילקח על פי ההסברים בסעיפים הקודמים‪.‬‬
‫לדוגמה‪:‬‬
‫' ‪<iframe id='ifrMap' frameborder='0' scrolling='no' marginheight='0‬‬
‫' ‪marginwidth='0' width='640' height='480‬‬
‫‪src='http://www.govmap.gov.il/map.aspx?c=200000|743000&z=7&b=0&mapMod‬‬
‫>'‪e=1&width=640&height=480‬‬
‫>‪</iframe‬‬
‫(*) יש להקפיד על זהות בין גודל ה‪ iframe -‬לגודל מפה מבוקש (למשל‪ 620 ,‬על ‪)280‬‬
‫‪12‬‬
‫‪ .2‬פונקציות ‪JavaScript‬‬
‫‪ 2.2‬כללי‬
‫על מנת להשתמש בפונקציונאליות מתקדמת לאחר הוספת המפה לדף מארח יש להוסיף לקוד של הדף‬
‫את קובץ ה‪ JavaScript -‬באופן הבא‪:‬‬
‫"‪<script language="javascript" type="text/javascript‬‬
‫>‪src="http://beta.govmap.gov.il/GovMapGisPostApi.js" /‬‬
‫(*) אם עובדים ב‪ ,https -‬צריך להוסיף את המפה וה ‪ js‬גם ב‪ https -‬ולא לעבוד באופן מעורב‬
‫כשאחד ב‪ http -‬והשני ב‪.https -‬‬
‫(*) ייתכן ובעתיד כתובת פורטל המפות להורדת ה‪ JavaScript -‬תשתנה‪ .‬כיום ה‪ API -‬בגרסת‬
‫בטא נמצא ב‪ beta.govmap.gov.il -‬ובהמשך הוא יעבור ל‪www.govmap.gov.il -‬‬
‫(*) אין להוריד את הקובץ לתיקייה מקומית וזאת על מנת לשמור על עבודה מול הגרסה‬
‫האחרונה העדכנית שנמצאת באתר‬
‫לאחר עליית הדף המארח הכולל את ה‪ IFRAME-‬אפשר להגדיר את פונקציית ‪ JavaScript‬של ה‪API -‬‬
‫בה מעוניינים להשתמש‪.‬‬
‫לדוגמא‪ ,‬ניתן להוסיף את ‪ GovMapGisPostApi.js‬ל >‪ <body‬בו מופיע ה >‪ <iframe‬של המפה ב‪:html‬‬
‫>‪<body‬‬
‫>‪<form‬‬
‫'‪<iframe id="ifrMap" frameborder='1' marginheight='0' marginwidth='0' width='1000‬‬
‫'‪height='600‬‬
‫‪src='http://beta.govmap.gov.il/Map.aspx?showBackBtn=1&showNavBtn=1&AllowDrag=1&heig‬‬
‫>‪ht=600&width=1000&c=200000|743000&z=5&b=0&mapMode=1'></iframe‬‬
‫'‪<script src='http://beta.govmap.gov.il/GIS/ClientServices/Release/GovMapGisPostApi.js‬‬
‫>‪type='text/javascript'></script‬‬
‫>‪<form/‬‬
‫>‪<body/‬‬
‫* השימוש בחלק מפונקציות ה‪ JavaScript-‬של המערכת אפשרי רק למשתמש רשום שקיבל ‪Token‬‬
‫שאותו מזינים בעת שימוש ב‪ .API -‬ה‪ Token -‬מונפק תוך שהוא משויך לדומיין שבו הדף יושב והוא לא‬
‫תקף לשימוש בדומיין אחר‪ .‬פונקציות שדורשות ‪ Token‬תכלולנה פרמטר קלט – ‪.UserKey/TokenID‬‬
‫‪13‬‬
‫* במידה ול‪ domain-‬של הדף המארח אין הרשאה להפעיל ‪( API‬בגלל שה‪ domain-‬שגוי‪ ,‬קוד משתמש‬
‫שגוי‪ ,‬ההרשאה לא ניתנה או הוסרה ע"י מפ"י) – תוצג הודעת שגיאה מתאימה והמפה תתעלם מהפעלת‬
‫הפונקציה‬
‫‪ 2.1‬פרוט הפונקציות החיצוניות‬
‫‪2.1.2‬‬
‫הוספת נקודות מאתר מארח למפה ‪GovMapGisApi_AddUserPoints -‬‬
‫פונקציה זו מאפשרת לייצר אינטראקציה בין האתר המארח למפה ולהציג עליה אוסף ישויות נקודתיות‬
‫במיקום‪ ,‬סימול ועם תוכן בועית רצוי כשהכל בשליטת הדף המארח‪.‬‬
‫‪GovMapGisApi_AddUserPoints(UserKey, XArray, YArray, SymbolUrlArray,‬‬
‫‪SymbolTypeArray, SymbolWidthArray, SymbolHeightArray,‬‬
‫‪SymbolAnchorOffsetXArray, SymbolAnchorOffsetYArray, BubbleContentUrlArray,‬‬
‫)‪TooltipTextArray, ClearExisting‬‬
‫פרמטרים לשימוש בפונקציה זו‪:‬‬
‫תיאור‬
‫‪UserKey‬‬
‫קוד משתמש ‪ API‬שהונפק ע"י מפ"י עבור ה‪ domain-‬של‬
‫האתר המארח‬
‫מערכים עבור כל נקודה שרוצים להוסיף למפה‬
‫‪XArray‬‬
‫קואורדינטת ‪ X‬ברשת ישראל חדשה (‪ :X - )Israel TM‬בין‬
‫‪ 200,000‬ל‪/00,000 -‬‬
‫‪YArray‬‬
‫קואורדינטת ‪ Y‬ברשת ישראל חדשה (‪ :Y - )Israel TM‬בין‬
‫‪ /40,000‬ל‪820,000 -‬‬
‫‪SymbolUrlArray‬‬
‫‪ URL‬של התמונה שתייצג את הנקודה על המפה‬
‫‪SymbolTypeArray‬‬
‫סוג התמונה‪ .‬אלה הפורמטים האפשריים‪:‬‬
‫‪gif/jpg/jpeg/png8/png24/png32‬‬
‫‪SymbolWidthArray‬‬
‫רוחב התמונה בפיקסלים‬
‫‪SymbolHeightArray‬‬
‫גובה התמונה בפיקסלים‬
‫‪SymbolAnchorOffsetXArray‬‬
‫היסט אופקי של נקודת העוגן בתוך התמונה‬
‫‪SymbolAnchorOffsetYArray‬‬
‫היסט אנכי של נקודת העוגן בתוך התמונה‬
‫‪BubbleContentUrlArray‬‬
‫‪ URL‬שתוכנו יוצג בבועית הנקודה‬
‫‪TooltipTextArray‬‬
‫‪ tooltip‬שיוצג במעבר העכבר על הנקודה‬
‫‪14‬‬
‫ שנוספו בקריאות‬,‫האם לנקות את הנקודות הקיימות במפה‬
.‫הקודמות לפונקציה‬
ClearExisting
true/false :‫ערכים אפשריים‬
:‫ דוגמא לקטע קוד‬- ‫הוספת נקודות מאתר מארח למפה‬
var XArray = new Array();
XArray[0] = X;
var YArray = new Array();
YArray[0] = Y;
var SymbolUrlArray = new Array();
SymbolUrlArray[0] = "http://files.softicons.com/download/web-icons/vista-map-markers-iconsby-icons-land/png/32x32/MapMarker_Marker_Outside_Azure.png";
var SymbolTypeArray = new Array();
SymbolTypeArray[0] = "png32";
var SymbolWidthArray = new Array();
SymbolWidthArray[0] = 25;
var SymbolHeightArray = new Array();
SymbolHeightArray[0] = 25;
var SymbolAnchorOffsetXArray = new Array();
SymbolAnchorOffsetXArray[0] = 1;
var SymbolAnchorOffsetYArray = new Array();
SymbolAnchorOffsetYArray[0] = 1;
var BubbleContentUrlArray = new Array();
BubbleContentUrlArray[0] = "http://files.softicons.com/download/web-icons/vista-mapmarkers-icons-byicons-land/png/32x32/MapMarker_Marker_Outside_Azure.png";
var TooltipTextArray = new Array();
TooltipTextArray[0] = "point";
var ClearExisting = new Array();
ClearExisting[0] = false;
GovMapGisApi_AddUserPoints(token, XArray, YArray, SymbolUrlArray, SymbolTypeArray,
SymbolWidthArray, SymbolHeightArray, SymbolAnchorOffsetXArray,
SymbolAnchorOffsetYArray, BubbleContentUrlArray, TooltipTextArray, ClearExisting);
15
‫‪2.1.1‬‬
‫גיאוקוד לכתובת ‪GovMapGisApi_GeocodeString -‬‬
‫פונקציה זו מפעילה את שירות החיפוש החופשי עם המחרוזת ‪ keyword‬ומחזיר תשובה לנתיב שב‪-‬‬
‫‪ .URL‬התשובה כוללת נתוני מיקום (‪ .)X, Y‬כמו כן‪ ,‬התשובה כוללת קוד מאפיין התוצאה‬
‫(‪ )ResultCode‬לפי הפירוט הבא‪:‬‬
‫‪-2‬תוצאה מדוייקת יחידה‪.‬‬
‫‪-4‬תוצאה חלקית (למשל‪ ,‬רחוב נמצא ומס' בית לא) או תוצאה דומה למחרוזת החיפוש‪ ,‬אך עם זאת‬
‫תוצאה יחידה‪.‬‬
‫‪-/‬מנגנון החיפוש החופשי מצא יותר מתוצאה אחת לפי מחרוזת החיפוש שסופקה או לא החזיר כלל‬
‫תוצאה (מסיבה כלשהי)‪ .‬במקרה זה לא מועבר המיקום בתשובה‪.‬‬
‫)‪GovMapGisApi_GeocodeString(UserKey, keyWord, CallbackFunctionName‬‬
‫תיאור‬
‫‪UserKey‬‬
‫מחרוזת הרשאת שימוש (‪)token‬‬
‫‪Keyword‬‬
‫מחרוזת עבור החיפוש החופשי‬
‫‪CallbackFunctionName‬‬
‫שם פונקציה לקבלת תשובה‪ .‬חתימת הפונקציה צריכה‬
‫להתאים למבנה התשובה‪.‬‬
‫לדוגמה עבור– )‪.function MyResult(X,Y, ResultCode‬‬
‫צריך להעביר ”‪ “MyResult‬כמחרוזת‪.‬‬
‫‪16‬‬
:‫גיאוקוד לכתובת – דוגמא לקטע קוד‬
GovMapGisApi_GeocodeString(token, address, "GeocodeStringResult");
function GeocodeStringResult(x, y, ResultCode) {
switch (ResultCode) {
case 1:
alert(x + " / " + y);
break;
case 2:
alert("• Matched 2 ");
break;
case 3:
alert("• Matched 3 "););
break;
}
}
17
‫‪2.1.2‬‬
‫אימות כתובת ‪GovMapGisApi_GetSearchAccuracy -‬‬
‫פונקציה זו מבצעת אימות לכתובת המוזנת‪ .‬ההתנהגות זהה ל‪, GovMapGisApi_GeocodeString-‬‬
‫אך התשובה כוללת בכל מקרה רק את קוד מאפיין התוצאה (‪ )ResultCode‬ולא מספקת קואו'‪ .‬כמו כן‪,‬‬
‫ממשק זה פתוח לכלל המשתמשים – לא מועברת ולא נבדקת מחרוזת ההרשאה (‪ .)token‬התשובה‬
‫כוללת קוד מאפיין התוצאה (‪ )ResultCode‬לפי הפירוט הבא‪:‬‬
‫‪ :2‬תוצאה מדוייקת יחידה‪.‬‬
‫‪ : 4‬תוצאה חלקית (למשל‪ ,‬רחוב נמצא ומס' בית לא) או תוצאה דומה למחרוזת החיפוש‪ ,‬אך עם זאת‬
‫‪ :/‬מנגנון החיפוש החופשי מצא יותר מתוצאה אחת לפי מחרוזת החיפוש שסופקה או לא החזיר כלל‬
‫תוצאה (מסיבה כלשהי)‪.‬‬
‫)‪GovMapGisApi_GetSearchAccuracy(keyWord, CallbackFunctionName‬‬
‫תיאור‬
‫‪Keyword‬‬
‫לדוגמה עבור– )‪.function MyResult(ResultCode‬‬
‫‪18‬‬
:‫אימות כתובת – דוגמא לקטע קוד‬
GovMapGisApi_GetSearchAccuracy(address, "GetSearchAccuracyResult");
function GetSearchAccuracyResult(ResultCode) {
case 1:
alert("• Matched 1");
break;
case 2:
break;
case 3:
break;
}
{
19
‫‪2.1.2‬‬
‫איתור כתובת במפה ‪GovMapGisApi_GeocodeAndZoom -‬‬
‫פונקציה זו כוללת התנהגות זהה ל‪ GovMapGisApi_GetSearchAccuracy-‬עם התמקדות במפה‬
‫לתוצאה‪ .‬הפונקציה מבצעת אימות לכתובת המוזנת מחזירה רמת דיוק ובמקרה של איתור חלקי או מלא‬
‫מבצעת התמקדות למיקום המתאים ברכיב המפה‪ .‬התשובה כוללת בכל מקרה רק את קוד מאפיין‬
‫התוצאה (‪ )ResultCode‬ולא מספקת קואו'‪ .‬כמו כן‪ ,‬ממשק זה פתוח לכלל המשתמשים – לא מועברת‬
‫ולא נבדקת מחרוזת ההרשאה (‪.)token‬‬
‫התשובה כוללת קוד מאפיין התוצאה (‪ )ResultCode‬לפי הפירוט הבא‪:‬‬
‫‪ :2‬תוצאה מדוייקת יחידה‪.‬‬
‫‪ : 4‬תוצאה חלקית (למשל‪ ,‬רחוב נמצא ומס' בית לא) או תוצאה דומה למחרוזת החיפוש‪ ,‬אך עם זאת‬
‫‪ :/‬מנגנון החיפוש החופשי מצא יותר מתוצאה אחת לפי מחרוזת החיפוש שסופקה או לא החזיר כלל‬
‫תוצאה (מסיבה כלשהי)‪.‬‬
‫במקרה של ‪ ResultCode=3‬לא מתבצעת התמקדות במפה‪.‬‬
‫)‪GovMapGisApi_GeocodeAndZoom(keyWord, CallbackFunctionName, showBubble‬‬
‫תיאור‬
‫‪Keyword‬‬
‫לדוגמה עבור– )‪.function MyResult(ResultCode‬‬
‫‪showBubble‬‬
‫האם להציג (‪ )true‬או לא להציג (‪ )false‬את הבועית של‬
‫הישות אליה מתמקדים‬
‫‪20‬‬
:‫איתור כתובת במפה – דוגמא לקטע קוד‬
GovMapGisApi_GeocodeAndZoom(address, "GeocodeAndZoomResult", false);
function GeocodeAndZoomResult(ResultCode) {
case 1:
alert("• Matched 1");
break;
case 2:
break;
case 3:
break;
}
}
21
‫‪2.1.4‬‬
‫התמקדות לקואורדינאטות וקנ"מ ‪GovMapGisApi_ZoomToXYAndScaleLevel -‬‬
‫פונקציה זו מבצעת התמקדות למיקום וקנ"מ על פי הפרמטרים המוזנים‪.‬‬
‫)‪GovMapGisApi_ZoomToXYAndScaleLevel(X, Y, Level‬‬
‫תיאור‬
‫‪X‬‬
‫קואורדינטת המיקום מזרח‪-‬מערב‬
‫‪Y‬‬
‫קואורדינטת המיקום צפון‪-‬דרום‬
‫‪Level‬‬
‫רמת התמקדות (זהה לפרמטר ‪ z‬ב‪ URL-‬של הפורטל‬
‫המלא)‬
‫בין ‪ 0‬ל‪-0( 20-‬קנה מידה קטן ופירוט נמוך‪-20 ,‬קנה מידה‬
‫גדול ופרוט גבוה)‬
‫הערה‪ :‬הערכים תלויים ברקע המפה כך שמספר הרמות‬
‫יכול להשתנות‪.‬‬
‫התמקדות לקואורדינטות וקנ"מ – דוגמא לקטע קוד‪:‬‬
‫;‪var x = 200000‬‬
‫;‪var y = 743000‬‬
‫;‪var Level = 5‬‬
‫;)‪GovMapGisApi_ZoomToXYAndScaleLevel(x, y, Level‬‬
‫‪22‬‬
‫הדלקה וכיבוי שכבות במפה ‪GovMapGisApi_SwitchLayersVisibility -‬‬
‫‪2.1.4‬‬
‫פונקציה זו מבצעת הדלקה וכיבוי של שכבות במפה‪ .‬אם אותה שכבה מופיעה גם במערך ההדלקה וגם‬
‫במערך הכיבוי‪ ,‬הממשק יתעלם מהשכבה שמופיעה בכיבוי והשכבה תודלק‪.‬‬
‫לדוגמה‪:‬‬
‫נניח שרוצים להדליק ‪ /‬שכבות ולכבות ‪ .4‬לשם כך יש להפעיל את הפונקצייה‬
‫‪ GovMapGisApi_SwitchLayersVisibility‬באופן הבא‪:‬‬
‫‪GovMapGisApi_SwitchLayersVisibility(['PetroleumRights', 'Quarries',‬‬
‫;)]'‪'MahazevotNetushot'], ['OilGasWells', 't_delek‬‬
‫בעצם‪ ,‬הפונקציה מקבלת ‪ 4‬מערכים של שמות שכבות (=כינויי השכבות באנגלית‪ ,‬לפי הגדרות מפ"י)‪:‬‬
‫במקום הראשון ‪ -‬מערך שכבות להדלקה‪ ,‬במקום השני ‪ -‬מערך שכבות לכיבוי‪.‬‬
‫ניתן‪ ,‬כמובן‪ ,‬לבצע מס' לא מוגבל של קריאות עוקבות ולהדליק ולכבות שכבות שונות בהמשך העבודה עם‬
‫המפה‪.‬‬
‫‪GovMapGisApi_SwitchLayersVisibility(arrSwitchOnLayers, arrSwitchOffLayers,‬‬
‫)‪UserKey‬‬
‫תיאור‬
‫‪arrSwitchOnLayers‬‬
‫מערך שמות השכבות להדלקה‪ ,layer_name ,‬כפי‬
‫שהוגדרו בשרות המפות (ראה נספח)‬
‫‪arrSwitchOffLayers‬‬
‫מערך שמות השכבות לכיבוי‪ ,layer_name ,‬כפי שהוגדרו‬
‫בשרות המפות (ראה נספח)‬
‫‪UserKey‬‬
‫מחרוזת הרשאת שימוש (‪.)token‬‬
‫האתר המארח‪.‬‬
‫‪ UserKey‬הוא פרמטר אופציונאלי שלא חייבים לספק‪ .‬הוא‬
‫משמש למקרים בהם מבקשים להדליק שכבות שלא כלולות‬
‫באתר הראשי (‪ )GovMap‬וממוקמות ב‪map service -‬‬
‫ייעודי אחר ובתאום מראש מול מפ"י‪.‬‬
‫הדלקה וכיבוי שכבות במפה – דוגמא לקטע קוד‪:‬‬
‫;)][ ‪GovMapGisApi_SwitchLayersVisibility(['PARCEL_ALL'],‬‬
‫‪23‬‬
‫‪2.1.4‬‬
‫חיפוש והתמקדות לפי ערך מאפיין ‪GovMapGisApi_SearchByFieldAndValue -‬‬
‫פונקציה זו מבצעת התמקדות לישות שנדרשה בדומה לפונקציונליות ‪ URL‬זהה בפורטל המלא‪.‬‬
‫* לתשומת ליבכם יש גם ‪ GovMapGisApi_SearchByFieldAndValues‬למקרה בו יש מספר ערכים‬
‫לחיפוש‬
‫‪GovMapGisApi_SearchByFieldAndValue(layerID, fieldName, fieldValue,‬‬
‫)‪showBubble‬‬
‫תיאור‬
‫‪layerID‬‬
‫מזהה שכבה‬
‫‪Fieldname‬‬
‫שם השדה (השם ב‪ ,feature class-‬לא ה‪)alias-‬‬
‫‪fieldValue‬‬
‫ערך השדה‬
‫‪showBubble‬‬
‫האם להציג (‪ )true‬או לא להציג (‪ )false‬את הבועית של‬
‫הישות אליה מתמקדים‬
‫חיפוש והתמקדות לפי ערך מאפיין – דוגמא לקטע קוד‪:‬‬
‫;)‪", true‬הסיירים" ‪GovMapGisApi_SearchByFieldAndValue("t_delek", "NAME",‬‬
‫‪24‬‬
‫‪2.1.4‬‬
‫חזור לכלי ברירת מחדל ‪GovMapGisApi_SetDefaultTool -‬‬
‫פונקציה זו מחזירה את המפה למצב של כלי נבחר – הזזת מפה (‪.)Pan‬‬
‫)(‪GovMapGisApi_SetDefaultTool‬‬
‫תיאור‬
‫ללא פרמטרים‬
‫החזרת המפה למצב של כלי נבחר – הזזת מפה (‪)Pan‬‬
‫‪2.1.4‬‬
‫קבל קואורדינטות סמן ‪GovMapGisApi_GetXY -‬‬
‫פונקציה זו מחזירה קואורדינטות מיקום נוכחי של הסמן במפה‪.‬‬
‫)‪GovMapGisApi_GetXY(UserKey, CallbackFunctionName‬‬
‫(*) כדי לצאת ממצב קליטת נקודות יש לקרוא לפונקציה ‪GovMapGisApi_SetDefaultTool‬‬
‫תיאור‬
‫‪UserKey‬‬
‫לדוגמה עבור– )‪.function MyResult(X,Y‬‬
‫קבל קואורדינטות סמן – דוגמא לקטע קוד‪:‬‬
‫;)"‪GovMapGisApi_GetXY(token, "GetXYResult‬‬
‫{ )‪function GetXYResult(x, y‬‬
‫;)‪alert("X: "+ x + " / Y: " + y‬‬
‫;)(‪GovMapGisApi_SetDefaultTool‬‬
‫}‬
‫‪25‬‬
‫‪ 2.1.24‬ציור מלבן ‪GovMapGisApi_DrawRectangle -‬‬
‫פונקציה זו מכניסה את המפה למצב של ציור מלבן ומחזירה את פינות הקואו' עם סיום הציור לאחר‬
‫שחרור הכפתור (לחיצה‪ ,‬גרירה ושחרור לסיום ציור)‪ .‬בעת הכניסה למצב זה משתנה אייקון העכבר ל‪+ -‬‬
‫(צלב)‪.‬‬
‫‪GovMapGisApi_DrawRectangle(UserKey, CallbackFunctionName‬‬
‫)‪,ClearCurrentDrawing ,ContinousMode‬‬
‫תיאור‬
‫‪UserKey‬‬
‫לדוגמה עבור ‪MyResult(Xmin,Ymin,Xmax,Ymax) -‬‬
‫‪.function‬‬
‫‪bClearCurrentDrawing‬‬
‫דגל בולאני (‪ )true/false‬לטובת מחיקת כלל הגרפיקות‬
‫שמצוירות על המפה לפני תחילת ציור המלבן‬
‫‪bContinousMode‬‬
‫דגל בולאני (‪ )true/false‬להגדרת מצב המשך לאחר סיום‬
‫ציור – האם להשאר במצב ציור או לחזור לפקד הזזה‬
‫(‪.)Pan‬‬
‫ציור מלבן – דוגמא לקטע קוד‪:‬‬
‫; )‪GovMapGisApi_DrawRectangle(token, "DrawRectangleResult" ,true ,false‬‬
‫{ )‪function DrawRectangleResult(Xmin,Ymin,Xmax,Ymax‬‬
‫;)‪alert("Xmin: "+ Xmin + " / Ymin: " + Ymin + " / Xmax:" + Xmax + " / Ymax:" + Ymax‬‬
‫}‬
‫‪26‬‬
‫‪ 2.1.22‬ציור עיגול ‪GovMapGisApi_DrawCircle -‬‬
‫פונקציה זו מכניסה את המפה למצב של ציור עיגול ומחזירה את קואו' המרכז ואת הרדיוס עם סיום הציור‬
‫לאחר שחרור הכפתור (לחיצה‪ ,‬גרירה ושחרור לסיום ציור)‪ .‬בעת הכניסה למצב זה משתנה אייקון העכבר‬
‫ל‪( + -‬צלב)‪.‬‬
‫‪GovMapGisApi_DrawCircle(UserKey, CallbackFunctionName ,ClearCurrentDrawing‬‬
‫)‪,ContinousMode‬‬
‫תיאור‬
‫‪UserKey‬‬
‫לדוגמה עבור ‪.function MyResult(X,Y,R) -‬‬
‫(‪.)Pan‬‬
‫ציור עיגול – דוגמא לקטע קוד‪:‬‬
‫)‪GovMapGisApi_DrawCircle(token, "DrawCircleResult" ,true, false‬‬
‫{ )‪function DrawCircleResult(X,Y,R‬‬
‫;)‪alert("X: "+ X + " / Y: " + Y + " / R:" + R‬‬
‫}‬
‫‪27‬‬
‫‪ 2.1.21‬ציור מצולע ‪GovMapGisApi_DrawPolygon -‬‬
‫פונקציה זו מכניסה את המפה למצב של ציור מצולע ומחזירה את קואו' המצולע עם סיום הציור לאחר‬
‫לחיצה כפולה בכפתור עכבר‪( Duble Click ,‬לחיצה לכל קודקוד ו‪ Duble Click -‬לסיום ציור)‪ .‬בעת‬
‫הכניסה למצב זה משתנה אייקון העכבר ל‪( + -‬צלב)‪.‬‬
‫קואו' המצולע מוחזרות כמחרוזת ‪ WKT‬של רצף ערכי הקואו' ‪.X1,Y1;X2,Y2;….;Xn,Yn‬‬
‫‪GovMapGisApi_DrawPolygon(UserKey, CallbackFunctionName‬‬
‫)‪,ClearCurrentDrawing ,ContinousMode‬‬
‫תיאור‬
‫‪UserKey‬‬
‫לדוגמה עבור‪function MyResult(WKT) -‬‬
‫(‪.)Pan‬‬
‫ציור מצולע – דוגמא לקטע קוד‪:‬‬
‫;)‪GovMapGisApi_DrawPolygon(token, "DrawPolygonResult" ,true, false‬‬
‫)‪function DrawPolygonResult(WKT‬‬
‫{‬
‫;)‪alert(WKT‬‬
‫}‬
‫‪28‬‬
‫‪ 2.1.22‬התמקד לציור ‪GovMapGisApi_ZoomToDrawing -‬‬
‫פונקציה זו מבצעת התמקדות במפה לתיחום הציור שבוצע עליה (מלבן‪ ,‬עיגול‪ ,‬מצולע)‪.‬‬
‫)(‪GovMapGisApi_ZoomToDrawing‬‬
‫תיאור‬
‫התמקדות במפה לתיחום הציור שבוצע‬
‫‪ 2.1.22‬מחיקת ציור ‪GovMapGisApi_ClearDrawing -‬‬
‫פונקציה זו מוחקת את כל הישויות הגרפיות שצוירו על המפה‪.‬‬
‫)(‪GovMapGisApi_ClearDrawing‬‬
‫תיאור‬
‫מחיקת התיחום הקיים על רכיב המפה‬
‫‪ 2.1.24‬הגדר מפת רקע ‪GovMapGisApi_SetActiveBackground -‬‬
‫פונקציה זו משנה את מפת הרקע של רכיב המפה על פי קוד בדומה לאפשרויות המסופקות באתר‬
‫הראשי‪.‬‬
‫)‪GovMapGisApi_SetActiveBackground(BGType‬‬
‫תיאור‬
‫‪BGType‬‬
‫‪ 0‬מפה‬
‫‪29‬‬
‫‪ 2.1.24‬חיפוש על פי ערכי מאפיין ‪GovMapGisApi_SearchByFieldAndValues -‬‬
‫פונקציה זו מבצעת חיפוש והתמקדות לישויות המתאימות לערכים המוזנים תוך הדלקת השכבה‬
‫ואפשרות להבלטת הסימון בצבע‪.‬‬
‫‪GovMapGisApi_SearchByFieldAndValues(layerID, fieldName, fieldValues,‬‬
‫)‪bHighlight‬‬
‫תיאור‬
‫‪layerID‬‬
‫‪fieldname‬‬
‫שם השדה‬
‫‪fieldValues‬‬
‫מערך הכולל את ערכי השדה‬
‫‪bHighlight‬‬
‫דגל בולאני (‪ )true/false‬להבלטת הישויות שאותרו‬
‫באמצעות סימון צבע‬
‫חיפוש עפ"י ערכי מאפיין – דוגמא לקטע קוד‪:‬‬
‫;)(‪var values = new Array‬‬
‫;‪values[0] = 10120‬‬
‫;)‪GovMapGisApi_SearchByFieldAndValues("PARCEL_ALL", "GUSH_NUM", values, true‬‬
‫‪30‬‬
‫‪ 2.1.24‬הרשמה לארוע שינוי תצוגת שכבות ‪-‬‬
‫‪GovMapGisApi_SubscribeToVisibleLayersChange‬‬
‫פונקציה זו משמשת לת שאול רכיב המפה וקבלת רשימת השכבות שדלוקות בו לטובת ניהול ה‪( TOC-‬רשימת‬
‫שכבות המידע)‪.‬‬
‫(*) השימוש בפונקציה מחייב רישום (‪ )subsciption‬ל‪ Event -‬שמופעל בכל פעם שיש שינוי במצב שיכבה כלשהי‬
‫ע"ג ה‪.API-‬‬
‫)‪GovMapGisApi_SubscribeToVisibleLayersChange(CallbackFunctionName‬‬
‫תיאור‬
‫לדוגמה עבור – )‪.function MyResult(MapLayers‬‬
‫‪ 2.1.24‬הרשמה לארוע שינוי תיחום מפה ‪-‬‬
‫‪GovMapGisApi_SubscribeToMapExtenetChange‬‬
‫פונקציה זו משמשת לתשאול רכיב המפה וקבלת חיווי על כל שינוי תיחום וקואורדינטות התיחום החדש‪.‬‬
‫הפונקציה יכולה לשמש במקרים בהם מעוניינים להציג מידע רלוונטי לתיחום באתר המארח‪.‬‬
‫(*) השימוש בפונקציה הנ"ל מחייב ביצוע רישום (‪ )subsciption‬ל‪ Event-‬שמופעל בכל פעם שיש שינוי בתיחום‬
‫המפה‪.‬‬
‫)‪GovMapGisApi_ SubscribeToMapExtenetChange (CallbackFunctionName‬‬
‫תיאור‬
‫לדוגמה עבור ‪function -‬‬
‫)‪.MyResult(Xmin,Ymin,Xmax,Ymax‬‬
‫‪31‬‬
‫נספח ‪ -‬פרוט שמות השכבות בשרת המפות‬
‫להלן פרוט לדוגמה של שמות השכבות‪ .‬יש לוודא שאין שינוי בשם זה או אחר ומומלץ להסתמך על השם‬
‫שמוגדר ב‪ url -‬בפרמטרים ‪ lay‬ו‪ ulay -‬בעת שימוש בשתף לאחר הדלקה ידנית של השכבה המבוקשת‪.‬‬
‫‪milestones‬‬
‫‪Sex_Age_Religion‬‬
‫‪ilezor‬‬
‫‪POLICE_Yehida_Region‬‬
‫‪f_natural‬‬
‫‪yeshuvim‬‬
‫‪statistic_areas‬‬
‫‪atractions‬‬
‫‪cell_active‬‬
‫‪atikot_sites_itm‬‬
‫‪tayarut‬‬
‫‪Civil_Labour_Force‬‬
‫‪Ages65_Plus‬‬
‫‪Disabilities‬‬
‫‪Emergancy_Hospitals‬‬
‫‪hotels‬‬
‫‪LOCALITY_VAAD0410‬‬
‫‪LOCALITY_210410‬‬
‫‪SUB_GUSH_ALL‬‬
‫‪index_taba_gzr_m‬‬
‫‪ganim_leumim‬‬
‫‪Housing‬‬
‫‪HOF_NAKI_update‬‬
‫‪Education‬‬
‫‪mitchmim_mshbsh‬‬
‫‪PetroleumRights‬‬
‫‪Soil_types‬‬
‫‪scenery_units‬‬
‫‪PARCEL_ALL‬‬
‫‪parcel_all‬‬
‫‪ilPublicSites_June05‬‬
‫‪d170308_teva‬‬
‫‪Mean_Temperature_Anual‬‬
‫‪ilforest‬‬
‫‪winery‬‬
‫‪LOCALITY‬‬
‫תאור‬
‫אבני ק"מ‬
‫אוכלוסייה‪-‬מפקד ‪4008‬‬
‫אזורי קרן קיימת לישראל‬
‫אזורי תחנות משטרה‬
‫אזורים טבעיים‬
‫אזורים מוניציפליים‬
‫אזורים סטטיסטיים‬
‫אטרקציות‬
‫אנטנות סלולריות‬
‫אתרי עתיקות‬
‫אתרי תיירות בתכנון‬
‫בכוח העבודה האזרחי‪-‬מפקד‬
‫‪4008‬‬
‫בני ‪ 65‬ומעלה‪-‬מפקד ‪4008‬‬
‫בעלי מוגבלויות‪-‬מפקד ‪4008‬‬
‫בתי חולים‬
‫בתי מלון‬
‫גבולות וועדי ישובים‬
‫גבולות ישובים‬
‫גושים‬
‫גזר ‪ -‬אינדקס תב"ע‬
‫גנים לאומיים‬
‫דיור‪-‬מפקד ‪4008‬‬
‫הנקיון בחוף‬
‫השכלה‪-‬מפקד ‪4008‬‬
‫התחדשות עירונית‬
‫זכויות נפט‬
‫חבורות קרקע‬
‫חטיבות נוף‬
‫חלקות‬
‫חלקות‬
‫חניונים ואתרים של קק"ל‬
‫טבע עירוני‬
‫טמפרטורה שנתית ממוצעת‬
‫יער נטע אדם‬
‫יקבים‬
‫ישובים‬
‫‪32‬‬
‫תאור‬
‫לשכות משרד הבריאות‬
‫‪Chambers‬‬
‫‪ PURIFIED_DRAINAGE_PONDS‬מאגרי קולחין‬
‫מגרשי תב"ע ‪ -‬ממ"י‬
‫‪retzefMigrashim‬‬
‫מגרשים ‪ -‬משרד הבינוי והשיכון‬
‫‪migrashim_msbs‬‬
‫מוסדות גריאטריים‬
‫‪MOSDOT_griatric‬‬
‫מועצות אזוריות‬
‫‪MUNICIPALY‬‬
‫מועצות דתיות‬
‫‪Moatzot‬‬
‫מוצא‪-‬מפקד ‪4008‬‬
‫‪Origin‬‬
‫מוצרים בני קיימא‪-‬מפקד ‪4008‬‬
‫‪Durable_Goods‬‬
‫מחוזות המשרד להגנת הסביבה‬
‫‪Administration_Areas_new‬‬
‫מחוזות מגן דוד אדום‬
‫‪Mada_districs‬‬
‫מחוזות מנהל מקרקעי ישראל‬
‫‪MMI_districts‬‬
‫מחוזות משטרה‬
‫‪POLICE_Mahoz_Region‬‬
‫מחוזות משרד הבינוי והשיכון‬
‫‪moch_districts‬‬
‫מחוזות משרד הבריאות‬
‫‪health_districts‬‬
‫מחוזות משרד החקלאות‬
‫‪agriculture_districts‬‬
‫מחוזות משרד הפנים‬
‫‪REGION‬‬
‫מחוזות רשות חירום לאומית‬
‫‪NEMA‬‬
‫מחצבות‬
‫‪Quarries‬‬
‫מחצבות נטושות‬
‫‪MahazevotNetushot‬‬
‫מידע ירוק‬
‫‪d180308_meida‬‬
‫מכרזי ממ"י מגרשים‬
‫‪Michrazim_Haluka‬‬
‫מכרזי מנהל מקרקעי ישראל‬
‫‪Michrazim‬‬
‫מסלולי נסיעה ‪ -‬תחבורה‬
‫‪bus_lines‬‬
‫מסלולי נסיעה תחבורה ציבורית‬
‫‪trans_lines‬‬
‫מעמד בעבודה‪-‬מפקד ‪4008‬‬
‫‪Employee_Jobs‬‬
‫מפקדות מחוזות משטרה‬
‫‪POLICE_Mahoz_Location‬‬
‫מפקדות מרחבי משטרה‬
‫‪POLICE_Merhav_Location‬‬
‫מפת תקן בניה לרעידות אדמה‬
‫‪t413‬‬
‫‪22/‬‬
‫מפתח מפות ‪200,000‬‬
‫‪SHEET100‬‬
‫מפתח מפות ‪45,000‬‬
‫‪SHEET25‬‬
‫מפתח מפות ‪50,000‬‬
‫‪SHEET50‬‬
‫מקוואות‬
‫‪Mikve‬‬
‫מרחבי קרן קיימת לישראל‬
‫‪ilmerhav‬‬
‫מרחבים של משטרה‬
‫‪POLICE_Merhav_Region‬‬
‫מרכזי החזרת פיקדונות‬
‫‪moe_pikadon‬‬
‫לבקבוקים‬
‫משלחי יד‪-‬מפקד ‪4008‬‬
‫‪Occupations‬‬
‫משקי בית‪-‬מפקד ‪4008‬‬
‫‪Households‬‬
‫משרדי קרן קיימת לישראל‬
‫‪ilkkloff‬‬
‫‪33‬‬
‫‪sport‬‬
‫‪trans_poi‬‬
‫‪Marrige_Birth‬‬
‫‪elect_regions‬‬
‫‪health_counties‬‬
‫‪COUNTY‬‬
‫‪ilkklfiretr‬‬
‫‪btl‬‬
‫‪banks‬‬
‫‪Soil_survey‬‬
‫‪ilstnd‬‬
‫‪yeshuvim_b_pnim‬‬
‫‪Industries‬‬
‫‪atudot_mmi‬‬
‫‪RECTIFY_P‬‬
‫‪zimmer‬‬
‫‪density1967‬‬
‫‪GR_LIN_P‬‬
‫‪BL_LIN_P‬‬
‫‪Purified_drainage_pipes‬‬
‫‪contour‬‬
‫‪OilGasWells‬‬
‫‪esip_0304‬‬
‫‪open_area_sens‬‬
‫‪fire_admin‬‬
‫‪drainage_authorities‬‬
‫‪activefaults‬‬
‫‪fire_areas‬‬
‫‪suburb_rehabilitation‬‬
‫‪Neighborhood‬‬
‫‪shmurot_teva_ganim‬‬
‫‪Gazetteer‬‬
‫‪WorkingHours_Transport‬‬
‫‪retzefGvulot‬‬
‫‪taba_msbs_itm‬‬
‫‪ilregion‬‬
‫‪GPS_stations‬‬
‫‪Stops‬‬
‫תאור‬
‫מתקני ספורט‬
‫מתקני רישוי נהיגה‬
‫נישואין וילודה‪-‬מפקד ‪4008‬‬
‫נפות חברת חשמל‬
‫נפות משרד הבריאות‬
‫נפות משרד הפנים‬
‫נקודות תצפית לגילוי שרפות‬
‫סניפי ביטוח לאומי‪ -‬חלקי‬
‫סניפי בנקים‪ -‬חלקי‬
‫סקר קרקעות‬
‫עומדי יער‬
‫עיר ללא אלימות‬
‫ענפי תעסוקה‪-‬מפקד ‪4008‬‬
‫עתודות קרקע ‪ -‬ממ"י‬
‫צווי הכרזה מסילות ברזל‬
‫צימרים‬
‫צפיפות אוכלוסיה ‪2964‬‬
‫קו אפור רצועת מסילה‬
‫קו כחול תוכניות רכבת‬
‫קווי קולחין ראשיים‬
‫קוי גובה‬
‫קידוחי נפט וגז‬
‫רגישות חופי הים לזיהומי שמן‬
‫רגישות שטחים פתוחים‬
‫רשויות כבאות והצלה‬
‫רשויות ניקוז‬
‫שברים פעילים‬
‫שטחי אימונים‬
‫שיקום שכונות‪-‬משרד הבינוי‬
‫והשיכון‬
‫שכונות‬
‫שמורות טבע‬
‫שמות גאוגרפים‬
‫שעות עבודה ותחבורה‪-‬מפקד‬
‫‪4008‬‬
‫תב"ע ‪ -‬מנהל מקרקעי ישראל‬
‫תב"ע ‪ -‬משרד הבינוי והשיכון‬
‫תחומי יער של קרן קיימת‬
‫לישראל‬
‫תחנות ‪GPS‬‬
‫תחנות אוטובוס‬
‫‪34‬‬
‫‪bus_stops‬‬
‫‪t_delek‬‬
‫‪Health_care_baby_stations‬‬
‫‪FIRE_STATIONS‬‬
‫‪MADA_STATIONS‬‬
‫‪POLICE_Yehida_Location‬‬
‫‪BlueLines_Tamatamam‬‬
‫‪d180308_tarbut‬‬
‫‪beit_shean_7_5‬‬
‫תאור‬
‫תחנות אוטובוס ‪ -‬תחבורה‬
‫תחנות דלק‬
‫תחנות טיפת חלב‬
‫תחנות כיבוי אש‬
‫תחנות מגן דוד אדום‬
‫תחנות משטרה‬
‫תיחומי תמ"א תמ"מ‬
‫תרבות אורבאנית‬
‫תרחיש רעידת אדמה במוקד‬
‫בית שאן‬
‫‪35‬‬

גיאוגרפי שיתוף מידע ל פרוט יכולות מערכת אמצעות ב govmap

Transcription

Similar documents

govmap שימושים חדשים

דף המידע

שאלות נפוצות ותשובות לגבי רשת MOBPARTNER : נים

אפליקציית ל ותכנות התקנה מדריך I

פונקציית מנה - חקירת פונקציה רציונלית ( )1,0 ( )

זרקא