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