הפונקציה PLACES_COUNT_PER_H3

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

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

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

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

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

  • חובה: h3_resolution פרמטר המסנן שמציין את רזולוציית H3 שמשמשת לצבירת ספירת המקומות בכל תא H3. הערכים הנתמכים הם 0 עד 8.

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

• החזרות:

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

דוגמה: ספירת חנויות נוחות וחנויות מכולת עם נגישות לכיסאות גלגלים בכל תא H3

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

בדוגמה הזו נעשה שימוש בנתוני Overture Maps, מערך נתונים ציבורי של BigQuery, כדי לקבל את הנתונים הגיאוגרפיים של ניו יורק.

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

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND names.primary = 'City of New York'  LIMIT 1);

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

התגובה של הפונקציה:

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

בתמונות הבאות אפשר לראות את הנתונים האלה מוצגים ב-Looker Studio כמפה עם מילוי. ככל שהתא H3 כהה יותר, כך ריכוז התוצאות גבוה יותר:

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

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

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

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

   

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

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

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

   

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

מידע נוסף ודוגמה להדמיה של תוצאות התובנות על מקומות זמינים במאמר בנושא הדמיה של תוצאות שאילתות.