סימון ישויות על המפה
פונקציה לשימוש פנימי שמתשאלת את המפה על ישויות מהסוג המוגדר.
הערה
פונקציה זו תעבוד על שכבות להן למשתמש יש הרשאה.
govmap.selectFeaturesOnMap(Params);
פרמטרים
הפונקציה מקבלת את הפרמטרים הבאים:
שם | סוג | תיאור |
---|---|---|
continous | boolean | משתנה בוליאני להגדרת מצב המשך לאחר סיום ציור: האם להשאר במצב ציור ולשלוח בקשות נוספות או לחזור למצב הזזת מפה |
drawType | enum govmap.drawType | אופציונאלי. סוג הסימון, במידה ויועבר גם פרמטר wkt, הפונקציה תתעלם מפרמטר זה (drawType) |
filterLayer | boolean | הצגת יישויות העונות על התנאי בלבד |
getWkt | boolean | האם להוסיף לתשובה את שדות wkt, אורך ושטח (במטרים) |
layers | string[] | שם השכבה לתשאול לפי הגדרת מפ”י, לכל היותר אפשר לתשאל 50 שכבות. במידה ותהיה חריגה מהכמות, הפונקציה תתייחס רק ל-50 הראשונות |
returnFields | Record<string, string[]> | שמות השדות אותם המשתמש מעוניין לקבל בחזרה בעבור כל שכבה. במידה ולא יסופקו שום שדות, לא תתקבל תשובה. שדה זה תלוי רישיות (יש הבדל בין אותיות גדולות וקטנות) |
selectOnMap | boolean | סימון הישויות העונות על התנאי |
whereClause | { [key: string]: string } | שאילתא בעבור כל שכבה - כל תנאי צריך להיו מוקף בסוגריים. אפשר לשלב תנאים מרובים באמצעות פקודת OR או AND. המפתחות צריכים להיות זהים לפרמטר layers. התנאים צריכים להיות עטופים בגרשיים כפולים כדי שניתן יהיה לעטוף בגרש ערכים בתוך השאילתא |
wkt | string | אופציונאלי. קואורדינטות הנקודה כמחרוזת wkt |
zoomToExtent | boolean | משתנה בוליאני המסמן אם להתמקד לישויות העונות על התנאי או לא |
הערות:
- קיימת מגבלה של 5 שכבות לתשאול ועד 50 תוצאות לשכבה.
- כל שמות השכבות בפרמטרים צריכים להיות זהים זה לזה ובאותן אותיות רישיות.
תשובה
מערך מקונן של אובייקטים החוזר בתשובה, בהתאם לסדר של פרמטר שכבות (layers).
דוגמה
בקשה
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<script src="https://www.govmap.gov.il/govmap/api/govmap.api.js" defer onload="initGovMap()"></script>
<script type="text/javascript">
function initGovMap() {
govmap.createMap('map', {
token: 'YOUR_API_TOKEN',
layers: ["GASSTATIONS"],
showXY: true,
identifyOnClick: true,
isEmbeddedToggle: false,
background: 3,
layersMode: 1,
zoomButtons:false
});
}
function showExample(){
var params = {
continous: false,
drawType: govmap.drawType.Polygon,
filterLayer: false,
isZoomToExtent: true,
layers: ['GASSTATIONS'],
returnFields: {
'GASSTATIONS': ['objectid','company']},
selectOnMap: true,
whereClause: {
'GASSTATIONS': "(name = 'רשף')"
},
}
govmap.selectFeaturesOnMap(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>
תשובה
[
[
{
"company": "פז",
"objectid": 113
}
]
]