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

פונקציות חיפוש מתקדמות

לשימוש בפונקציות, יש לייבא את קובץ ה-API מהכתובת:

https://www.govmap.gov.il/govmap/api/govmap.api.js
הערה

השימוש בפונקציות אינו מחייב יצירת מפה, אך מחייב שליחת מפתח API תקף, מהדומיין המאושר, בכל קריאה לצורך אימות והרשאות.

פונקציות מנוע חיפוש – search, getSearchResultData

הגדרת מנוע חיפוש ב-API של GovMap מתבססת על שימוש בשתי פונקציות מרכזיות:

  1. search
    מבצעת חיפוש לפי מחרוזת טקסט ומחזירה רשימת תוצאות רלוונטיות. פונקציה זו מיועדת למימוש רכיבי ההשלמה האוטומאטית (autocomplete).
  2. getSearchResultData
    מקבלת תוצאת חיפוש שהוחזרה מ- govmap.search ומחזירה מידע מפורט אודות הישות שנבחרה.
הערה

השימוש בפונקציה getSearchResultData מותנה בקבלת תשובה מהפונקציה search.

טיפול בשגיאות

שתי הפונקציות מדפיסות שגיאות לקונסול. מומלץ לעטוף את הקריאות ב־try-catch ולטפל בשגיאות בצורה יזומה.