این سند شما را در ایجاد درخواست پایه به 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
}
}
}'
پاسخ Places Aggregate API
پاسخ زیر از درخواست نمونه بالا تعداد رستوران‌هایی را نشان می‌دهد که با معیارها مطابقت دارند.
{ "count": "850" }
امتحان کنید!
API Explorer به شما امکان می‌دهد درخواست‌های نمونه‌ای ایجاد کنید تا با API و گزینه‌های API آشنا شوید.
- نماد «میانای برنامه‌سازی کاربردی»
را در سمت راست صفحه انتخاب کنید. - به‌صورت اختیاری نمایش پارامترهای استاندارد را ازهم باز کنید تا پارامترهای موردنظرتان را تنظیم کنید.
- درصورت تمایل، بدنه درخواست را ویرایش کنید.
- دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که می‌خواهید برای درخواست استفاده کنید انتخاب کنید.
در پانل «کاوشگر میانای برنامه‌سازی کاربردی»، نماد ازهم بازکردن،
، را برای ازهم بازکردن پنجره «کاوشگر میانای برنامه‌سازی کاربردی» انتخاب کنید.
قدم بعدی چیست
- نمونه‌های بیشتری از آنچه می‌توانید با Places Aggregate API به‌دست آورید کاوش کنید.
- به پارامترهای درخواست با جزئیات بیشتری نگاه کنید.
- اسناد میانای برنامه‌سازی کاربردی را به‌طور کامل مشاهده کنید.