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