Places Aggregate API הוא שירות שמספק תובנות לגבי מקומות באזור מסוים על סמך קריטריונים כמו מיקום, סוג, סטטוס פעילות, רמת מחיר ודירוגי משתמשים. השירות הזה יכול לעזור לכם לנתח את הצפיפות של סוגי מקומות ספציפיים סביב מיקום נתון, ולענות על שאלות כמו "אילו מסעדות בדירוג 5 כוכבים עם סימן של 3$ נמצאות ברדיוס של 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, שירות המשלוחים סופר את המספר הכולל של העסקים האלה ברחבי העיר כדי לתכנן ולהקצות משאבים בצורה יעילה.
איך פועל Places Aggregate API
Places Aggregate API מאפשר לכם לציין מסננים כדי לצמצם את הקריטריונים לחיפוש.
אחרי שבוחרים Insight Type (סוג תובנה) – INSIGHT_COUNT או INSIGHT_PLACES, אפשר להוסיף קריטריונים לסינון, כולל:
- מיקום: מגדירים את האזור שבו המשתמשים מעוניינים באמצעות עיגולים, אזורים או מצולעים בהתאמה אישית.
- סוג: מציינים את סוגי המקומות שמעניינים אתכם.
- סטטוס הפעילות: סינון מקומות לפי סטטוס הפעילות שלהם.
- רמות מחירים: סינון מקומות לפי רמות מחירים.
- דירוגים: סינון מקומות לפי דירוגי משתמשים.
אובייקט התגובה של ה-API ComputeInsightsResponse מכיל את תוצאות התובנה של הבקשה. לדוגמה, אם בחרתם באפשרות INSIGHT_COUNT, התשובה תכלול את המספר הכולל של המקומות, ואם בחרתם באפשרות INSIGHT_PLACES, התשובה תכלול רשימה של מזהי מקומות.
איך משתמשים ב-Places Aggregate API
| 1 | איך מגדירים את התכונה | מתחילים בהגדרת פרויקט ב-Google Cloud ומשלימים את ההוראות הבאות. |
| 2 | שולחים בקשה לקבלת מספר המקומות התואמים. | איך שולחים את הבקשה הראשונה |
| 3 | מידע נוסף על פרמטרים של בקשות | פרמטרים של בקשות |