מידע נוסף על מסנני סוגים

ב-Places Aggregate API, type filter עוזר לכם למקד את החיפוש על ידי בחירה של סוגי המקומות שרוצים לכלול בתגובה או להשמיט ממנה. אתם יכולים ליצור רשימות של סוגים שאתם רוצים וסוגים שאתם לא רוצים, גם לגבי הקטגוריה הראשית של מקום וגם לגבי הפרטים האחרים שלו. כך תוכלו ליצור חיפושים ספציפיים כדי למצוא בדיוק את המקומות שאתם מחפשים.

יש יותר מ-200 סוגים של מקומות. רשימה מלאה של סוגי המקומות שנתמכים על ידי Places Aggregate API מופיעה בטבלה א' בקטע סוגי מקומות ב-Places API (חדש).

איך פועלים סוגי המקומות

למקום יכולים להיות כמה סוגים:

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

  • למקום יכולים להיות סוגים משניים אחד או יותר. סוגים משניים הם קטגוריות נוספות שרלוונטיות למקום מסוים, ומספקות מידע נוסף על המאפיינים והשירותים של המקום.

לדוגמה, מקום יכול לציין את הסוג הראשי שלו כ-restaurant, אבל מכיוון שהוא משמש גם כבר ומספק שירותי הסעדה, הוא יכול לציין גם את הסוגים המשניים שלו כמסעדה (bar, food) וכבר (establishment).

סינון לפי סוג

כדי לסנן מקומות לפי סוג ראשי, משתמשים בפרמטרים includedPrimaryTypes ו-excludedPrimaryTypes בבקשה. המסנן חל רק על הסוג הראשי של המקום. לדוגמה, מסנן includedPrimaryTypes של restaurant מחזיר רק מקומות שמתפקדים בעיקר כמסעדות.

כדי לסנן מקומות לפי הסוגים הראשי והמשני, משתמשים בפרמטרים includedTypes ו-excludedTypes בבקשה. המסנן חל על שני הסוגים. לדוגמה, אם מציינים includedTypes של bar, המערכת מחזירה מקומות שבהם bar הוא אחד מהסוגים הראשיים או המשניים.