שליחת הבקשה הראשונה

במסמך הזה מוסבר איך לשלוח בקשה בסיסית ל-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.

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