ניתוח מרחבי

קבלת מידע מרחבי ממוקד, באמצעות שליחת קוארדינטות וביצוע חיתוך מול שכבות מידע של האתר ושכבות מידע של המשתמש.

govmap.getLayerFeaturesByLocation(params, apiToken);

פרמטרים

שם	סוג	תיאור
data	object	ApiGetLayerFeaturesByLocation
apiToken	string	מפתח אימות ל-API

ApiGetLayerFeaturesByLocation:

שם	סוג	תיאור
geometry	string	רשות, גיאומטריה של האזור המבוקש בפורמט WKT
address	string	רשות, במידה ויסופק גם הפרמטר geometry הפונקציה תשתמש בו. כתובת לחיפוש, מומלץ לספק כתובת מלאה כולל מספר, כניסה ושם יישוב. לשם שימוש בפרמטר זה, יש להפעיל את שכבת 'כתובות' בניהול מנוע החיפוש באמצעות API בממשק ניהול API
radius	number	רשות, ברירת מחדל: 0 רדיוס החיפוש (Tolerance), במטרים, סביב הגיאומטריה. הערך חייב להיות קטן או שווה ל־3,000.
layers	[]{ []name: string, fields: string }	שמות או מספרי המזהה של השכבות

עצה לשימוש נכון ב-address

בעת שימוש בפרמטר address, מומלץ לציין גם רדיוס (radius), מאחר שהחיפוש לפי כתובת מתבצע סביב נקודת הצנטרואיד של הכתובת, וייתכן שאף יישות לא תחפוף (intersect) נקודה זו.

רכיב בפיתוח שעלול להשתנות בגרסאות הבאות

בעתיד, הגדרת שכבת 'כתובות' בממשק ניהול מנוע החיפוש ככל הנראה לא תדרש.

דוגמה לבקשה

     const payload = {
      geometry: 'POINT(179614.81 663968.73)',
      radius: 100,
      layers: [
        {
          name: 'gasstations',
          fields: ['name', 'company'],
        }
      ],
    };
    govmap.getLayerFeaturesByLocation(payload, 'apiToken').then((r)=>{console.log(r)});

דוגמה לתשובה

    {
        "location": {
            "input": {
                "geometry": "POINT(179614.81 663968.73)"
            },
            "radius": 100
        },
        "layers": {
            "gasstations": [
                {
                    "attributes": {
                        "name": "רשף",
                        "company": "פז"
                    },
                    "id": "3",
                    "idFieldName": "objectid"
                }
            ]
        }
    }