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

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

جرِّبه الآن

لاستخدام Places Aggregate API، أرسِل طلب HTTP POST إلى نقطة النهاية computeInsights على النحو التالي:

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

يمكنك تحسين طلبك من خلال تقديم مَعلمتَي المنطقة والنوع في نص 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 Aggregate API

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

{
  "count": "850"
}

جرِّبه الآن

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

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

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

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

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