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

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

כדאי לנסות!

כדי להשתמש ב-Places Aggregate API, שולחים בקשת 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 Aggregate API

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

{
  "count": "850"
}

רוצה לנסות?

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

  1. לוחצים על סמל ה-API,‏ מרחיבים את API Explorer., בצד שמאל של הדף.
  2. אופציונלי: מרחיבים את האפשרות הצגת פרמטרים רגילים כדי להגדיר פרמטרים.
  3. אם רוצים, עורכים את גוף הבקשה.
  4. לוחצים על הלחצן Execute (הפעלה). בתיבת הדו-שיח, בוחרים את החשבון שרוצים להשתמש בו כדי לשלוח את הבקשה.

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

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