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

נתונים של Places Insights

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

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

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

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

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

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

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

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

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