מידע על נתונים ושאילתות ב-Places Insights

נתונים של מדדים במקומות

‫Places Insights מספק מערכי נתונים מלאים ומערכי נתונים לדוגמה ב-BigQuery.

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

הדוגמה של כרטיס המוצר כוללת את הנתונים של עיר מובילה בכל אחת מהמדינות הנתמכות: סידני (אוסטרליה), סאו פאולו (ברזיל), טורונטו (קנדה), ציריך (שווייץ), ברלין (גרמניה), מדריד (ספרד), פריז (צרפת), לונדון (בריטניה), ג'קרטה (אינדונזיה), מומבאי (הודו), רומא (איטליה), טוקיו (יפן), מקסיקו סיטי (מקסיקו) וניו יורק (ארה"ב).

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

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

סכימות של מערכי נתונים

סכימת מערך הנתונים של המקומות בכל מדינה מורכבת משני חלקים:

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

לדוגמה, אם אתם עובדים עם מערך הנתונים של ספרד (ES), צריך להפנות גם לסכימת הליבה וגם לסכימה הספציפית ל-ES.

הסכימה של מערך הנתונים brands מגדירה שלושה שדות:

‫id: מזהה המותג.
‫name: שם המותג, כמו 'Hertz' או 'Chase'.
‫category: הקטגוריה ברמה הגבוהה של המותג, כמו Gas Station (תחנת דלק), Food and Drink (מזון ומשקאות) או Lodging (לינה).

שאילתת נתונים של תובנות לגבי מקומות

ב-Places Insights יש שתי דרכים לשאילתות על מערכי הנתונים:

שליחת שאילתות ישירות למערך הנתונים באמצעות SQL: אפשר להריץ שאילתות SQL סטנדרטיות של BigQuery על הטבלאות במערך הנתונים. האפשרות הזו מספקת את הגמישות הגדולה ביותר לסינון מורכב, לצירוף לנתונים שלכם, לניתוח בהתאמה אישית ולתמיכה בפונקציות צבירה נוספות מעבר ל-COUNT, כמו AVG,‏ SUM ו-GROUP BY. לעיון במאמרי העזרה
הרצת שאילתות במערך הנתונים באמצעות פונקציות של ספירת מקומות: פונקציות של ספירת מקומות הן שאילתות SQL מוגדרות מראש ומותאמות, שמופעלות ישירות ב-BigQuery ומפשטות משימות נפוצות של אחזור נתונים. הם מספקים תובנות מפורטות יותר, כמו מזהי מקומות חוזרים שאפשר לחפש באמצעותם פרטים על מקומות ספציפיים. לעיון במאמרי העזרה

שאילתות ישירות

כשמריצים שאילתות על הנתונים ישירות, סף הצבירה נאכף. תוצאה מוחזרת רק אם השאילתה מצבירה לפחות 5 מקומות. לדוגמה, אם קריטריוני החיפוש שלכם מניבים תוצאה של 0, 1, 2, 3 או 4, התוצאה לא תיכלל בתשובה. לדוגמה, שאילתה לגבי המספר הכולל של מסעדות באזור מסוים תחזיר תשובה רק אם המספר הכולל הוא 5 או יותר, אחרת לא תחזור תשובה.

שאילתות של פונקציית Places Count

פונקציות של ספירת מקומות יכולות להחזיר רשימה של מזהי מקומות, שאפשר להשתמש בהם כדי לחפש מידע על מקום מסוים באמצעות מוצרים אחרים של GMP, כמו Places API ו-Places UI Kit.

פונקציות של ספירת מקומות לא אוכפות סף צבירה, אלא אוכפות אזור חיפוש מינימלי של 40.0 מטרים על 40.0 מטרים (1,600 מ'²). המשמעות היא שכל עוד שאילתת החיפוש גדולה יותר מאזור החיפוש המינימלי, תמיד תקבלו תוצאה, גם אם אין מקומות שתואמים לשאילתה.

מתי כדאי לשלוח שאילתה ישירות לנתונים ומתי כדאי להשתמש בפונקציות

אם לא צריך מספרים נמוכים של תוצאות, אם רוצים לקבל תובנות מעבר למספרים, כמו AVG, SUM או COUNTIF, או אם צריך לבצע שאילתות מורכבות יותר כמו צירוף של מערכי נתונים, אפשר להריץ שאילתות ישירות על הנתונים.

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

בטבלה הבאה מפורטת השוואה בין ההבדלים בין שאילתות ישירות לבין פונקציות של ספירת מקומות.

	פונקציות לספירת מקומות	שאילתות ישירות במערך נתונים
יתרונות	הפונקציה מחזירה מזהי מקומות שאפשר להשתמש בהם כדי לשלוח שאילתות לממשקי API אחרים. יכול להחזיר כל מספר. אופטימיזציה לביצועים ולעלות עיבוד נמוכה. קל לשימוש. אין צורך לכתוב שאילתות מורכבות. הפונקציה מאמתת את פרמטרי הקלט ומחזירה שגיאה, וכך קל יותר להשתמש בה ולנפות באגים.	אפשר להשתמש בשאילתות מורכבות כמו סינון מתקדם וצירופים. לא נאכף אזור חיפוש מינימלי. תמיכה בפונקציות צבירה נוספות מעבר ל-`COUNT`, כמו `AVG`, ‏ `SUM` ו-`GROUP BY`.
ממשק	ארבע פונקציות SQL מוגדרות מראש שמפיקות תובנות: ספירה יחידה, ספירה לפי סוג, ספירה לפי מיקום גיאוגרפי וספירה לפי תא H3.`COUNT` הפונקציה `JSON_OBJECT` מעבירה ארגומנטים לפונקציה.	אפשר לכתוב פקודות SQL משלכם כדי להריץ פונקציות צבירה כמו `COUNT`,‏ `COUNT_IF`,‏ `SUM` ו-`AVG.`. אפשר ליצור תובנות נוספות באמצעות `JOIN`,‏ `GROUP BY`,‏ `WHERE` ועוד.
הגבלות	^{מגדיר אזור חיפוש מינימלי של 40.0 מטר על 40.0 מטר (1,600 מ"ר).} פונקציה מחזירה תוצאה גם אם ספירת הצבירה קטנה מ-5, כל עוד מתקיים התנאי של אזור החיפוש המינימלי.	תוצאות עם מספרים שקטנים מ-5 מושמטות מהתוצאות (כלומר, השורה לא נכללת).
מסנני מאפיינים נתמכים	פרמטרים של מסננים בפונקציה Places Count תומכים באותם מסננים כמו מסנני מאפיינים של שאילתות ישירות, למעט: מקום `id` רכיבי כתובת שעות פתיחה אפשרויות לטעינת רכב חשמלי מותגים	תמיכה בסכימה מלאה.