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

נתונים של Places Insights

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

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

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

  • אמסטרדם (NL)
  • אנקרה (TR)
  • ארקיפה (PE)
  • אתונה (יוון)
  • באד גאסטיין (AT)
  • ברלין (גרמניה)
  • ברנו (צ'כיה)
  • בריסל (BE)
  • בוקרשט (רומניה)
  • בואנוס איירס (AR)
  • בוסאן (KR)
  • קהיר (EG)
  • צ'יאנג מאי (תאילנד)
  • קופנהגן (DK)
  • קורק (אירלנד)
  • דברצן (הונגריה)
  • האנוי (VN)
  • הלסינקי (FI)
  • הונג קונג (HK)
  • ג'קרטה (ID)
  • ג'דה (SA)
  • יוהנסבורג (ZA)
  • קואלה לומפור (MY)
  • ליסבון (PT)
  • לונדון (בריטניה)
  • לוסייל (QA)
  • מדריד (ספרד)
  • מנילה (PH)
  • מדיין (קולומביה)
  • מקסיקו סיטי (MX)
  • מומבאי (הודו)
  • ניו יורק (ארה"ב)
  • אוסלו (NO)
  • פריז (צרפת)
  • פלובדיב (BG)
  • ריפא (BH)
  • רומא (איטליה)
  • סנטיאגו (CL)
  • סאו פאולו (ברזיל)
  • שארג'ה (AE)
  • סינגפור (SG)
  • שטוקהולם (SE)
  • סידני (אוסטרליה)
  • טאיפיי (TW)
  • תל אביב-יפו (IL)
  • טוקיו (יפן)
  • טורונטו (קנדה)
  • ורשה (פולין)
  • וולינגטון (ניו זילנד)
  • ציריך (CH)

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

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

סכימות של קבוצות נתונים

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

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

הסכימה של קבוצת הנתונים של המותגים מגדירה שלושה שדות:

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

שליחת שאילתות לגבי נתונים של Places Insights

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

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

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

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

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

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

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

מתי להריץ שאילתה על הנתונים ישירות ומתי להשתמש בפונקציות

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

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

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

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