הפונקציה PLACES_COUNT_PER_GEO

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

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

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

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

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

• החזרות:

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

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

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

בדוגמה הזו משתמשים במערך הנתונים הציבורי של BigQuery,‏ United States Census Bureau Data, כדי לקבל את הגבולות של שלושת המחוזות בעיר ניו יורק: "Queens"‏,"Kings" ו-"New York". הגבולות של כל מחוז נמצאים בעמודה county_geom.

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

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

דוגמה: חישוב ספירות לכל מחוז, מסוננות לפי מותג

בדוגמה הבאה, המסנן brand_ids משמש לאחזור מספר המקומות ומזהי המקומות לדוגמה של מותגים ספציפיים, כמו סטארבקס "1413758728321880760":

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

הצגה חזותית של התוצאות

בתמונות הבאות מוצגים הנתונים האלה ב-Looker Studio כמפה מלאה, כולל קווי המתאר של כל מחוז:

כדי לייבא את הנתונים ל-Looker Studio:

1. מריצים את הפונקציה שלמעלה כדי ליצור את התוצאות.

2. בתוצאות של BigQuery, לוחצים על Open in -> Looker Studio. התוצאות מיובאות באופן אוטומטי ל-Looker Studio.

3. ‫Looker Studio יוצר דף דוח כברירת מחדל ומאתחל אותו עם כותרת, טבלה ותרשים עמודות של התוצאות.

   

4. בוחרים את כל התוכן בדף ומוחקים אותו.

5. לוחצים על הוספה -> מפה עם מילוי כדי להוסיף מפה עם מילוי לדוח.

6. בקטע סוגי תרשימים -> הגדרה, מגדירים את השדות כמו שמוצג בהמשך:

   

7. המפה המלאה מוצגת כמו בתמונה שלמעלה. אפשר גם לבחור באפשרות Chart types -> Styles כדי להגדיר את המראה של המפה.

כאן תוכלו לקרוא מידע נוסף ולראות דוגמה להמחשה חזותית של תוצאות השאילתות ב-Places Insights.