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

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

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

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

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

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

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

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

סינון לפי סוג

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

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