הפונקציה PLACES_COUNT_PER_TYPE

הפונקציה PLACES_COUNT_PER_TYPE מחזירה טבלה של ספירות לכל סוג של מקום שצוין בפונקציה. לדוגמה, אם מחפשים את הסוגים doctor, hospital ו-pharmacy, התגובה מכילה טבלה עם שורה נפרדת לכל סוג.

הפונקציה PLACES_COUNT_PER_TYPE מחזירה טבלה, ולכן צריך לקרוא לה באמצעות פסקה FROM.

  • פרמטרים של קלט:

    • חובה: geography פרמטר הסינון שמציין את אזור החיפוש. הפרמטר geography מקבל ערך שמוגדר על ידי סוג הנתונים GEOGRAPHY של BigQuery, שתומך בנקודות, בקווי שבר ובמצולעים.

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

    • חובה: types פרמטר הסינון שמציין את סוגי המקומות שרוצים לחפש.

    • אופציונלי: פרמטרים נוספים של מסנן לחידוד החיפוש.

  • החזרות:

    • טבלה עם שורה אחת לכל ערך של types. הטבלה מכילה את העמודות type (STRING), ‏ count (INT64) ו-place_ids (ARRAY<STRING>), כאשר place_ids מכילה עד 250 מזהי מקומות לכל type.

דוגמה: החזרת מספר המסעדות, בתי הקפה והברים

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

הפרמטר types מקבל מערך של ערכי STRING שמציינים את סוגי המקומות שצריך לחפש. רשימה מלאה של הערכים האפשריים מופיעה במאמר בנושא סוגי מקומות.

בדוגמה הזו נעשה שימוש גם בפונקציה BigQuery ST_GEOGFROMTEXT כדי להחזיר ערך GEOGRAPHY ממצולע.

DECLARE geo GEOGRAPHY;
SET geo = ST_GEOGFROMTEXT('''POLYGON((-73.985708 40.75773,-73.993324 40.750298,
                                      -73.9857 40.7484,-73.9785 40.7575,
                                      -73.985708 40.75773))''');  -- NYC viewport

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_TYPE`(
  JSON_OBJECT(
      'types', ["restaurant", "cafe", "bar"],
      'geography', geo,
      'business_status', ['OPERATIONAL']
      )
);

הפונקציה מחזירה טבלה עם שלוש שורות, אחת לכל סוג:

תוצאות של הפונקציה Place Count Type בעיר ניו יורק.