تقديم طلبك الأول

يرشدك هذا المستند إلى كيفية تقديم طلب أساسي إلى Places Insights API وفهم الاستجابة التي تتضمّن عدد الأماكن المطابقة.

لاستخدام ميزة "إحصاءات الأماكن"، أرسِل طلب POST باستخدام بروتوكول HTTP إلى نقطة نهاية computeInsights على النحو التالي:

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

حسِّن طلبك من خلال تقديم مَعلمتَي region وtype في ملف 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 Insights API

يعرض الردّ التالي من مثال الطلب أعلاه عدد المطاعم التي تتطابق مع المعايير.

{
  "count": "846"
}

الخطوات التالية

• اطّلِع على المزيد من الأمثلة على ما يمكنك تحقيقه باستخدام "إحصاءات الأماكن".
• اطّلِع على مَعلمات الطلب بمزيد من التفصيل.
• اطّلِع على مستندات واجهة برمجة التطبيقات الكاملة.