סקירה כללית

Places Aggregate API הוא שירות שמספק תובנות על מקומות באזור מסוים על סמך קריטריונים כמו מיקום, סוג, סטטוס פעילות, רמת מחיר ודירוגים של משתמשים. השירות הזה יכול לעזור לנתח את הצפיפות של סוגי מקומות ספציפיים סביב מיקום נתון, ולענות על שאלות כמו "אילו מסעדות בדירוג 5 כוכבים עם מחיר ממוצע של $$$ נמצאות ברדיוס של 5 ק"מ מהמיקום הזה?"

התוצאות מוצגות כמספרים מצטברים או כמזהי המקומות שזוהו באזור החיפוש הרלוונטי. משתמשים יכולים להשתמש ב-Place Details API כדי לאחזר מידע נוסף על מזהי המקומות האלה.

למה כדאי להשתמש ב-Places Aggregate API

באמצעות Places Aggregate API, המשתמשים יכולים לקבל החלטות מבוססות-נתונים על סמך המידע המקיף שאתם מספקים על מקומות שונים. הוא מתבסס על מודלים מדויקים ועדכניים של מקומות, שתומכים בתרחישי השימוש העיקריים הבאים:

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

מה אפשר לעשות עם Places Aggregate API

באמצעות Places Aggregate API אפשר לקבל את המידע הבא:

  • ספירה: אחזור מספר המקומות שתואמים לקריטריונים שלכם.
  • מזהי מקומות: אחזור של מזהי מקומות של מקומות ספציפיים שתואמים לקריטריונים שלכם.

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

דוגמאות

בקטע הזה מתוארים תרחישים לדוגמה לשימוש ב-Places Aggregate API, ולכל דוגמה מצורף קוד עובד.

פתיחת בית קפה חדש

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

לצפייה בדוגמה

מפה של סן פרנסיסקו ודירוגי בידור לפי מיקוד.

חברת השקעות בנדל"ן

חברת השקעות בנדל"ן רוצה לשפר את המודלים הפיננסיים שלה ולקבוע במדויק את החזר ה-ROI על ההשקעות המתוכננות בנכסים. באמצעות Places Aggregate API, הם יכולים לאסוף נתונים מפורטים על המתקנים בסביבת נכסי השקעה פוטנציאליים, כמו כספומטים, בתי חולים, תחנות תחבורה ציבורית וחנויות מכולת, כדי להבין את המתקנים בסביבת נכסי השקעה פוטנציאליים.

שירות משלוחים של קמעונאות

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

לצפייה בדוגמה

מפת חום של מסעדות לפי נפח ב-Mountain View.

איך פועל Places Aggregate API

באמצעות Places Aggregate API אפשר לציין מסננים כדי לצמצם את קריטריוני החיפוש. אחרי שבוחרים סוג תובנה של INSIGHT_COUNT או של INSIGHT_PLACES, אפשר להוסיף קריטריונים לסינון, כולל:

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

אובייקט התשובה מה-API, ComputeInsightsResponse, מכיל את התוצאות של מדד הבקשה. לדוגמה, אם בוחרים באפשרות INSIGHT_COUNT, התגובה מכילה את המספר הכולל של המקומות. אם בוחרים באפשרות INSIGHT_PLACES, התגובה מכילה רשימה של מזהי מקומות.

איך משתמשים ב-Places Aggregate API

1 הגדרה מתחילים בהגדרת הפרויקט ב-Google Cloud ופועלים לפי ההוראות הבאות.
2 שולחים בקשה לקבלת מספר המקומות שתואמים לקריאה. איך שולחים את הבקשה הראשונה
3 מידע על פרמטרים של בקשות פרמטרים של בקשות

המאמרים הבאים