اولین درخواست خود را مطرح کنید

این سند شما را در ایجاد یک درخواست اولیه به API Places Aggregate و درک پاسخ، که شامل تعداد مکان‌های منطبق است، راهنمایی می‌کند.

امتحانش کن!

برای استفاده از Places Aggregate API، یک درخواست HTTP POST به صورت زیر به نقطه پایانی computeInsights ارسال کنید:

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

درخواست خود را با ارائه پارامترهای منطقه و نوع در بدنه JSON اصلاح کنید. این مثال درخواستی را برای بازگرداندن تعداد رستوران‌های سانفرانسیسکو که فعال، با قیمت متوسط ​​و رتبه‌بندی بین ۴ تا ۵ ستاره هستند، نشان می‌دهد.

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
      }
   }
}'

پاسخ API تجمیع‌شده‌ی مکان‌ها

پاسخ زیر از درخواست نمونه بالا، تعداد رستوران‌هایی را که با معیارها مطابقت دارند، نشان می‌دهد.

{
  "count": "850"
}

امتحانش کن!

API Explorer به شما امکان می‌دهد درخواست‌های نمونه ایجاد کنید تا با API و گزینه‌های API آشنا شوید.

  1. آیکون API را انتخاب کنید، API Explorer را گسترش دهید. ، در سمت راست صفحه.
  2. در صورت تمایل، برای تنظیم هر پارامتری، گزینه‌ی «نمایش پارامترهای استاندارد» را باز کنید.
  3. به صورت اختیاری، متن درخواست (Request body) را ویرایش کنید.
  4. دکمه اجرا را انتخاب کنید. در کادر محاوره‌ای، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.

  5. در پنل API Explorer، آیکون expand را انتخاب کنید، API Explorer را گسترش دهید. ، برای گسترش پنجره API Explorer.

قدم بعدی چیست؟