הקדמה
פורטל המפות הממשלתי, GovMap, מספק יכולות שיתוף מידע גיאוגרפי ושילוב רכיבי מפה בשלוש דרכים עיקריות ובדירוג מורכבות עולה:
URL– גלישה לפורטל המפות בתצורה התחלתית מוגדרת מראש (התמקדות לקואורדינאטות, קביעת קנה מידה, סוג המפה וכו’) על ידי הוספה של פרמטרים לכתובת ה-URL.
קוד HTML – הטמעת המפה על פי פרמטרים שמוגדרים ב- URL באתר מארח אחר.
פונקציות JavaScript – הפעלת פונקציונליות מתקדמת בחלונית המפה המוטמעת באמצעות קוד HTML.
הערה חשובה: המערכת תומכת בשדות מסוג מספר וטקסט באנגלית בלבד. במידה ושם השדה או ערך השדה מכילים תווים שאינם חוקיים ב-URL (למשל, תווים בעברית או רווחים) חובה לבצע URL encoding של תווים אלו. ניתן לבצע קידוד של כל המחרוזת (כולל שם השדה, התו המפריד ~ וערך השדה) באמצעות כל כלי קידוד קיים, למשל: http://meyerweb.com/eric/tools/dencoder. הקידוד ישאיר את התווים החוקיים כמו שהם ויקודד רק את התווים שאינם חוקיים.
פונקציות URL
השימוש ב- URL מאפשר למשתמש רגיל (ללא צורך בפיתוח) לשתף מפה אודות נקודת עניין כלשהי. למשל: כתובת, סניף בנק, נק’ מפגש וכדומה. ניתן ללחוץ על כפתור ‘שתף’ ולקבל קישור למפה המוצגת בכל רגע נתון. פעולת שיתוף ה- URL באמצעות מסמך או מייל מאפשר לפתוח את המערכת כשהמפה משחזרת את מצבה לרגע השיתוף.
למשתמש מתקדם יותר ישנה אפשרות לבנות את ה- URL בהתאם לכללים שיפורטו בהמשך.
התמקדות לפי קואורדינאטות
על מנת לצור התמקדות לפי קואורדינאטות, יש להוסיף ל-URL מידע על הקואורדינאטות (ברשת ישראל החדשה) שאליהן המפה תתמקד, באמצעות שימוש בפרמטר C. הפרמטר יכלול קואורדינאטות x (מיקום מזרח-מערב) ו- קואורדינאטות y (מיקום צפון-דרום) מופרדות ע”י פסיק.
שם פרמטר | תיאור | ערכים |
---|---|---|
c | קואורדינאטות ברשת ישראל החדשה או רשת גיאוגרפית עולמית (WGS84) שאליהן המפה תתמקד. הפרמטר יכלול קואורדינאטות x (מיקום מזרח-מערב) ו- קואורדינאטות y (מיקום צפון-דרום). אופציונאלי, רירת מחדל מרכז מפה. | X: בין 100,000 ל- 300,000 Y: בין 370,000 ל- 810,000 מופרדים ע”י פסיק. X: בין 4 ל- 36 Y: בין 29.4 ל- 33.4 מופרדים ע”י פסיק. |
z | קביעת קנה המידה ורמת הפירוט של המפה. אופציונאלי, ברירת מחדל 0. הערה – יתכנו שינויים ברמות הפרוט כתלות בסוג רקע נבחר בפרמטר b (יותר או פחות מ- 11 רמות). | בין 0 ל-10 (0-קנה מידה קטן ופירוט נמוך, 10-קנה מידה גדול ופרוט גבוה) |
b | סוג מפת הרקע. אופציונאלי, ברירת מחדל 0. | 1 ללא רקע 0 מפה 1 תצלום אוויר 2 משולב 3 רחובות ומבנים ב 2.5 ממדים |
lay | הוספת שכבות נוספות של שרת המפות הממשלתי אופציונאלי | רשימה של ערכי layer_name, שמות שכבות כפי שהוגדרו בשרות המפות (ראה נספח), מופרדת ע”י vertical bar |
קוד: https://www.govmap.gov.il/?c=179449,663927&z=8&b=0
הוספת שכבות מידע
פונקציה זו מאפשרת להוסיף שכבות מידע על גבי מפת הרקע. על מנת לאפשר זאת, יש להוסיף ל-URL מידע על השכבות שאותן מעוניינים להוסיף על גבי המפה, באמצעות שימוש בפרמטר lay.
שם פרמטר | תיאור | ערכים |
---|---|---|
lay | הוספת שכבות נוספות של שרת המפות הממשלתי. למשל, הוספת שכבת תחנות דלק (GASSTATIONS). | רשימה של ערכי layer_name, שמות השכבות כפי שהוגדרו בשרות המפות (ראה נספח), מופרדת ע”י פסיק |
פרמטרים נוספים לשימוש בפונקציה זו:
שם פרמטר | תיאור | ערכים |
---|---|---|
c | קואורדינאטות ברשת ישראל החדשה או רשת גיאוגרפית עולמית (WGS84) אליהן המפה תתמקד. הפרמטר יכלול קואורדינאטות x (מיקום מזרח-מערב) ו- קואורדינאטות y (מיקום צפון-דרום). אופציונאלי, רירת מחדל מרכז מפה. | X: בין 100,000 ל- 300,000 Y: בין 370,000 ל- 810,000 מופרדים ע”י פסיק. X: בין 34 ל- 36 Y: בין 29.4 ל- 33.4 מופרדים ע”י פסיק. |
z | קביעת קנה המידה ורמת הפירוט של המפה. אופציונאלי, ברירת מחדל 0. הערה – יתכנו שינויים רמות הפרוט כתלות בסוג רקע נבחר בפרמטר b (יותר או פחות מ- 11 רמות). | בין 0 ל-10 (0-קנה מידה קטן ופירוט נמוך, 10-קנה מידה גדול ופרוט גבוה) |
b | סוג מפת הרקע אופציונאלי, ברירת מחדל 0. | 1- ללא רקע 0 מפה 1 תצלום אוויר 2 משולב 3 רחובות ומבנים ב 2.5 ממדים |
קוד: https://www.govmap.gov.il/?c=179500,663900&z=6&b=1&lay=CELL_ACTIVE
הוספת בועית מידע על גבי המפה
שימוש בפרמטרים מתקדמים המאפשרים לפתוח את המפה עם בועית מידע המציגה מידע נוסף. למשל: הצגת בועית המציגה פרטי תחנת דלק מסוימת.
קיימת אפשרות לפתיחת בועית על גבי המפה לפי קואורדינטות של מיקום הבועית או לפי ערך של שדה מסוים בשכבה. במקרה של שכבה סטנדרטית יש להכניס את שם השדה כפי שהוא מופיע בשכבה הגיאוגרפית שבבסיס הנתונים הגיאוגרפי (feature class ב-SDE) ולא את הכינוי (alias) שניתן במסמך המפה. במקרה של שכבת משתמש יש להזין את שם השדה כפי שהוגדר ע”י המשתמש .
ניתן לבצע זאת על ידי שימוש ברכיבbs בפורמט הבא:
להצגת בועית על פי מיקום:
שמות השכבות שעליהן מעוניינים לקבל מידע בבועית מופרדות בפסיק, סימן | , קואורדינאטת X - מיקום הבועית על ציר ה-X וקואורדינאטת Y - מיקום הבועית על ציר ה- Y.
דוגמא:
בועית מידע על השכבות אנטנות סלולריות פעילות וחלקות בקואורדינטות X=178903 וY= ,664738 עם מפת רקע תצלום אויר וקנה מידה 10.
להצגת בועית לפי ערך שדה בשכבה:
שם שכבה שעליה מעוניינים לקבל מידע , סימן |, שם שדה לחיפוש , סימן ~ , ערך שדה לחיפוש. דוגמא: בועית מידע על השכבה תחנת דלק לפי ערך של השדה NAME שווה הסיירים.
https://www.govmap.gov.il/?c=181768.3,656616.31&z=7&lay=GASSTATIONS&bs=GASSTATIONS|NAME~הסיירים
HTML
כללי
אתר המפות הממשלתי מאפשר לשלב חלונית מפה בדף מארח אחר. על מנת להוסיף את המפה לדף המארח, יש להוסיף לגוף הדף iframe הכולל URL להגדרת מצב המפה המבוקש (מרכז מפה ראשוני, קנ”מ, סוג רקע, גודל וכו’).
הדרך הקלה ביותר להגדרת ה- iframe הינה באמצעות שימוש בכפתור ‘שתף’ ובחירת האפשרות קוד HTML. במידה ותצורה זו עונה על הצורך, ניתן להעתיקה לדף המארח. במידה ולא, ניתן לבחור באפשרות לביצוע התאמה אישית ותצוגה מקדימה.
פונקציות JavaScript
כללי
על מנת להשתמש בפונקציונאליות מתקדמת לאחר הוספת המפה לדף מארח יש להוסיף לקוד של הדף את קובץ ה- JavaScript באופן הבא:
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
לאחר עליית הדף המארח הכולל את ה- div של המפה, ניתן ליצור את המפה ע”י שימוש בפונקציה createMap ולאחר מכן, ניתן להגדיר את פונקציית JavaScript של ה- API בה מעוניינים להשתמש.
לדוגמא, ניתן להוסיף את govmap.api.js ל body בו מופיע ה div של המפה ב-HTML:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: "1",
layersMode: 1,
zoomButtons:false
});
});
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
</head>
<body>
יצירת מפה
פונקציה זו מאפשרת למשתמש ליצור את המפה בדף HTML. הפונקציה מקבלת כפרמטר את כל ההגדרות של המפה.
הפונקציה מקבלת כפרמטר ראשון את מחרוזת ה- id של ה-div שיכיל את המפה וכפרמטר שני אובייקט של הגדרות המפה שחייב להכיל לפחות את ה-token שהמשתמש קיבל ל-Domain שלו.
פונקציית יצירת מפה:
govmap.createMap(mapDivID, MapSetting);
פרמטרים לפונקציה:
תיאור | סוג |
---|---|
id של ה div שמכיל את המפה | string |
אובייקט הגדרות המפה | object |
אובייקט הגדרות המפה:
שם | סוג | תיאור |
---|---|---|
onClick | function | פונקציה להפעלה בלחיצה על אזור המפה ע”י העכבר |
onError | function | פונקציה להפעלה במקרה שגיאה |
onPan | function | פונקציה להפעלה בשינוי מיקום המפה |
onLoad | function | פונקציה להפעלה לאחר טעינת המפה |
Background | string | id של מפת הרקע, הערכים: 1- ללא רקע 0 מפה 1 תצלום אוויר 2 משולב 3 רחובות ומבנים ב 2.5 ממדים |
center | object | נקודת המרכז של המפה { x: number, y: number } |
visibleLayers | string[] | מערך של שמות שכבות שיהיו דלוקות על המפה |
showXY | boolean | מסמן אם להציג את הקואורדינטות בשינוי מיקום העכבר על המפה |
level | number | רמת התמקדות |
token | string | שהמשתמש קיבל |
identifyOnClick | boolean | מסמן אם לבצע תשאול שכבות בלחיצה על המפה |
layers | string[] | מערך של שמות שכבות שיופיעו ברשימת השכבות של המפה |
bgButton | boolean | מסמן האם להציג את הכפתור שינוי רקע על המפה. |
zoomButtons | boolean | משתנה בוליאני המסמן האם להציג את כפתורי ההתמקדות על המפה. |
isEmbeddedToggle | boolean | מציין את מצב כפתור שינוי רקע בהתאם להגדרות הבאות: true - כפתור שינוי רקע מבצע החלפת מפת רקע בין רחובות ומבנים לתצלום אוויר בלבד ואינו פותח ממשק בחירת מפת רקע. false – במידה ורוחב וגובה המפה גדולים מ 650 ו440 פיקסלים בלחיצה על כפתור שינוי רקע ייפתח ממשק בחירת מפות רקע. |
layersMode | number | מספר המייצג את מצב כפתור שכבות בלחיצה על כפתור שכבות מידע ייפתח ממשק בהתאם למספר שנשלח: 1 - ממשק להדלקה או/ו כיבוי שכבות 2 - ממשק להדלקה או/ו כיבוי שכבות ומקרא 3 - ממשק מקרא בלבד 4 - לא יוצג כפתור שכבות על המפה. |
קוד לדוגמה:
<head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { onClick: function (e) { showResult(e); }, onPan: function (e) { showResult(e); }, token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); </script> </head> <body> <div id="map" style="width:600px;height:600px"> </div> </body> </html>
הרשמה לאירועי מפה
פונקציה זו מאפשרת רישום לאירועי מפה שונים. הפונקציה מקבלת כפרמטר את ה-Event (מתוך ה-enum govmap.events) שמעוניינים להירשם אליו, ופונקציית callbackלקבלת תשובה. התשובה שונה לכל אירוע.
govmap.onEvent(EVENT).progress(CALLBACK FUNCTION);
האובייקט הנשלח לפונקציה:
תיאור | סוג | ערכים |
---|---|---|
שם האירוע אליו רוצים להירשם | enum govmap.events | PAN EXTENT_CHANGE CLICK DOUBLE_CLICK MOUSE_MOVE MOUSE_OVER |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); govmap.onEvent(govmap.events.CLICK).then(function (e) { alert("click event "); }); }); </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> </body> </html>
סוגי אירועים:
PAN - שינוי תיחום מפה
פונקציה זו משמשת לקבלת חיווי על כל שינוי תיחום וקואורדינטות התיחום החדש. הפונקציה יכולה לשמש במקרים בהם מעוניינים להציג מידע רלוונטי לתיחום באתר המארח.
מבנה התשובה
"delta": { "type": "point", "x": 40.310564552243136, "y": 64.03479037314042 }, "extent": { "type": "extent", "xmin": -146290.96119526535, "ymin": 532321.2395011593, "xmax": 409335.1500569571, "ymax": 929197.0332527468, "spatialReference": { "wkid": 2039 }, "_shifted": null, "_parts": null }
EXTENT_CHANGE שינוי קנה מידה של תצוגת המפה
פונקציה זו משמשת לקבלת חיווי על כל שינוי קנה מידה של תצוגת המפה.
מבנה התשובה
"delta": { "type": "point", "x": 0, "y": 0 }, "extent": { "type": "extent", "xmin": 159418.33754334296, "ymin": 547742.7586198879, "xmax": 252022.68941871327, "ymax": 613888.7242451523, "spatialReference": { "wkid": 2039 }, "_shifted": null, "_parts": null }, "levelChange": true, "lod": { "level": 2, "resolution": 132.291931250529, "scale": 500000, "startTileRow": 0, "startTileCol": 0, "endTileRow": 801, "endTileCol": 751 }
CLICK לחיצה על המפה באמצעות העכבר
פונקציה זו משמשת לקבלת חיווי על כל לחיצה על איזור המפה באמצעות העכבר.
מבנה התשובה
"mapPoint": { "type": "point", "x": 225431.29286258575, "y": 575156.2103124206, "spatialReference": { "wkid": 2039 } }, "screenPoint": { "type": "point", "x": 377, "y": 275 }
DOUBLE_CLICK לחיצה כפולה על המפה באמצעות העכבר
פונקציה זו משמשת לקבלת חיווי על כל לחיצה כפולה על אזור המפה באמצעות העכבר.
מבנה התשובה
"mapPoint": {
"type": "point",
"x": 219875.03175006347,
"y": 616695.8767250867,
"spatialReference": {
"wkid": 2039
}
},
"screenPoint": {
"type": "point",
"x": 426,
"y": 168
}
MOUSE_MOVE הזזת סמן העכבר מעל המפה
פונקציה זו משמשת לקבלת חיווי על כל הזזת העכבר על אזור המפה.
מבנה התשובה
"mapPoint": {
"type": "point",
"x": 601697.1602530006,
"y": 674402.7736642276,
"spatialReference": {
"wkid": 2039
}
},
"screenPoint": {
"type": "point",
"x": 698,
"y": 296
}
MOUSE_OVER כניסה עם העכבר מעל המפה
פונקציה זו משמשת לקבלת חיווי על כניסת סמן העכבר מעל המפה.
מבנה התשובה
"data": {
"isTrusted": true,
"screenPoint": {
"type": "point",
"x": 685,
"y": 341
},
"mapPoint": {
"type": "point",
"x": 397428.8762444094,
"y": 658527.741914164,
"spatialReference": {
"wkid": 2039
}
},
"numPoints": 0
}
הסרת רישום לאירוע מפה
פונקציה זו מאפשרת להסיר את הרישום לאירוע שנעשה באמצעות הפונקציה הקודמת govmap.onEvent. הפונקציה מקבלת כפרמטר Event (מתוך ה enum govmap.events).
govmap.unbindEvent(EVENT);
תיאור | סוג | ערכים |
---|---|---|
שם האירוע אותו רוצים להסיר | enum govmap.events | PAN EXTENT_CHANGE CLICK DOUBLE_CLICK MOUSE_MOVE MOUSE_OVER |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); govmap.unbindEvent(govmap.events.CLICK); }); </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> </body> </html>
ריענון תצוגת מפה
פונקציה זו מאפשרת ריענון של תצוגת המפה עבור שכבה מסוימת או מספר שכבות שמגיעות מאותו resource. הפונקציה מקבלת אובייקט המכיל את שם הפרמטר המועבר: resource או layerName והערך – שם השכבה או ה- resource.
govmap.refreshResource({ parameterName : value });
האובייקט הנשלח לפונקציה:
שם פרמטר | סוג | תיאור |
---|---|---|
resource או layerName |
string | שם layerName או ה resource |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.refreshResource({ resource: 'additionalData' }); govmap.refreshResource({ layerName: 'sub_gush_all' }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
חיפוש ישויות בשכבה לפי כתובת, פוליגון, מרובע או קואורדינטות
פונקציה זו מאפשרת למשתמש לחפש ישויות בשכבה מסוימת (ולציין איזה שדות של השכבה ברצונו לקבל בתשובה). ניתן לחפש לפי כתובת, פוליגון, מרובע או קואורדינטות. הפונקציה מחזירה מערך של אובייקטים שנמצאו בכתובת או בנקודה.
עבור כל אובייקט המשתמש יקבל את ה-objectid, תאריך היצירה וערכי השדות שביקש.
govmap.intersectFeatures(params);
האובייקט הנשלח לפונקציה בחיפוש לפי כתובת:
שם פרמטר | סוג | תיאור |
---|---|---|
address | string | מחרוזת כתובת במידה והמשתמש מעוניין לחפש לפי כתובת |
geometry | string | מחרוזת המייצגת את הגאומטריה בפורמט wkt במידה והמשתמש |
layerName | string | שם שכבה לחיפוש |
fields | []string | מערך של מחרוזות – שמות השדות שהמשתמש רוצה לקבל בתשובה |
חיפוש ישויות בשכבה לפי כתובת:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ var params ={ address: "הרוקמים 26 חולון", layerName: "SUB_GUSH_ALL", fields: ['GUSH_NUM'] } govmap.intersectFeatures(params).then(function (response) { console.log(response); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה:
{ "errorCode": 0, "status": 0, "message": null, "data": [ { "ObjectId": 2652437, "Created": "0001-01-01T00:00:00", "IsEditable": true, "Values": [ 6802 ] } ], "active": false }
האובייקט הנשלח לפונקציה בחיפוש לפי מיקום קואורדינטות:
שם פרמטר | סוג | תיאור |
---|---|---|
point | object | קואורדינאטות לחיפוש, האובייקט מכיל:: x - מספר y - מספר |
layerName | string | שם שכבה לחיפוש |
fields | []string | מערך של מחרוזות – שמות השדות שהמשתמש רוצה לקבל בתשובה |
דוגמה לחיפוש ישויות בשכבה לפי מיקום קואורדינטות:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: "1",
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
point: {x: 167127.5939715321,
y: 624580.483296493},
layerName: "SUB_GUSH_ALL",
fields: ['GUSH_NUM']
}
govmap.intersectFeatures(params).then(function (response)
{
console.log(response)
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תשובה:
{
"errorCode": 0,
"status": 0,
"message": null,
"data": [
{
"ObjectId": 2642518,
"Created": "0001-01-01T00:00:00",
"IsEditable": true,
"Values": [
2771
]
}
],
"active": false
}
חיפוש גוש/חלקה לכתובת או כתובת לגוש/חלקה
פונקציה זו מבצעת חיפוש מרחבי של כתובת/כתובות הנמצאות בגוש/חלקה נתון או חיפוש מרחבי של גוש וחלקה המכילים כתובת נתונה.
govmap.searchAndLocate(params);
האובייקט הנשלח לפונקציה:
שם פרמטר | סוג | תיאור |
---|---|---|
Type | enum govmap.locateType | סוג החיפוש המבוקש: addressToLotParcel lotParcelToAddress |
Address | string | כתובת - במידה והחיפוש מתבצע לגוש/חלקה לכתובת |
Lot | number | גוש – במידה והחיפוש מתבצע לפי כתובת לגוש/חלקה |
Parcel | number | חלקה – במידה והחיפוש מתבצע לפי כתובת לגוש/חלקה |
הפונקציה מחזירה מערך של אובייקטים שהם תוצאות החיפוש
דוגמא חיפוש גוש חלקה לכתובת:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: "1",
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
type:govmap.locateType.lotParcelToAddress,
address: 'עין גדי 32, אילת'
}
govmap.searchAndLocate().then(function(response){
console.log(response)
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תוצאות חיפוש גוש חלקה לכתובת:
[ { "ObjectId": 145758377, "Created": "0001-01-01T00:00:00", "IsEditable": true, "Values": [ 40095, 13 ] } ]
חיפוש כתובת לגוש חלקה:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: "1",
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
type:govmap.locateType.addressToLotParcel,
lot: 40095,
parcel:13
}
govmap.searchAndLocate(params).then(function(response){
console.log(response);
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תוצאות חיפוש גוש חלקה לכתובת:
[ { "ObjectId": 1381, "Created": "0001-01-01T00:00:00", "IsEditable": true, "Values": [ "אילת", "עין גדי", 32 ] }, { "ObjectId": 57, "Created": "0001-01-01T00:00:00", "IsEditable": true, "Values": [ "אילת", "עין גדי", 26 ] }, { "ObjectId": 1, "Created": "0001-01-01T00:00:00", "IsEditable": true, "Values": [ "אילת", "עין גדי", 28 ] } ]
הגדרת מפות רקע
פונקציה זו משנה את מפת הרקע של רכיב למפה לפי קוד בדומה לאפשרויות באתר הראשי.
govmap.setBackground(backroundTypeID);
תיאור | סוג | ערכים |
---|---|---|
id של מפת הרקע | number | 1- ללא רקע 0 מפה 1 תצלום אוויר 2 משולב 3 רחובות ומבנים ב 2.5 ממדים |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.setBackground(-1); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
שינוי סמן העכבר על המפה
פונקציה זו מאפשרת לשנות את סמן העכבר על גבי המפה.
govmap.setMapCursor(govmap.cursorType);
תיאור | סוג | ערכים |
---|---|---|
סוג הסמן המבוקש | enum govmap.cursorType | DEFAULT TARGET POLYGON CIRCLE RECTANGLE SELECT_FEATURES |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.setMapCursor(govmap.cursorType.TARGET); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
חזור לכלי ברירת מחדל
פונקציה זו מחזירה את המפה למצב של כלי נבחר – הזזת מפה (Pan).
govmap.setDefaultTool();
דוגמה:
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: "1",
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
govmap.setDefaultTool();
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
מדידות על המפה
פונקציה זו פותחת חלון של כלי מדידה המאפשר למשתמש לבצע מדידות על גבי המפה.
govmap.showMeasure();
דוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.showMeasure(); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
ציור גאומטריה על המפה
פונקציה זו מכניסה את המפה למצב של ציור גאומטריות לפי הפרמטר govmap.drawType שהיא מקבלת.
govmap.draw(drawType);
תיאור | סוג | ערכים |
---|---|---|
סוג מצב ציור גאומטרי | govmap.drawType | Point Polyline Polygon Circle Rectangle FreehandPolygon |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.draw(govmap.drawType.Point).progress(function (response) { }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
דוגמאות לתשובות בהתאם ל drawType הנבחר:
ציור נקודה - Point
אובייקט החוזר בתשובה להוספת נקודה על המפה - Point:
שם | סוג | תיאור |
---|---|---|
tolerance | number | רמת דיוק במטרים לצורך תשאול נקודתי עתידי |
wkt | string | קואורדינטות הנקודה כמחרוזת wkt |
תשובה להוספת נקודה - Point:
{ tolerance: 11906.273812547624, wkt: "POINT(187331.21666243332 575949.9618999237)" }
ציור קו - Polyline:
הפונקציה מחזירה את קואורדינאטות הקו בסיום הציור, לאחר לחיצה כפולה על העכבר, Double Click (לחיצה לכל קודקוד ו- Double Click לסיום ציור).
בכניסה למצב זה אייקון העכבר משתנה ל- + (צלב).
אובייקט החוזר בתשובה לציור קו - Polyline:
שם | סוג | תיאור |
---|---|---|
tolerance | number | רמת דיוק במטרים לצורך תשאול נקודתי עתידי |
wkt | string | קואורדינטות הקו כמחרוזת wkt |
notify | boolean | c |
תשובה לציור קו - Polyline:
{ wkt: "LINESTRING(170704.30 579380.05, 232881.51 556890.42, 232881.51 556890.42)", notify: true, tolerance: 11906.273812547624 }
ציור מצולע - Polygon:
הפונקציה מחזירה את קואורדינאטות המצולע בסיום הציור, לאחר לחיצה כפולה על העכבר, Double Click (לחיצה לכל קודקוד ו- Double Click לסיום ציור).
בכניסה למצב זה אייקון העכבר משתנה ל- + (צלב).
הפונקציה מחזירה אובייקט המכיל את קואורדינאטות המצולע, מוחזרות כמחרוזת WKT של רצף ערכי הקואורדינאטות X1,Y1;X2,Y2;….;Xn,Yn ואובייקט המייצג את הגאומטריה.
אובייקט החוזר בתשובה לציור מצולע - Polygon:
שם | סוג | תיאור |
---|---|---|
tolerance | number | רמת דיוק במטרים לצורך תשאול נקודתי עתידי |
wkt | string | קואורדינטות המצולע כמחרוזת wkt |
geometry | object | אובייקט המייצג את הגאומטריה |
תשובה לציור מצולע - POLYGON:
{ wkt: "POLYGON(210350.01 654531.37, 200031.24 636275.08,…93.80, 177806.20 545787.40, 210350.01 654531.37)", geometry: { type: "polygon", rings: [ [ [ 210350.0127000254, 654531.3690627381 ], [ 200031.24206248412, 636275.082550165 ], [ 200031.24206248412, 637068.8341376683 ], [ 209556.26111252222, 640243.840487681 ], [ 208762.50952501904, 657706.3754127508 ], [ 211937.51587503174, 652150.1143002285 ], [ 220668.78333756665, 621193.8023876047 ], [ 177806.19761239522, 545787.401574803 ], [ 210350.0127000254, 654531.3690627381 ] ] ], _ring: 0, spatialReference: { wkid: 2039 }, _centroid: null, _extent: { xmin: 177806.19761239522, ymin: 545787.401574803, xmax: 220668.78333756665, ymax: 657706.3754127508, spatialReference: { wkid: 2039 } }, _partwise: null } tolerance: 11906.273812547624 }
ציור עיגול - Circle
הפונקציה מחזירה את קואורדינאטות המרכז ואת הרדיוס בסיום הציור, לאחר שחרור הכפתור (לחיצה, גרירה ושחרור לסיום ציור). בכניסה למצב זה אייקון העכבר משתנה ל- + (צלב).
אובייקט החוזר בתשובה לציור עיגול - Circle:
שם | סוג | תיאור |
---|---|---|
x | number | ערך ה x במרכז העיגול |
y | number | ערך ה y במרכז העיגול |
radius | number | רדיוס העיגול |
תשובה ל Circle:
{ x: 226225.04445008922, y: 560868.6817373636, radius: 95474.82190598734 }
ציור מלבן - Rectangle
הפונקציה מחזירה את הקואורדינאטות הפינות בסיום הציור, לאחר שחרור הכפתור (לחיצה, גרירה ושחרור לסיום ציור). בכניסה למצב זה אייקון העכבר משתנה ל- + (צלב). הפונקציה מחזירה את קואורדינטות המלבן בתצורת WKT.
אובייקט החוזר בתשובה לציור מלבן - Rectangle:
שם | סוג | תיאור |
---|---|---|
wkt | string | קואורדינטות הפינות כמחרוזת wkt |
tolerance | number | רמת דיוק במטרים לצורך תשאול נקודתי עתידי |
תשובה ל Rectangle:
{ wkt: "POLYGON((197649.99 695806.45, 231781.31 695806.45, 231781.31 624368.81, 197649.99 624368.81, 197649.99 695806.45))", tolerance: 11906.273812547624 }
ציור חופשי של מצולע - FreehandPolygon
ציור חופשי של מצולע. הפונקציה מחזירה את קואורדינאטות המצולע בסיום הציור. הפונקציה מחזירה אובייקט המכיל את קואורדינאטות המצולע, מוחזרות כמחרוזת WKT של רצף ערכי הקואורדינאטות X1,Y1;X2,Y2;….;Xn,Yn ואובייקט המייצג את הגאומטריה.
אובייקט החוזר בתשובה לציור חופשי של מצולע - FreehandPolygon:
שם | סוג | תיאור |
---|---|---|
wkt | string | קואורדינטות הפינות כמחרוזת wkt |
tolerance | number | רמת דיוק במטרים לצורך תשאול נקודתי עתידי |
תשובה ל FreehandPolygon:
{ wkt: "POLYGON((197649.99 695806.45, 231781.31 695806.45, 231781.31 624368.81, 197649.99 624368.81, 197649.99 695806.45))", tolerance: 11906.273812547624 }
התמקדות לגאומטריה שצוירה על המפה
פונקציה זו מבצעת התמקדות במפה לתיחום הציור שבוצע עליה (מלבן, עיגול, מצולע).
govmap.zoomToDrawing()
התמקדות לציור:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: "1", layersMode: 1, zoomButtons:false }); }); function showExample(){ //start draw mode govmap.draw(govmap.drawType.Circle).progress(function (response) { //wait 3 seconds and zoom to the drawed circle setTimeout(function(){ govmap.zoomToDrawing();}, 3000) }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
הוספת גאומטריות מאתר המארח למפה
פונקציה זו מאפשרת לייצר אינטראקציה בין האתר המארח למפה ולהציג על גביה אוסף ישויות לאותו מיקום, סימול ותוכן בועית (רצוי שהשליטה תהיה של הדף המארח).
הפונקציה מקבלת כפרמטר אובייקט המכיל את כל הנתונים הדרושים להוספת הגאומטריות ומחזירה מערך של מספרים ה-ids של הגאומטריות שהוסיפו למפה.
govmap.displayGeometries(data);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם פרמטר | סוג | תיאור |
---|---|---|
wkts | []string | wkt מערך של מחרוזות המייצגות את הגאומטריות בפורמט |
names | []string | שם הגאומטריות |
geometryType | enum govmap.drawType | סוג הגאומטריה הרצויה |
defaultSymbol | object | סימבול בהתאם לסוג הציור, דוגמאות מפורטות מטה |
symbols | []string | במידה ורוצים להציג כל גאומטריה בסימבול שונה יש לשלוח מערך של סימבולים |
clearExistings | boolean | משתנה בוליאני האם למחוק את הגאמטריות הקיימות על המפה לפני הציור או לא |
data | object | מידע נוסף אם המשתמש רוצה שיוצג טולטיפ במעבר מעל הגאומריות או בועית מידע בקליק על גאומטריה קיימים בו ה properties הבאים: tooltips - מערך של מחרוזות להצגה בטולטיפ במעבר מעל הגאומטריות headers - מערך של כותרות הבועיות bubbleUrl - כתובת הבסיס לתוכן הבועית bubbles - מערך של פרמטרים לבועית מידע שכל איבר מהמערך ישורשר לכתובת הבסיס bubblesUrl bubbleHTML - מחרוזת html אשר תוצג בבעוית. פעיל רק כאשר לא מועבר bubbleUrl! bubbleHTMLParameters -מערך דו-מימדי של מחרוזות אשר מכיל את הפרמטרים שיוצגו בתוך ה bubblesHtml לפי הסדר (ז”א שהפרמטרים שבמערך הראשון יוצגו בבועית הראשונה וכו’).פעיל רק כאשר לא מועבר bubbleUrl! |
פרמטר חוזר:
שם פרמטר | סוג | תיאור |
---|---|---|
data | []number | רשימת id של הגאומטריות שנוצרו |
הוספת 3 נקודות על המפה:
אובייקט symbol עבור נקודה:
שם פרמטר | סוג | תיאור |
---|---|---|
url | strig | url של התמונה |
width | number | רוחב התמונה |
height | number | אורך התמונה |
קוד לדוגמה: הוספה של 3 נקודות, בלחיצה על נקודה תיפתח בועית עם לינק לדף באתר ynet. (שימוש ב bubblesUrl)
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
//Create data object
var data = {
wkts: ['POINT(196062.48 621458.39)', 'POINT(200000.48 600000.39)', 'POINT(25000.48 650000.39)' ],
names: ['p1','p2','p3'],
geometryType: govmap.drawType.Point,
defaultSymbol:
{
url:'http://www.creatingonline.com/webmaster/free_bullets/greenbullet1.gif',
width:15,
height:15
},
symbols: [
{url:'http://www.creatingonline.com/webmaster/free_bullets/goldbullet1.gif', width:15, height:15},
{url:'http://www.creatingonline.com/webmaster/free_bullets/blackbullet1.gif', width:15, height:15},
{url: 'http://www.creatingonline.com/webmaster/free_bullets/greenbullet1.gif', width: 15, height: 15 }
],
clearExisting: true,
data: {
tooltips: ['ynet כלכלה','ynet חדשות','ynet תרבות'],
headers: ['כלכלה','חדשות','תרבות'],
bubbles: ['L-6,00.html',
'L-2,00.html',
'L-538,00.html'],
bubbleUrl: 'https://www.ynet.co.il/home/0,7340,'
}
};
govmap.displayGeometries(data).then(function (response)
{
console.log(response.data);
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תשובה (רשימת id’s ):
data: [0, 1, 2]
הוספת עיגול על המפה:
במקרה זה במקום הפרמטר wkts הפונקציה מקבלת פרמטר circleGeometries מסוג מערך של אובייקטים. כל אובייקט במערך יכיל את המאפיינים של עיגול (קואורדינטות x ו y של מרכז העיגול ו radius).
אובייקט symbol עבור עיגול:
שם פרמטר | סוג | תיאור |
---|---|---|
outlineColor | []number | צבע קו הגבול |
outlineWidth | number | עובי קו הגבול |
fillColor | []number | צבע מילוי |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var data = { circleGeometries : [{ x: 183184, y: 669173, radius:5000 }], names: ['p1'], geometryType: govmap.drawType.Circle, defaultSymbol: { outlineColor: [0, 0, 255, 1], outlineWidth: 1, fillColor: [0, 255, 0, 0.5] }, symbols: [], clearExisting: true, data: { tooltips: ['tooltip1'], headers: ['header1'], bubbles: [''], bubbleUrl: 'http://www.porterdavis.com.au/~/media/homes/astor%20grange/lot%20123%20liverpool%20street%20upc/upper-point-cook---astor-grange-54---0741_long-island-facade.jpg?as=1&h=649&la=en&w=1400&crop=1' } }; govmap.displayGeometries(data).then(function (response) { console.log(response.data); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה (רשימת id’s ):
data: [0]
הוספת פוליגון על גבי המפה:
אובייקט symbol עבור פוליגון:
שם פרמטר | סוג | תיאור |
---|---|---|
outlineColor | []number | צבע קו הגבול |
outlineWidth | number | עובי קו הגבול |
fillColor | []number] | צבע מילוי |
קוד לדוגמה: בלחיצה על פוליגון תיפתח בועית עם html שהוגדר (שימוש בbubblesHtml)
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var bubbleContent = "<div style='border: 1px solid #525252; margin: 10px;padding: 10px;'><div style='background-color: yellow;'>{0}</div><div style='background-color: blue;'>{1}</div></div>"; var data = { wkts: ["POLYGON((151612.40 534674.88, 215112.52 538643.64, 98431.04 445774.70, 74618.49 521974.85, 80968.50 552931.17, 151612.40 533881.13,151612.40 534674.88))", "POLYGON((196062.48 621458.39, 196591.65 622516.72, 197649.99 659293.88, 229929.22 665379.31, 243423.00 632306.33, 196062.48 621458.39))"], names: ['p1', 'p2'], geometryType: govmap.drawType.Polygon, defaultSymbol: { outlineColor: [0, 80, 255, 1], outlineWidth: 1, fillColor: [138, 43, 226, 0.5] }, symbols: [], clearExisting: true, data: { tooltips: ['פוליגון 1 tooltip', 'פוליגון 2 tooltip'], headers: ['פוליגון 1 כותרת','פוליגון 2 כותרת'], bubbleHTML: bubbleContent, bubbleHTMLParameters: [['פוליגון 1','מידע נוסף...'], ['פוליגון 2', 'מידע נוסף...']] } }; govmap.displayGeometries(data).then(function (response) { console.log(response.data); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה (רשימת id ):
data: [0, 1]
הוספת קו על גבי המפה:
אובייקט symbol עבור קו:
שם פרמטר | סוג | תיאור |
---|---|---|
color | []number | צבע הקו |
width | number | עובי הקו |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var data = { wkts: ['LINESTRING(181638.5702018566 691584.9075372377, 230586.58476455236 683382.807799705)'], names: ['p1'], geometryType: govmap.drawType.Polyline, defaultSymbol: { color: [255, 0, 80, 1], width: 1, }, symbols: [], clearExisting: true, data: { tooltips: ['חדשות ynet'], headers: ['חדשות'], bubbles: ['L-2,00.html'], bubbleUrl: 'https://www.ynet.co.il/home/0,7340,' } }; govmap.displayGeometries(data).then(function (response) { console.log(response.data); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה (רשימת id’s ):
data: [0]
מחיקת כל הגאומטריות
פונקציה זו מוחקת את כל הישויות הגרפיות שצוירו על המפה.
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var data = { wkts: ['LINESTRING(181638.5702018566 691584.9075372377, 230586.58476455236 683382.807799705)'], names: ['p1'], geometryType: govmap.drawType.Polyline, defaultSymbol: { color: [255, 0, 80, 1], width: 1, }, symbols: [], clearExisting: true, data: { tooltips: ['tooltip1'], bubbles: [''], bubbleUrl: 'http://govmap.gov.il' } }; //draw circle govmap.draw(govmap.drawType.Circle).progress(function (response) { //clear drawings after 3 seconds setTimeout(function(){ govmap.clearDrawings(); },3000); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
מחיקת גאומטריות לפי שם
הפונקציה מוחקת את הגאומטריות שנוספו למפה לפי השם שלהם.
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var data = { wkts: ["POLYGON((151612.40 534674.88, 215112.52 538643.64, 98431.04 445774.70, 74618.49 521974.85, 80968.50 552931.17, 151612.40 533881.13,151612.40 534674.88))", "POLYGON((196062.48 621458.39, 196591.65 622516.72, 197649.99 659293.88, 229929.22 665379.31, 243423.00 632306.33, 196062.48 621458.39))"], names: ['p1', 'p2'], geometryType: govmap.drawType.Polygon, defaultSymbol: { outlineColor: [0, 80, 255, 1], outlineWidth: 1, fillColor: [138, 43, 226, 0.5] }, symbols: [], clearExisting: true, data: { tooltips: ['tooltip1', 'tooltip1'], bubbles: ['',''], bubbleUrl: 'http://govmap.gov.il' } }; //drow polygon govmap.displayGeometries(data).then(function (response) { console.log(response.data); //clear drawings after 3 seconds setTimeout(function(){ govmap.clearGeometriesByName(['p1', 'p2']); },3000); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
מחיקת גאומטריות לפי id
הפונקציה מוחקת את הגאומטריות שנוספו למפה על פי המזהה שלהם.
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var data = { wkts: ["POLYGON((151612.40 534674.88, 215112.52 538643.64, 98431.04 445774.70, 74618.49 521974.85, 80968.50 552931.17, 151612.40 533881.13,151612.40 534674.88))", "POLYGON((196062.48 621458.39, 196591.65 622516.72, 197649.99 659293.88, 229929.22 665379.31, 243423.00 632306.33, 196062.48 621458.39))"], names: ['p1', 'p2'], geometryType: govmap.drawType.Polygon, defaultSymbol: { outlineColor: [0, 80, 255, 1], outlineWidth: 1, fillColor: [138, 43, 226, 0.5] }, symbols: [], clearExisting: true, data: { tooltips: ['tooltip1', 'tooltip1'], bubbles: ['',''], bubbleUrl: 'http://govmap.gov.il' } }; //drow polygon govmap.displayGeometries(data).then(function (response) { console.log(response.data); //clear drawings after 3 seconds setTimeout(function(){ govmap.clearGeometriesById(response.data); },3000); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
התמקדות לקואורדינאטות וקנ”מ
פונקציה זו מאפשרת הוספת סמן על המפה ומבצעת התמקדות למיקום וקנ”מ על פי הפרמטרים המוזנים.
zoomToXY(params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם פרמטר | סוג | תיאור |
---|---|---|
x | number | קואורדינאטות המיקום מזרח-מערב |
y | number | קואורדינאטות המיקום צפון-דרום |
level | number | רמת התמקדות (זהה לפרמטר ז ב URL של הפורטל המלא), ערך בין 0-10. 0 - קנה מידה קטן ופירוט נמוך 10 - קנה מידה גדול ופרוט גבוה |
marker | boolean | מסמל האם להוסיף סמן על המפה או לא |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.zoomToXY({ x: 176085, y: 657600, level: 10, marker: true }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
הסרת סמן marker מהמפה
פונקציה זו מסירה מהמפה את הסמן.
govmap.clearMapMarker();
דוגמה להסרת סימון מהמפה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); //zoom and put marker govmap.zoomToXY({ x: 176085, y: 657600, level: 10, marker: true }); function showExample(){ govmap.clearMapMarker(); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
קבלת קואורדינטות סמן
פונקציה זו מחזירה קואורדינטות מיקום נוכחי של הסמן במפה. יש לקורא לפונקציה, אייקון העכבר משתנה ל- + (צלב) ולאחר לחיצה על נקודה במפה יוחזרו הקואורדינטות בתשובה.
govmap.getXY();
אובייקט החוזר בתשובה להוספת נקודה על המפה - Point:
שם | סוג | תיאור |
---|---|---|
mapPoint | object | קואורדינטות הנקודה על המפה |
screenPoint | object | קואורדינטות הנקודה על המסך |
דוגמה לקבלת קואורדינטות מיקום נוכחי :
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.getXY().progress( function(response){ console.log(response); }); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה:
{ "mapPoint": { "type": "point", "x": 163825.1241607553, "y": 570913.3635244331, "spatialReference": { "wkid": 2039 } }, "screenPoint": { "type": "point", "x": 260, "y": 243 } }
חיפוש geocode
פונקציה זו מפעילה את שירות החיפוש החופשי עם המחרוזת לחיפוש ומחפשת כתובות המתאימות לחיפוש ומחזירה תשובה .התשובה כוללת נתוני מיקום (X, Y), קוד מאפיין התוצאה (ResultCode) לפי הפירוט הבא: 1-תוצאה מדויקת יחידה. 2-תוצאה חלקית (למשל, רחוב נמצא ומס’ בית לא) או תוצאה דומה למחרוזת החיפוש, אך עם זאת תוצאה יחידה. 3-מנגנון החיפוש החופשי מצא יותר מתוצאה אחת לפי מחרוזת החיפוש שסופקה או לא החזיר כלל תוצאה (מסיבה כלשהי). במקרה זה לא מועבר המיקום בתשובה.
במידה ונמצאה יותר מתוצאה אחת, התשובה תכלול גם את רשימת הכתובות האפשריות לחיפוש.
govmap.geocode(params);
האובייקט הנשלח לפונקציה:
שם | סוג | תיאור |
---|---|---|
keyword | string | כתובת לחיפוש |
type | enum govmap.geocodeType | סוג החיפוש המבוקש: FullResult - חיפוש תוצאות מלאות AccuracyOnly - חיפוש תוצאה מדויקת |
דוגמה לחיפוש מדויק:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> function showExample(){ govmap.geocode({keyword: 'הרוקמים', type: govmap.geocodeType.AccuracyOnly} ).then(function(response){ console.log(response) }); } </script> </head> <body> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה לחיפוש תוצאה מדויקת:
{ "errorCode": 0, "status": 0, "message": null, "data": [ { "ResultLable": "רחוב הרוקמים, חולון", "ResultType": 1, "ObjectID": "66000127", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 181344.87, "Y": 657243.76, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false } ], "active": false }
דוגמה לחיפוש תוצאות מלאות:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> function showExample(){ govmap.geocode({keyword: 'הרצל', type: govmap.geocodeType.FullResult} ).then(function(response){ console.log(response) }); } </script> </head> <body> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה לחיפוש תוצאה מדויקת:
{ "errorCode": 0, "status": 0, "message": null, "data": [ { "ResultLable": "שכונת הרצל, קריית מלאכי", "ResultType": 1, "ObjectID": "65211087", "ObjectIDType": "number", "ObjectKey": "UNIQ_ID", "DescLayerID": "Neighborhoods_area", "Alert": null, "X": 175353.791038719, "Y": 627181.631375651, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "שכונת הרצל, באר יעקב", "ResultType": 1, "ObjectID": "65210423", "ObjectIDType": "number", "ObjectKey": "UNIQ_ID", "DescLayerID": "Neighborhoods_area", "Alert": null, "X": 184468.154852594, "Y": 650217.361032762, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, מעלות-תרשיחא", "ResultType": 1, "ObjectID": "10630124", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 226589.46, "Y": 769085.01, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: שדרות הרצל, אופקים", "ResultType": 1, "ObjectID": "310107", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 163959, "Y": 580355.61, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, חיפה", "ResultType": 1, "ObjectID": "40000856", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 200327.26, "Y": 745981.26, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: שדרות הרצל, ירושלים", "ResultType": 1, "ObjectID": "30001021", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 217958.36, "Y": 632037.27, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, קריית שמונה", "ResultType": 1, "ObjectID": "28000208", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 253320.83, "Y": 790084.11, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, ראש העין", "ResultType": 1, "ObjectID": "26400165", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 195128.25, "Y": 666788.56, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, קריית אונו", "ResultType": 1, "ObjectID": "26200103", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 186348.76, "Y": 663627.11, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false }, { "ResultLable": "כתובת: רחוב הרצל, בית שמש", "ResultType": 1, "ObjectID": "26100101", "ObjectIDType": "number", "ObjectKey": "STR_ID", "DescLayerID": "STREET_MID_POINT", "Alert": null, "X": 199223.63, "Y": 628536.81, "Gush": null, "Parcel": null, "showLotParcel": false, "showLotAddress": false } ], "active": false }
הדלקה וכיבוי שכבות במפה
פונקציה זו מבצעת הדלקה וכיבוי של שכבות במפה.
הפונקציה מקבלת שני מערכים של שמות שכבות (=כינויי השכבות באנגלית, לפי הגדרות מפ”י): במקום הראשון - מערך שכבות להדלקה, במקום השני - מערך שכבות לכיבוי. ניתן, לבצע מספר לא מוגבל של קריאות עוקבות ולהדליק ולכבות שכבות שונות בהמשך העבודה עם המפה. במקרים בהם הפונקציה מקבלת רק מערך אחד – היא מתייחסת למערך כשמות שכבות להדלקה.
govmap.setVisibleLayers(layersOn, layersOff)
שם | סוג | תיאור |
---|---|---|
layersOn | []string | מערך שכבות להדלקה |
layersOff | []string | מערך שכבות לכיבוי |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.setVisibleLayers(['GASSTATIONS', 'topocad_parcel_all'],[ 'bus_stops']); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
יצירת מפת חום בצד לקוח
פונקציה זו מאפשרת למשתמש להוסיף מפת חום על גבי המפה. הפונקציה מקבלת כפרמטר אובייקט המכיל את הנקודות ליצירת המפה והגדרות נוספות אופציונאליות.
govmap.setHeatLayer(params)
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
points | []objects | מערך של אובייקטים המייצגים נקודה |
options | []string | אובייקט של הגדרות למפת חום. האובייקט חייב להכיל לפחות את הפרמטר valueField ואת ערכו –אחד מה attributes key |
אובייקט ה points:
שם | סוג | תיאור |
---|---|---|
point | object | אובייקט המייצג נקודה עם הproperties: number - x number - y |
attributes | object | אובייקט עם ה properties: number - val1 number - val2 |
הגדרות נוספות שאפשר לשלוח באובייקט ה options
שם | סוג | תיאור |
---|---|---|
backgroundColor | string | צבע רקע בפורמטים: hexcode / שם הצבע / rgb(a) |
gradient | string | אובייקט המייצג את ה gradient ????דוגמה |
radius | number | הגדרת הרדיוס של כל נקודה (במידה ולא הוגדר בנקודה עצמה) |
opacity | number | מייצג את האטימות של כל מפת החום, מקבל ערכים בין 0-1, כאשר ברירת מחדל 0.6. ערך זה דורס את הערכים ב minOpacity/maxOpacity במידה והוגדרו. |
maxOpacity | number | הערך המקסימלי של הערך הגבוה ביותר שבמפת החום. (ערך זה ידרס אם יוגדר opacity). מקבל ערכים בין 0-1. |
minOpacity | number | הערך המינימאלי של הערך הנמוך ביותר שבמפת החום. (ערך זה ידרס אם יוגדר opacity). מקבל ערכים בין 0-1. |
blur | number | גורם הטשטוש שייושם על על ה datapoints. ככל שהערך גבוה יותר ה gradients יהיו ברורים יותר. מקבל ערכים בין 0-1. ערך ברירת מחדל 0.85 |
xField | string | שם ה property בקואורדינטת ה x של הנקודה. ערך ברירת מחדל ‘x’ |
yField | string | שם ה property בקואורדינטת ה y של הנקודה. ערך ברירת מחדל ‘y’ |
valueField | string | ????? |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var params ={ points: [ { point: { x: 100000, y: 200000 }, attributes: { val1: 50, val2: 800 } }, { point: { x: 200000, y: 400000 }, attributes: { val1: 100, val2: 700 } }, { point: { x: 200100, y: 400000 }, attributes: { val1: 200, val2: 600 } }, { point: { x: 200200, y: 400000 }, attributes: { val1: 300, val2: 500 } }, { point: { x: 200300, y: 400000 }, attributes: { val1: 400, val2: 400 } }, { point: { x: 200400, y: 400000 }, attributes: { val1: 500, val2: 300 } }, { point: { x: 200500, y: 400000 }, attributes: { val1: 600, val2: 200 } }, { point: { x: 200600, y: 400000 }, attributes: { val1: 700, val2: 100 } }, { point: { x: 300000, y: 400000 }, attributes: { val1: 800, val2: 50 } } ], options: { valueField: 'val1' } }; govmap.setHeatLayer(params); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
מחיקת מפת חום
פונקציה זו מוחקת מהמפה את מפת החום שנוספה באמצעות שימוש בפונקציה הקודמת.
govmap.removeHeatLayer();
דוגמה למחיקת מפת חום
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); var params ={ points: [ { point: { x: 100000, y: 200000 }, attributes: { val1: 50, val2: 800 } }, { point: { x: 200000, y: 400000 }, attributes: { val1: 100, val2: 700 } }, { point: { x: 200100, y: 400000 }, attributes: { val1: 200, val2: 600 } }, { point: { x: 200200, y: 400000 }, attributes: { val1: 300, val2: 500 } }, { point: { x: 200300, y: 400000 }, attributes: { val1: 400, val2: 400 } }, { point: { x: 200400, y: 400000 }, attributes: { val1: 500, val2: 300 } }, { point: { x: 200500, y: 400000 }, attributes: { val1: 600, val2: 200 } }, { point: { x: 200600, y: 400000 }, attributes: { val1: 700, val2: 100 } }, { point: { x: 300000, y: 400000 }, attributes: { val1: 800, val2: 50 } } ], options: { valueField: 'val1' } }; govmap.setHeatLayer(params); }); function showExample(){ govmap.removeHeatLayer(); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
שינוי שדה חישוב של מפת חום
פונקציה זו מאפשרת שינוי השדה שעליו מתבססים ליצירת מפת החום לאחר הוספת מפת חום על המפה. פונקציה זו מקבלת כפרמטר מחרוזת שם השדה חישוב החדש.
govmap.changeHeatLayerValueField(params);
דוגמה למחיקת מפת חום
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); var params ={ points: [ { point: { x: 100000, y: 200000 }, attributes: { val1: 50, val2: 800 } }, { point: { x: 200000, y: 400000 }, attributes: { val1: 100, val2: 700 } }, { point: { x: 200100, y: 400000 }, attributes: { val1: 200, val2: 600 } }, { point: { x: 200200, y: 400000 }, attributes: { val1: 300, val2: 500 } }, { point: { x: 200300, y: 400000 }, attributes: { val1: 400, val2: 400 } }, { point: { x: 200400, y: 400000 }, attributes: { val1: 500, val2: 300 } }, { point: { x: 200500, y: 400000 }, attributes: { val1: 600, val2: 200 } }, { point: { x: 200600, y: 400000 }, attributes: { val1: 700, val2: 100 } }, { point: { x: 300000, y: 400000 }, attributes: { val1: 800, val2: 50 } } ], options: { valueField: 'val1' } }; govmap.setHeatLayer(params); }); function showExample(){ govmap.changeHeatLayerValueField('val1'); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
קבלת מידע על בסיס מיקום
פונקציה זו מאפשרת קבלת מידע משכבה מסוימת.
המשתמש שולח קואורדינאטות של המיקום הרצוי, שם השכבה ורדיוס ומקבל תשובה של כל הישויות ברדיוס והמרחק בין הקואורדינאטות לישויות שאותרו.
השדות שיופיעו בתשובה הן השדות שיש בבועית מידע.
הפונקציה מקבלת כפרמטר אובייקט המכיל את שם השכבה, נקודה ורדיוס.
govmap.getLayerData(params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
LayerName | string | שם השכבה |
Point | object | אובייקט המייצג נקודה, עם הערכים: number - x number - y |
Radius | number | רדיוס במטרים |
הפונקציה מקבלת כפרמטר אובי אובייקט החוזר בתשובה להוספת נקודה על המפה - Point:
שם | סוג | תיאור |
---|---|---|
response | object | חוזר אובייקט מסוג response, כאשר התשובה מיוצגת כמערך של אובייקטים ב data. |
דוגמה לקבלת מידע על בסיס מיקום:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> function showExample(){ var params = { LayerName: 'bus_stops', Point: {x: 178622, y: 663148}, Radius:30 }; govmap.getLayerData(params).then(function(response){ console.log(response); }); } </script> </head> <body> <button onClick="showExample()">Show Example</button> </body> </html>
תשובה:
{ "errorCode": 0, "status": 0, "message": null, "data": [ { "Fields": [ { "FieldName": "X", "Value": "32.060725" }, { "FieldName": "Y", "Value": "34.771973" }, { "FieldName": "STOP_NAME", "Value": "דרך יפו/נחלת בנימין" }, { "FieldName": "STOP_DESC", "Value": "רחוב:דרך יפו 33 עיר: תל אביב יפו רציף: קומה:" }, { "FieldName": "STOP_ADDRESS", "Value": "" }, { "FieldName": "STOP_CITY", "Value": "" }, { "FieldName": "HOURS_SUNDAY", "Value": "447300705" }, { "FieldName": "HOURS_MONDAY", "Value": "340526204" }, { "FieldName": "HOURS_TUESDAY", "Value": "340526204" }, { "FieldName": "HOURS_WEDNSDAY", "Value": "340526204" }, { "FieldName": "HOURS_THURSDAY", "Value": "260365304" }, { "FieldName": "HOURS_FRIDAY", "Value": "4775191" }, { "FieldName": "HOURS_SATURDAY", "Value": "352321536" }, { "FieldName": "STATIONID", "Value": "13512" }, { "FieldName": "STOP_CODE", "Value": "25405" }, { "FieldName": "AGENCIES", "Value": "" }, { "FieldName": "AGENCIES", "Value": "5" } ], "distance": 14.25 }, { "Fields": [ { "FieldName": "X", "Value": "32.060644" }, { "FieldName": "Y", "Value": "34.771841" }, { "FieldName": "STOP_NAME", "Value": "דרך יפו/נחלת בנימין" }, { "FieldName": "STOP_DESC", "Value": "רחוב:דרך יפו 44 עיר: תל אביב יפו רציף: קומה:" }, { "FieldName": "STOP_ADDRESS", "Value": "" }, { "FieldName": "STOP_CITY", "Value": "" }, { "FieldName": "HOURS_SUNDAY", "Value": "315988268" }, { "FieldName": "HOURS_MONDAY", "Value": "297576504" }, { "FieldName": "HOURS_TUESDAY", "Value": "297576504" }, { "FieldName": "HOURS_WEDNSDAY", "Value": "297576504" }, { "FieldName": "HOURS_THURSDAY", "Value": "226625044" }, { "FieldName": "HOURS_FRIDAY", "Value": "3983828" }, { "FieldName": "HOURS_SATURDAY", "Value": "354418688" }, { "FieldName": "STATIONID", "Value": "13511" }, { "FieldName": "STOP_CODE", "Value": "25403" }, { "FieldName": "AGENCIES", "Value": "" }, { "FieldName": "AGENCIES", "Value": "5" } ], "distance": 28.06 } ], "active": false }
צפייה במפת רקע חיצונית
פונקציה זו מאפשרת למשתמש להגדיר מפת רקע חיצונית ולהוסיף אותה לרשימת מפות הרקע.
הפונקציה מקבלת כפרמטר אובייקט המכיל את ההגדרות של מפת הרקע.
govmap.addCustomBackground(params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
bgName | string | שם מפת הרקע |
bgCaption | string | כותרת המפת רקע שתופיעה ברשימה |
url | string | url של מפת הרקע |
imageFormat | string | פורמט התמונה |
dpi | number | רזלוציה של התמונה |
tileWidth | string | רוחב של tile בפיקסלים |
tileHeight | string | אורך של tile בפיקסלים |
origin | object | {‘x’:, ‘y’:},קואורדינטות של נקודת המקור |
extent | object | :{‘xmin’:,’ymin’:,’xmax’:,’ymax’:,’spatialReference’:{‘wkid’:}} |
lods | []object] | מערך של רמות התנגדות, כל רמה מוגדרת ע”י אובייקט. {‘level’: מספר,resolution :מספר, ‘scale’: מספר} |
smallButtonImage | string | תמונת אייקון קטנה לרשימת מפות רקע |
largeButtonImage | string | תמונת אייקון גדולה לרשימת מפות רקע |
דוגמה לצפייה במפת רקע חיצונית
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var params ={ bgName: 'myBg', bgCaption:'רקע', url: 'map.govmap.gov.il/201015L1O2A3', imageFormat: 'jpg', dpi: 96, tileWidth: 256, tileHeight: 256, lods:[{level:0,resolution:793.751587503175,scale:3000000},{level:1,resolution:264.583862501058,scale:1000000},{level:2,resolution:132.291931250529,scale:500000},{level:3,resolution:66.1459656252646,scale:250000},{level:4,resolution:26.4583862501058,scale:100000},{level:5,resolution:13.2291931250529,scale:50000},{level:6,resolution:6.61459656252646,scale:25000},{level:7,resolution:2.64583862501058,scale:10000},{level:8,resolution:1.32291931250529,scale:5000},{level:9,resolution:0.661459656252646,scale:2500},{level:10,resolution:0.330729828126323,scale:1250}], smallButtonImage: 'http://www.creatingonline.com/webmaster/free_icons/bluegelflowerWB.gif', largeButtonImage: 'http://www.creatingonline.com/webmaster/free_icons/bluegelflowerWB.gif' }; govmap.addCustomBackground(params); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
תצוגת מפות רקע שלא מופיעות באתר הרגיל
פונקציה זו מאפשרת למשתמש מורשה לפתוח מפות רקע שלא מופיעות באתר הרגיל. הפונקציה מקבלת כפרמטר את ה- id של מפת הרקע המבוקשת מספר.
govmap.addAuthorizedBackground(bgId);
שם | סוג | תיאור |
---|---|---|
bgId | number | id של מפת הרקע |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.addAuthorizedBackground(10); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
קבלת מקרא של שכבה באמצעות קוד פתוח
govmap.getLegend(params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה |
colorPreset | string | גרדיינט של צבעים |
breaksNum | number | מספר קבוצות לחלוקת הערכים |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var params ={ layerName: 'tot_pop_area_pol', colorPreset: 'GREEN', breaksNum: 10 } govmap.getLegend(params); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
הצגת שכבות מידע באמצעות קוד פתוח על פי שדה של המשתמש
פונקציה זו מאפשרת הצגת שכבות מידע באמצעות קוד פתוח על גבי מפות הרקע של אתר המפות. כל המידע הדרוש לצביעת השכבה על המפה מועבר באובייקט כפרמטר.
govmap.addOpenSourceLayer(params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה |
rendererType | enum govemap.rendereType | שם שכבה, ערכים: Simple SimplePicture JenksNaturalBreaks EquelInterval Quantile ClassBreaks |
rendererValues | object | שם שכבה |
colorPreset | string | אובייקט המכיל את המזהה של הגאומטריות של השכבה וערך לצביעה |
range | string | מספר הקבוצות לחלוקת ערכי השכבה - בין 1 ל 10 |
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var values = { 1860: 1, 40: 2, 38: 3, 224: 4, 1194: 5, 1467: 6, 306: 7, 307: 8, 369: 9, 562: 10, 579: 11, 2957: 12, 581: 13, 2842: 14, 596: 15, 2958: 16, 2964: 17, 2965: 18, 1566: 19, 608: 20, 640: 21, 648: 22, 2975: 23, 2955: 24, 1253: 25, 1221: 26, 809: 27, 1684: 28, 2591: 29, 845: 30, 847: 31, 848: 32, 1603: 33, 2981: 34, 283: 35, 899: 36, 979: 37, 993: 38, 1104: 39, 3002: 40, 3000: 41, 1256: 42, 1780: 43, 3057: 44, 1275: 45, 1327: 46, 1858: 47, 780: 48, 435: 49, 1949: 50, 1492: 51, 1971: 52, 1812: 53, 138: 54, 1896: 55, 2012: 56, 2025: 57, 2093: 58, 2120: 59, 2137: 60, 2170: 61, 2215: 62, 2232: 63, 2235: 64, 2668: 65, 2693: 66, 500: 67, 2289: 68, 2305: 69, 2312: 70, 2314: 71, 2759: 72, 2250: 73, 2321: 74, 2352: 75, 2354: 76, 2401: 77, 2421: 78, 2441: 79, 2489: 80, 2840: 81, 2501: 82, 2537: 83, 2553: 84, 2585: 85, 790: 86, 2609: 87, 2663: 88, 2739: 89, 2791: 90, 2813: 91, 731: 92, 846: 93, 3055: 94, 2913: 95, 2928: 96, 2942: 97, 680: 98, 2185: 99, 3031: 100, 3034: 101, 3035: 102, 3036: 103, 3052: 104, 1770: 105, 3082: 106, 3083: 107, 3114: 108, 3152: 109, 3159: 110, 1824: 111, 3182: 112, 3186: 113, 3187: 114, 3195: 115, 1136: 116, 1181: 117, 2847: 118, 2444: 119, 1334: 120, 1635: 121, 2935: 3037, 2936: 3038, 2938: 3039, 2940: 3040, 2984: 3041, 2941: 3042, 2945: 3043, 2943: 3044, 2944: 3045, 2946: 3046, 2947: 3047, 2949: 3048, 2950: 3049, 2952: 3050, 2954: 3051, 2960: 3052, 2962: 3053, 2967: 3054, 2969: 3055, 2971: 3056, 2972: 3057, 2983: 3058, 2973: 3059, 2974: 3060, 2976: 3061, 2977: 3062, 2978: 3063, 2979: 3064, 2985: 3065, 2986: 3066, 2989: 3067, 2992: 3068, 2993: 3069, 2994: 3070, 2995: 3071, 2996: 3072, 2997: 3073, 2998: 3074, 2999: 3075, 3001: 3076, 3003: 3077, 3004: 3078, 3007: 3079, 3008: 3080, 3009: 3081, 3011: 3082, 3012: 3083, 3013: 3084, 3014: 3085, 3015: 3086, 3020: 3087, 3022: 3088, 3023: 3089, 3056: 3090, 3024: 3091, 3028: 3092, 3029: 3093, 3030: 3094, 3038: 3095, 3039: 3096, 3040: 3097, 3041: 3098, 3044: 3099, 3045: 3100, 3047: 3101, 3048: 3102, 3049: 3103, 3050: 3104, 2838: 3196, 929: 3197, 1598: 3198, 1043: 3199, 2919: 3200, 1596: 3201, 1188: 3202, 2159: 3203, 2990: 3204,583: 3205, 941: 3206, 2660: 3207, 1705: 3208, 1805: 3209, 2340: 3210, 1062: 3211, 2841: 3212 }; var params={ layerName: 'tot_pop_area_pol', rendererType: govmap.rendererType.JenksNaturalBreaks, rendererValues: values, colorPreset: 'GREEN', range: 10 }; govmap.addOpenSourceLayer(params); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
סינון שכבה
פונקציה זו מבצעת סינון (Definition Query) לשכבה הנבחרת באמצעות תנאי סינון תוך הדלקת השכבה ואפשרות להתמקדות בתחום הישויות שעונות על התנאי.
govmap.filterLayers(Params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה |
whereClause | string | תנאים לסינון |
zoomToExtent | boolean | משתנה בוליאני המסמן אם להתמקד לישויות העונות על התנאי או לא |
לדוגמה סינון שכבת תחנות דלק לפי objectid עם התמקדות ל extent של הישויות שעונות על תנאי הסינון:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ var params ={ layerName: 'GASSTATIONS', whereClause: 'objectid in (782, 783, 784, 785, 786, 787)', zoomToExtent: true } govmap.filterLayers(params); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
סימון ישויות על המפה
פונקציה לשימוש פנימי שמכניסה את המפה למצב של סימון ישויות מהסוג המוגדר. הפונקציה מדליקה את השכבה הרלוונטית, משנה את אייקון העכבר למצב “בחירה”. לחיצה על הישות הרצויה בשכבה תצבע אותה בצבע בולט. בכל לחיצת עכבר (בחירה של ישות) יוחזרו כל ערכי הישויות המסומנות כתשובה לפונקציית .
govmap.selectFeaturesOnMap(Params);
הפונקציה מקבלת את הפרמטרים הבאים:
שם | סוג | תיאור |
---|---|---|
interfaceName | string | סוג הישות לתשאול לפי הגדרת מפ”י |
continous | boolean | משתנה בוליאני להגדרת מצב המשך לאחר סיום ציור : האם להשאיר במצב ציור או לחזור למצב הזזת מפה |
drawType | /enum govmap.drawType geometry object |
סוג הסימון - נקודה קו או פוליגון. ניתן להעביר אובייקט גאומטריה או שניתן להעביר govmap.drawType: Point Polyline Polygon |
אובייקט החוזר בתשובה:
שם | סוג | תיאור |
---|---|---|
data | []object | רשימת הישויות שנחתכו עם הגאומטריה שצויירה או הועברה בקלט |
limited | boolean | מציין האם חזרה תוצאה מלאה או חלקית (קיימת הגבלת מקסימום ל 50 ישויות) |
selection | object | הגדרות לציור תוצאות הסימון על המפה |
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params ={
interfaceName: 'Gush',
continous: false,
drawType: govmap.drawType.Polygon
}
govmap.selectFeaturesOnMap(params.interfaceName,params.drawType,params.continous).then(function(response){
console.log(response);
}
);
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
פונקציה לסגירת בועית פתוחה
פונקציה זו מבצעת סגירה של בועית פתוחה על המפה.
govmap.closeBubble();
קוד לדוגמה:
<html xmlns="http://www.w3.org/1999/xhtml"> <head> <script src="https://code.jquery.com/jquery-1.12.1.min.js"></script> <script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script> <script type="text/javascript"> $(document).ready(function () { govmap.createMap('map', { token: '5a4b8472-b95b-4687-8179-0ccb621c7990', layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"], showXY: true, identifyOnClick: true, isEmbeddedToggle: false, background: 3, layersMode: 1, zoomButtons:false }); }); function showExample(){ govmap.closeBubble(); } </script> </head> <body> <div id="map" style="width:600px;height:600px"></div> <button onClick="showExample()">Show Example</button> </body> </html>
חיפוש ישויות בשכבה לפי שדה וערך
פונקציה זו מבצעת חיפוש לישויות בשכבה המתאימות לערכים המוזנים עבור שדה נתון תוך הדלקת השכבה ואפשרות להבלטת הסימון בצבע ו/או פתיחת בועית מידע.
לאחר החיפוש, הפונקציה מבצעת התמקדות לתוצאות.
govmap.searchInLayer(Params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה לחיפוש |
fieldName | string | מכילה את שם השדה לחיפוש |
fieldValues | []string] | המכיל את הערכים הרצויים לחיפוש |
highlight | boolean | מסמן אם להבליט את הסימון של הישויות או לא |
showBubble | boolean | מסמן אם בועית מידע |
outLineColor | []number | צבע קו להבלטת הישויות |
fillColor | []number | צבע מילוי להבלטת הישויות |
קוד לדוגמה: חיפוש תחנות דלק בשם “הסיירים” ו “מסובים” בשכבת תחנות דלק ללא הבלטה של הישויות על המפה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
layerName: 'GASSTATIONS',
fieldName: 'NAME',
fieldValues: ["הסיירים", "מסובים"],
highlight: false
};
govmap.searchInLayer(params);
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
הצגת ישויות של שכבת משתמש
פונקציה זו מחזירה רשימת יישויות של שכבה מסויימת בהתאם להרשאות המשתמש. הפונקציה מקבלת כפרמטר שם שכבה ולכל יישות מחזירה אובייקט המכיל את המזהה, את הגאומטריה ואת השדות .
govmap.getLayerEntities(Params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה |
קוד לדוגמה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
layerName: '2756',
};
govmap.getLayerEntities(params).then(function(response){
console.log(response);
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תשובה
[ { "Fields": [ { "FieldName": "SHAPE", "Caption": "DONTSHOW", "Value": "POINT ( 200000.48000000 600000.39000000)" }, { "FieldName": "Field1Value", "Caption": "שם", "Value": "אאאא" }, { "FieldName": "Field2Value", "Caption": "תיאור", "Value": "אא" } ], "entityID": "235850" }, { "Fields": [ { "FieldName": "SHAPE", "Caption": "DONTSHOW", "Value": "POINT ( 25000.48000000 650000.39000000)" }, { "FieldName": "Field1Value", "Caption": "שם", "Value": "בבבבבב" }, { "FieldName": "Field2Value", "Caption": "תיאור", "Value": "בב" } ], "entityID": "235851" } } ]
פעולות על ישויות של שכבת משתמש : הוספה, עדכון ומחיקה
פונקציה זו מאפשרת למשתמש לבצע פעולות על שכבה : הוספה מחיקה ועדכון ישויות. סוג הפעולה נקבע בהתאם לפרמטר action – מסוג govmap.saveAction שהפונקציה מקבלת. להפעלת פונקציה זו נדרש token אבטחה נוסף לביצוע פעולות משתמש רשום דרך ה API.
govmap.saveLayerEntities(Params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
action | enum govmap.saveAction | הפעולה המבוקשת: Delete Update New |
layerName | string | שם השכבה |
entities | string | רשימה של ישויות לשכבה, כאשר לכל ישות יש רשימה של שדות [{‘fields’:{}},{‘fields’:{}},{‘fields’:{}}] |
הפונקציה מחזירה רשימה של תוצאות המכילה עבור כל ישות את ה אינדקס במקור, את המזהה, הודעת שגיאה אם ישנה ואת הסטטוס של הפעולה לפי ה enum הבא:
שם | סוג | ערכים |
---|---|---|
saveActionStatus | enum govmap.saveAction | Failed :0 Deleted: 1 Updated: 2 Inserted: 3 |
הוספת ישויות לשכבת משתמש:
הפונקציה מקבלת כפרמטר אובייקט המכיל את הישויות להוספה, שם שכבה וסוג הפעולה:
קוד לדוגמה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var data = {
action: govmap.saveAction.New,
layerName: '2756',
entities: [
{
fields: {
Field2Value: "12",
Field3Value: "1697",
Field4Value: "1699",
Field5Value: "link",
Field6Value: "linklink",
Field8Value: "abcd",
Field1Value: '25/06/2017',
SHAPE: "POINT(196062.48 621458.39)"
}
},
{
fields: {
Field2Value: "1",
Field3Value: "1696",
Field4Value: "1699",
Field5Value: "link",
Field6Value: "linklink",
Field8Value: "abcd",
Field1Value: '25/06/2017',
SHAPE: "POINT(196062.48 600000.39)"
}
}
]
};
govmap.saveLayerEntities(data).then(function (result)
{
console.log(result)
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תשובה להוספת ישויות תקינה:
"data": [ { "status": 3, "entityId": 236001, "index": 0, "message": "" }, { "status": 3, "entityId": 236002, "index": 1, "message": "" } ]
עדכון ישויות של שכבת משתמש:
הפונקציה מקבלת כפרמטר סוג הפעולה, שם שכבה ורשימה של ישויות לעדכון – עבור כל ישות יהיה אובייקט המכיל את המזהה של הישות ושדות לעדכון.
קוד לדוגמה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var data = {
action: govmap.saveAction.Update,
layerName: '2756',
entities: [{
entityID: '235957',
fields: { 'Field2Value': '2'}
}]
};
govmap.saveLayerEntities(data).then(function (result)
{
console.log(result)
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
מחיקת ישויות של שכבת משתמש:
הפונקציה מקבלת כפרמטר את סוג הפולה, שם השכבה ורשימת מזהים של הישויות למחיקה:
קוד לדוגמה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var data = {
action: govmap.saveAction.Delete,
layerName: '2756',
entities: [
{ entityID: '235849' },
{ entityID: '111' }
]
};
govmap.saveLayerEntities(data).then(function (result)
{
console.log(result)
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
דוגמא של אובייקט להוספת ישות לשכבה
פונקציה זו מאפשרת למשתמש לקבל מבנה לדוגמא של ישות בשכבה מסויימת ולדעת אילו שדות השכבה מכילה. המשתמש יוכל להשתמש במידע זה להוספת או עדכון ישויות בשכבה. הפונקציה מקבלת כפרמטר את שם השכבה. במידה והשכבה מכילה שדות מסוג בחירה או בחירה מרובה , בנוסף למבנה הישות יוחזר אובייקט המייצא את כל אופציות לבחירה.
govmap.getAddEntitiesSample(Params);
הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים:
שם | סוג | תיאור |
---|---|---|
layerName | string | שם שכבה |
קוד לדוגמה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://code.jquery.com/jquery-1.12.1.min.js"></script>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js"></script>
<script type="text/javascript">
$(document).ready(function ()
{
govmap.createMap('map',
{
token: '5a4b8472-b95b-4687-8179-0ccb621c7990',
layers: ["GASSTATIONS","PARCEL_HOKS", "KSHTANN_ASSETS", "bus_stops", "PARCEL_ALL"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
});
function showExample(){
var params = {
layerName: '2756',
};
govmap.getAddEntitiesSample(params).then(function(response){
console.log(response);
});
}
</script>
</head>
<body>
<div id="map" style="width:600px;height:600px"></div>
<button onClick="showExample()">Show Example</button>
</body>
</html>
תשובה
{ "layerName": "2756", "entities": [ { "fields": { "Field2Value": "number", "Field3Value": "selectedChoiceID", "Field4Value": "multipleChoiceIdsComaSeparated", "Field5Value": "link", "Field6Value": "pictureLink", "Field8Value": "text", "Field1Value": "date", "SHAPE": "wkt geometry" } } ], "choices": { "Field3Value": { "1696": "black", "1697": "yellow", "1698": "green" }, "Field4Value": { "1699": "aaaaa aaaa", "1700": "xxx xx", "1701": "vvvv", "1702": "nnnn", "1703": "vbnmhjk", "1704": "rrr rr", "1705": "mmmmm", "1706": "www", "1707": "eee eeee", "1708": "yyy yy" } } }
נספח א’ - פרוט שמות השכבות בשרת המפות
להלן פרוט לדוגמה של שמות השכבות. יש לוודא שאין שינוי בשם זה או אחר ומומלץ להסתמך על השם שמוגדר ב- URL בפרמטרים lay ו- ulay בעת שימוש בשתף לאחר הדלקה ידנית של השכבה המבוקשת.
מזהה שכבה | תיאור |
---|---|
milestones | אבני ק”מ |
Sex_Age_Religion | אוכלוסייה-מפקד 2008 |
ilezor | אזורי קרן קיימת לישראל |
POLICE_Yehida_Region | אזורי תחנות משטרה |
f_natural | אזורים טבעיים |
yeshuvim | אזורים מוניציפליים |
statistic_areas | אזורים סטטיסטיים |
atractions | אטרקציות |
cell_active | אנטנות סלולריות |
atikot_sites_itm | אתרי עתיקות |
tayarut | אתרי תיירות בתכנון |
Civil_Labour_Force | בכוח העבודה האזרחי-מפקד 2008 |
Ages65_Plus בני 65 ומעלה-מפקד | 2008 |
Disabilities בעלי מוגבלויות-מפקד | 2008 |
Emergancy_Hospitals | בתי חולים |
hotels | בתי מלון |
LOCALITY_VAAD0410 | גבולות וועדי ישובים |
LOCALITY_210410 | גבולות ישובים |
SUB_GUSH_ALL | גושים |
index_taba_gzr_m | גזר - אינדקס תב”ע |
ganim_leumim | גנים לאומיים |
Housing | דיור-מפקד 2008 |
HOF_NAKI_update | הניקיון בחוף |
Education | השכלה-מפקד 2008 |
mitchmim_mshbsh | התחדשות עירונית |
PetroleumRights | זכויות נפט |
Soil_types | חבורות קרקע |
scenery_units | חטיבות נוף |
PARCEL_ALL | חלקות |
parcel_all | חלקות |
ilPublicSites_June05 | חניונים ואתרים של קק”ל |
d170308_teva | טבע עירוני |
Mean_Temperature_Anual | טמפרטורה שנתית ממוצעת |
ilforest | יער נטע אדם |
winery | יקבים |
LOCALITY | ישובים |
Chambers | לשכות משרד הבריאות |
PURIFIED_DRAINAGE_PONDS | מאגרי קולחין |
retzefMigrashim | מגרשי תב”ע - ממ”י |
migrashim_msbs | מגרשים - משרד הבינוי והשיכון |
MOSDOT_griatric | מוסדות גריאטריים |
MUNICIPALY | מועצות אזוריות |
Moatzot | מועצות דתיות |
Origin | מוצא-מפקד 2008 |
Durable_Goods | מוצרים בני קיימא-מפקד 2008 |
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 | מסלולי נסיעה תחבורה ציבורית |
Employee_Jobs | מעמד בעבודה-מפקד 2008 |
POLICE_Mahoz_Location | מפקדות מחוזות משטרה |
POLICE_Merhav_Location | מפקדות מרחבי משטרה |
t413 | מפת תקן בניה לרעידות אדמה 413 |
SHEET100 | מפתח מפות 100,000 |
SHEET25 | מפתח מפות 25,000 |
SHEET50 | מפתח מפות 50,000 |
Mikve | מקוואות |
ilmerhav | מרחבי קרן קיימת לישראל |
POLICE_Merhav_Region | מרחבים של משטרה |
moe_pikadon | מרכזי החזרת פיקדונות לבקבוקים |
Occupations | משלחי יד-מפקד 2008 |
Households | משקי בית-מפקד 2008 |
ilkkloff | משרדי קרן קיימת לישראל |
sport | מתקני ספורט |
trans_poi | מתקני רישוי נהיגה |
Marrige_Birth | נישואין וילודה-מפקד 2008 |
elect_regions | נפות חברת חשמל |
health_counties | נפות משרד הבריאות |
COUNTY | נפות משרד הפנים |
ilkklfiretr | נקודות תצפית לגילוי שרפות |
btl | סניפי ביטוח לאומי- חלקי |
banks | סניפי בנקים- חלקי |
Soil_survey | סקר קרקעות |
ilstnd | עומדי יער |
yeshuvim_b_pnim | עיר ללא אלימות |
Industries | ענפי תעסוקה-מפקד 2008 |
atudot_mmi | עתודות קרקע - ממ”י |
RECTIFY_P | צווי הכרזה מסילות ברזל |
zimmer | צימרים |
density1967 | צפיפות אוכלוסייה 1967 |
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 | שעות עבודה ותחבורה-מפקד 2008 |
retzefGvulot | תב”ע - מנהל מקרקעי ישראל |
taba_msbs_itm | תב”ע - משרד הבינוי והשיכון |
ilregion | תחומי יער של קרן קיימת לישראל |
GPS_stations | תחנות GPS |
Stops | תחנות אוטובוס |
bus_stops | תחנות אוטובוס - תחבורה |
GASSTATIONS | תחנות דלק |
Health_care_baby_stations | תחנות טיפת חלב |
FIRE_STATIONS | תחנות כיבוי אש |
MADA_STATIONS | תחנות מגן דוד אדום |
POLICE_Yehida_Location | תחנות משטרה |
BlueLines_Tamatamam | תיחומי תמ”א תמ”מ |
d180308_tarbut | תרבות אורבאנית |
beit_shean_7_5 | תרחיש רעידת אדמה במוקד בית שאן |
נספח ב’ - פרוט שמות המשתנים מסוג enum
events: {
PAN: 0,
EXTENT_CHANGE: 1,
CLICK: 3,
DOUBLE_CLICK: 4,
MOUSE_MOVE: 5,
MOUSE_OVER: 8
},
internalClickEvents: {
GET_XY_CLICK: 10
},
locateType: {
addressToLotParcel: 1,
lotParcelToAddress: 0
},
cursorType: {
DEFAULT: 0,
TARGET: 1,
POLYGON: 3,
CIRCLE: 4,
RECTANGLE: 5,
SELECT_FEATURES: 6
},
geometryType: {
POINT:0,
POLYLINE:1,
POLYGON:2,
LINE:3,
CIRCLE:4
},
drawType: {
Point: 0,
Polyline: 1,
Polygon: 2,
Circle: 3,
Rectangle: 4,
FreehandPolygon:6
},
rendererType: {
Simple: 0,
SimplePicture: 1,
JenksNaturalBreaks: 2,
EqualInterval: 3,
Quantile: 4,
ClassBreaks: 5
},
geocodeType: {
FullResult: 0,
AccuracyOnly: 1
},
saveAction:{
Delete:1,
Update:2,
New:3
},
saveActionStatus:{
Failed:0,
Deleted:1,
Updated:2,
Inserted:3
},