הגשת הבקשה הראשונה

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

כדי להשתמש ב-Place Insights, שולחים בקשת HTTP POST לנקודת הקצה computeInsights באופן הבא:

https://areainsights.googleapis.com/v1:computeInsights

כדי לחדד את הבקשה, מציינים פרמטרים של אזור וסוג בגוף ה-JSON. בדוגמה הזו מוצגת בקשה להחזרת מספר המסעדות בסן פרנסיסקו שפעילות, במחירים סבירים ועם דירוג של 4 עד 5 כוכבים.

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
   "insights":[
      "INSIGHT_COUNT"
   ],
   "filter":{
      "locationFilter":{
         "region":{
            "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
         }
      },
      "typeFilter":{
         "includedTypes":[
            "restaurant"
         ]
      },
      "operatingStatus":[
         "OPERATING_STATUS_OPERATIONAL"
      ],
      "priceLevels":[
         "PRICE_LEVEL_INEXPENSIVE"
      ],
      "ratingFilter":{
         "minRating":4.0,
         "maxRating":5.0
      }
   }
}'

תגובה מ-Places Insights API

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

{
  "count": "846"
}

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

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