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

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

آن را امتحان کنید!

برای استفاده از 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. به صورت اختیاری بدنه درخواست را ویرایش کنید.
  4. دکمه Execute را انتخاب کنید. در گفتگو، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.

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

بعدش چی