פונקציות חיפוש מתקדמות
לשימוש בפונקציות, יש לייבא את קובץ ה-API מהכתובת:
https://www.govmap.gov.il/govmap/api/govmap.api.js
הערה
השימוש בפונקציות אינו מחייב יצירת מפה, אך מחייב שליחת מפתח API תקף, מהדומיין המאושר, בכל קריאה לצורך אימות והרשאות.
פונקציות מנוע חיפוש – search, getSearchResultData
הגדרת מנוע חיפוש ב-API של GovMap מתבססת על שימוש בשתי פונקציות מרכזיות:
- search
מבצעת חיפוש לפי מחרוז ת טקסט ומחזירה רשימת תוצאות רלוונטיות. פונקציה זו מיועדת למימוש רכיבי ההשלמה האוטומאטית (autocomplete). - getSearchResultData
מקבלת תוצאת חיפוש שהוחזרה מ- govmap.search ומחזירה מידע מפורט אודות הישות שנבחרה.
הערה
השימוש בפונקציה getSearchResultData מותנה בקבלת תשובה מהפונקציה search.
טיפול בשגיאות
שתי הפונקציות מדפיסות שגיאות לקונסול. מומלץ לעטוף את הקריאות ב־try-catch ולטפל בשגיאות בצורה יזומה.