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

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

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

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

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

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

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

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

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

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

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

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

• ‫id: מזהה המותג.
• ‫name: שם המותג, כמו 'Hertz' או 'Chase'.
• ‫category: הקטגוריה ברמה הגבוהה של המותג, כמו 'תחנת דלק', 'מזון ומשקאות' או 'לינה'.

הערה: נתוני מותגים זמינים רק בארצות הברית בגרסה הנוכחית.

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

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

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

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

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

שאילתות של פונקציית ספירת מקומות

פונקציות של ספירת מקומות יכולות להחזיר רשימה של מזהי מקומות, שאפשר להשתמש בהם כדי לחפש מידע על מקום ספציפי באמצעות מוצרים אחרים של 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 מ'^2). פונקציה מחזירה תוצאה גם אם ספירת הצבירה קטנה מ-5, כל עוד מתקיים התנאי של אזור החיפוש המינימלי.	תוצאות עם מספרים שקטנים מ-5 מושמטות מהתוצאות (כלומר, השורה לא נכללת).
מסנני מאפיינים נתמכים	פרמטרים של מסננים בפונקציית ספירת המקומות תומכים באותם פרמטרים כמו מסנני מאפיינים של שאילתות ישירות, למעט: מקום id רכיבי כתובת שעות פתיחה אפשרויות לטעינת רכב חשמלי מותגים	תמיכה בסכימה מלאה.