דלג לתוכן הראשי

מנוע חיפוש

פונקציה זו מבצעת חיפוש מילולי עם מנגנון השהיה (debounce) על שכבות ומקורות נתונים שונים.

govmap.search(params);

פרמטרים

כל הפרמטרים מועברים בתוך אובייקט אחד.

שםסוגהאם חובה?תיאור
apiKeystringכןמפתח אימות ל-API
searchTextstringכןמלל לחיפוש
language'he' | 'en'לאשפת החיפוש
maxResultsnumberלאמספר מרבי של תוצאות
isAccuratebooleanלאהפעלת חיפוש מדויק
layers[]stringלאשכבות\Datatypes לחיפוש ממוקד.
צריך להגדיר את מנוע החיפוש בטרם השימוש, נא להתייחס להערות מטה.

חיפוש במידע הציבורי של GovMap

ניתן לבצע חיפוש על כלל המידע הציבורי הזמין במנוע החיפוש של אתר ללא צורך בהגדרות נוספות באזור האישי של GovMap.

הגדרת מנוע חיפוש מותאם אישית

הגדרת מנוע חיפוש המשלב Datatypes מסוימים ו/או שכבות משתמש מתבצעת דרך האזור האישי באתר GovMap והעברת השכבות בפרמטר layers.

שלבים עיקריים
  1. אפשרויות משתמש ← ניהול API
  2. בחירה בהגדרת מנוע החיפוש
  3. הוספת שכבות למסך ההגדרה
הוספת שכבות משתמש לחיפוש
  1. בעץ השכבות, לחיצה על תפריט שלוש הנקודות של השכבה
  2. בחירה באפשרויות מתקדמות ← הגדרת חיפוש בשכבה
  3. הפעלת החיפוש באמצעות מתג (כפתור החלפה) הגדרת שדות לחיפוש ואופן הצגת התוצאה
הגדרת שם שכבת משתמש

צריך להשתמש בשם חלופי לשכבה (alias) או במספר מזהה השכבה.

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

בעתיד, אולי, לא יהיה צורך להגדיר את השדה layers באזור האישי בעבור Datatypes.


סוגי מידע (Datatypes) אשר נתמכים בחיפוש

ראה נספח מנוע חיפוש.


מבנה התשובה

    {   
aggregations: Array<{ // פילוח כמותי של התוצאות לפי קטגוריות
key: string;
count: number;
}>,
results: Array<SearchData>,
resultsCount: number, // סך כל התוצאות שנמצאו

}

מבנה SearchData – קישור לנספח מנוע חיפוש.

קוד לדוגמה

חיפוש "דרך מצדה 6 באר שבע" בכל השכבות הזמינות

    var params = {
searchText: "דרך מצדה 6 באר שבע",
language: 'he'
maxResults: 2,
isAccurate: true,
apiKey: 'YOUR_API_TOKEN',
};
govmap.search(params).then(function (response) {
console.log(response);
});;

תשובה לדוגמה

    {
"resultsCount": 2,
"results": [
{
"id": "address|ADDR|460875",
"text": "דרך מצדה 6 באר שבע",
"type": "address",
"score": 5601.008,
"shape": "POINT(3873431.8377494738 3666397.76732087)",
"data": {}
},
{
"id": "address|ADDR|460874",
"text": "דרך מצדה 6 א באר שבע",
"type": "address",
"score": 3170.945,
"shape": "POINT(3873486.685450735 3666450.7990845633)",
"data": {}
}
],
"aggregations": [
{
"key": "address",
"count": 2
}
]
}