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

נתונים של Places Insights

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

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

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

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

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

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

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

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

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

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

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

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

שליחת שאילתות לנתוני Places Insights

ב-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 רכיבי כתובת שעות פתיחה אפשרויות לטעינת רכב חשמלי מותגים	תמיכה בסכימה מלאה.