קבלת גאומטריה של ישויות לפי מזהה

פונקציה זו מאפשרת לקבל את הגאומטריה של ישויות ספציפיות בשכבת משתמש, לפי מזהי הישויות (objectId).
שימושית כאשר כבר קיימים מזהי ישויות מתשאול קודם (למשל מ־intersectFeatures או getLayerData) ונדרשת הגאומטריה המרחבית שלהן.

כדי שהפונקציה תחזיר גאומטריה, יש לחשוף אותה מראש. ברירת המחדל היא הסתרת הגאומטריה.

אופן השימוש: אפשרויות משתמש ← ניהול API ← שכבות מידע לצפייה. בשכבה הרצויה יש לחשוף את הגאומטריה, או להסתיר אותה.

דגש

במידה והשכבה משותפת, חשיפת הגיאומטריות תהיה בהתאם להרשאות הצפייה של המשתמש.

govmap.getEntitiesGeometry(payload);

הפונקציה מקבלת כפרמטר אובייקט המכיל את ה-properties הבאים

שם	סוג	תיאור
layerId	string	שם (מזהה) השכבה.
objectIds	Array<string | number>	מערך מזהי הישויות לקבלת הגאומטריה שלהן.
projection	govmap.aggSrid (ראה נספח ב')	רשות. מערכת קואורדינטות לתוצאה. ברירת מחדל: ITM / רשת ישראל החדשה (EPSG:2039)

מבנה התשובה

התשובה היא אובייקט GeoJSON מסוג FeatureCollection. לכל יישות מוחזרת גאומטריה ושדה objectid ב־properties.

{
  type: 'FeatureCollection',
  features: [
    {
      type: 'Feature',
      properties: { objectid: number | string },
      geometry: {
        type: 'Point|Polygon|...',
        coordinates: [...],
        crs: {
          type: 'name',
          properties: { name: 'EPSG:XXXX' }
        }
      }
    }
  ]
}

דוגמה

<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: ['myLayer'],
                showXY: true,
                identifyOnClick: true,
                isEmbeddedToggle: false,
                background: '1',
                layersMode: 1,
                zoomButtons: false
            });
        }
        function showExample() {
            govmap.getEntitiesGeometry({
                layerId: 'myLayer',
                objectIds: ['1']
            }).then(function (result) {
                console.log(result.features);
            });
        }
   </script>
 </head>
 <body>
    <div id="map" style="width:600px;height:600px;"></div>
    <button onClick="showExample()">Show Example</button>
 </body>
</html>

תשובה:

showExample: {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "objectid": 1
        },
        "geometry": {
          "type": "MultiPolygon",
          "crs": {
            "type": "name",
            "properties": {
              "name": "EPSG:2039"
            }
          },
          "coordinates": [
            [
              [
                [
                  179247.29,
                  663730.01
                ],
                [
                  179180.09,
                  663643.57
                ],
                [
                  179099.1,
                  663660.02
                ],
                [
                  179156.11,
                  663728.36
                ],
                [
                  179247.29,
                  663730.01
                ]
              ]
            ]
          ]
        }
      }
    ]
  }