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

يرشدك هذا المستند إلى كيفية تقديم طلب أساسي إلى 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": "850"
}

جرّب الآن

يتيح لك "مستكشف واجهة برمجة التطبيقات" إنشاء نماذج طلبات لكي تتمكّن من التعرّف على واجهة برمجة التطبيقات وخياراتها.

1. انقر على رمز واجهة برمجة التطبيقات، ، على يسار الصفحة.
2. يمكنك اختياريًا توسيع عرض المَعلمات العادية وضبطه لضبط أي مَعلمات.
3. يمكنك اختياريًا تعديل نص الطلب.
4. انقر على الزر تنفيذ. في مربّع الحوار، اختَر الحساب الذي تريد استخدامه لتقديم الطلب.

5. في لوحة "مستكشف واجهات برمجة التطبيقات"، انقر على رمز التوسيع، ، لتوسيع نافذة "مستكشف واجهات برمجة التطبيقات".

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

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