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

במסמך הזה נסביר איך שולחים בקשה בסיסית ל-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": "850"
}

נסה בעצמך!

ב-API Explorer אפשר לשלוח בקשות לדוגמה כדי להתנסות ב-API ובאפשרויות שלו.

  1. בוחרים בסמל ה-API, מרחיבים את API Explorer., בצד שמאל של הדף.
  2. אפשר גם להרחיב את האפשרות Show standard parameters ולהגדיר את הפרמטרים הרצויים.
  3. אם רוצים, עורכים את גוף הבקשה.
  4. לוחצים על הלחצן הפעלה. בתיבת הדו-שיח, בוחרים את החשבון שבו רוצים להשתמש כדי לשלוח את הבקשה.

  5. בחלונית API Explorer, בוחרים בסמל ההרחבה מרחיבים את API Explorer. כדי להרחיב את החלון של API Explorer.

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