Package google.maps.areainsights.v1

אינדקס

AreaInsights

הגדרת השירות של ה-RPC המצטבר של Places.

ComputeInsights

rpc ComputeInsights(ComputeInsightsRequest) returns (ComputeInsightsResponse)

השיטה הזו מאפשרת לאחזר תובנות על אזורים באמצעות מגוון מסננים, כמו: אזור, סוג מקום, סטטוס פעילות, רמת מחיר ודירוגים. בשלב הזה יש תמיכה בתובנות מסוג 'ספירה' ו'מקומות'. בעזרת מדדי 'ספירה' אפשר לענות על שאלות כמו 'כמה מסעדות פועלות בקליפורניה, הן זולות ויש להן דירוג ממוצע של לפחות 4 כוכבים' (פרטים נוספים זמינים ב-insight enum). בעזרת התובנות לגבי 'מקומות', אפשר לקבוע אילו מקומות תואמים למסנן המבוקש. לאחר מכן, לקוחות יכולים להשתמש בשמות המשאבים של המקומות האלה כדי לאחזר פרטים נוספים על כל מקום בנפרד באמצעות Places API.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/cloud-platform

ComputeInsightsRequest

בקשה ל-ComputeInsights RPC.

שדות
insights[]

Insight

חובה. תובנות לחישוב. בשלב זה יש תמיכה רק ב-INSIGHT_COUNT וב-INSIGHT_PLACES.
filter

Filter

חובה. מסנן תובנות.

ComputeInsightsResponse

התגובה של RPC של ComputeInsights.

שדות
place_insights[]

PlaceInsight

התוצאה של Insights.INSIGHT_PLACES.
count

int64

התוצאה של Insights.INSIGHT_COUNT.

סינון

מסננים ל-RPC של ComputeInsights.

שדות
location_filter

LocationFilter

חובה. הגבלת התוצאות למקומות שנמצאים באזור שצוין במסנני המיקום.
type_filter

TypeFilter

חובה. מסננים לפי סוג מקום.
operating_status[]

OperatingStatus

זה שינוי אופציונלי. הגבלת התוצאות למקומות שסטטוס הפעילות שלהם נכלל ברשימה הזו. אם השדה operating_status לא מוגדר, המערכת משתמשת בערך OPERATING_STATUS_OPERATIONAL כברירת מחדל.
price_levels[]

PriceLevel

זה שינוי אופציונלי. הגבלת התוצאות למקומות ברמת המחיר שכלולה ברשימה הזו. אם לא מגדירים את price_levels, כל רמות המחירים נכללות בתוצאות.
rating_filter

RatingFilter

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

תובנה

תובנות נתמכות.

טיפוסים בני מנייה (enum)
INSIGHT_UNSPECIFIED לא צוין.
INSIGHT_COUNT

תובנה לגבי ספירה.

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

דוגמה לבקשה:

{
  "insights": ["INSIGHT_COUNT"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

דוגמה לתגובה:

{
  "count": 1234
}
INSIGHT_PLACES

החזרת מקומות

כשמציינים את התובנה הזו, ComputeInsights מחזיר מזהי מקומות שתואמים לקריטריונים של המסנן שצוינו.

דוגמה לבקשה:

{
  "insights": ["INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "region": {
        "place": "places/ChIJPV4oX_65j4ARVW8IJ6IJUYs"
      }
    },
    "typeFilter": {
      "includedTypes": ["restaurant"]
    },
    "operatingStatus": ["OPERATING_STATUS_OPERATIONAL"],
    "priceLevels": [
      "PRICE_LEVEL_FREE",
      "PRICE_LEVEL_INEXPENSIVE"
    ],
    "ratingFilter": {
      "minRating": 4.0
    }
  }
}

דוגמה לתגובה:

{
  "placeInsights": [
    {"place": "places/ABC"},
    {"place": "places/PQR"},
    {"place": "places/XYZ"}
  ]
}

LocationFilter

מסנני מיקומים.

מציין את אזור העניין של התובנה.

שדות
שדה האיחוד area. צריך לציין אחד מהערכים הבאים. הערך של area יכול להיות רק אחת מהאפשרויות הבאות:
circle

Circle

שטח כמעגל.
region

Region

אזור כמיקום.
custom_area

CustomArea

אזור מותאם אישית שמצוין על ידי פוליגון.

מעגל

מעגל מוגדר על ידי נקודת מרכז ורדיוס במטרים.

שדות
radius

int32

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

LatLng

קו הרוחב וקו האורך של מרכז המעגל.
place

string

פורמט: הפורמט חייב להיות places/PLACE_ID, כאשר PLACE_ID הוא המזהה הייחודי של המקום. לדוגמה: places/ChIJgUbEo8cfqokR5lP9_Wh_DaM.

CustomArea

אזור מותאם אישית.

שדות
polygon

Polygon

חובה. האזור המותאם אישית שמוצג כפוליגון

פוליגון

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

שדות
coordinates[]

LatLng

זה שינוי אופציונלי. הקואורדינטות שמגדירות את הפוליגון.

אזור

אזור הוא גבול גיאוגרפי, כמו ערים, אזורי מיקוד, מחוזות, מדינות וכו'.

שדות
שדה האיחוד region. הגדרת אזור גיאוגרפי. אפשר לציין רק סוג אחד של אזור (למשל מקום) בכל פעם. הערך של region יכול להיות רק אחת מהאפשרויות הבאות:
place

string

המזהה הייחודי של אזור גיאוגרפי ספציפי.

OperatingStatus

סטטוס הפעילות של המקום.

טיפוסים בני מנייה (enum)
OPERATING_STATUS_UNSPECIFIED לא צוין. לא צריך להשתמש בערך הזה.
OPERATING_STATUS_OPERATIONAL המקום פעיל ופתוח במהלך שעות הפעילות שהוגדרו לו.
OPERATING_STATUS_PERMANENTLY_CLOSED המקום לא פעיל יותר.
OPERATING_STATUS_TEMPORARILY_CLOSED המקום סגור באופן זמני וצפוי לפתוח מחדש בעתיד.

PlaceInsight

מכיל מידע על מקום

שדות
place

string

המזהה הייחודי של המקום. אפשר להשתמש בשם המשאב הזה כדי לאחזר פרטים על המקום באמצעות Places API.

PriceLevel

רמת המחירים במקום.

טיפוסים בני מנייה (enum)
PRICE_LEVEL_UNSPECIFIED לא צוין. לא צריך להשתמש בערך הזה.
PRICE_LEVEL_FREE המקום מספק שירותים בחינם.
PRICE_LEVEL_INEXPENSIVE המקום מספק שירותים במחירים נמוכים.
PRICE_LEVEL_MODERATE המקום מספק שירותים במחירים סבירים.
PRICE_LEVEL_EXPENSIVE המקום מספק שירותים יקרים.
PRICE_LEVEL_VERY_EXPENSIVE המקום מספק שירותים יקרים מאוד.

RatingFilter

מסננים של דירוג ממוצע של משתמשים.

שדות
min_rating

float

זה שינוי אופציונלי. הגבלת התוצאות למקומות שהדירוג הממוצע שלהם על ידי משתמשים גבוה מ-min_rating או שווה לו. הערכים צריכים להיות בין 1.0 ל-5.0.
max_rating

float

זה שינוי אופציונלי. הגבלת התוצאות למקומות שהדירוג הממוצע שלהם על ידי משתמשים נמוך מ-max_rating או שווה לו. הערכים צריכים להיות בין 1.0 ל-5.0.

TypeFilter

מסננים לפי סוג מקום.

יש תמיכה רק בסוגי המקומות שמפורטים בטבלה א'.

אפשר לשייך למקום רק סוג ראשי אחד. לדוגמה, הסוג הראשי יכול להיות 'mexican_restaurant' או 'steak_house'. משתמשים במאפיינים included_primary_types ו-excluded_primary_types כדי לסנן את התוצאות לפי הסוג הראשי של המקום.

למקום יכולים להיות משויכים גם כמה ערכים של סוג. לדוגמה, מסעדה עשויה לכלול את הסוגים הבאים: 'seafood_restaurant',‏ 'restaurant',‏ 'food',‏ 'point_of_interest',‏ 'establishment'. אפשר להשתמש ב-included_types וב-excluded_types כדי לסנן את התוצאות ברשימת הסוגים שמשויכים למקום.

אם מציינים חיפוש עם כמה הגבלות סוג, יוחזרו רק מקומות שעומדים בכל ההגבלות. לדוגמה, אם מציינים את הערכים הבאים: {"included_types": ["restaurant"], "excluded_primary_types": ["steak_house"]}, המקומות שיוחזרו מציעים שירותים שקשורים ל'מסעדה', אבל הם לא פועלים בעיקר בתור 'steak_house'.

אם יש סוגים מתנגשים, כלומר סוג מופיע גם בסוגים included_types וגם בסוגים excluded_types או בסוגים included_primary_types וגם בסוגים excluded_primary_types, תוחזר השגיאה INVALID_ARGUMENT.

צריך להגדיר אחד מהערכים included_types או included_primary_types.

שדות
included_types[]

string

זה שינוי אופציונלי. סוגי המקומות הכלולים.
excluded_types[]

string

זה שינוי אופציונלי. סוגי מקומות שהוחרגו.
included_primary_types[]

string

זה שינוי אופציונלי. סוגי המקומות הראשיים הכלולים.
excluded_primary_types[]

string

זה שינוי אופציונלי. סוגי המיקומים הראשיים שהוחרגו.