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

يرشدك هذا المستند خلال عملية تقديم طلب أساسي إلى Places Insights 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":{
      "location_filter":{
         "region":{
            "place":"places/ChIJIQBpAG2ahYAR_6128GcTUEo"
         }
      },
      "type_filter":{
         "included_types":[
            "restaurant"
         ]
      },
      "operating_status":[
         "OPERATING_STATUS_OPERATIONAL"
      ],
      "price_levels":[
         "PRICE_LEVEL_INEXPENSIVE"
      ],
      "rating_filter":{
         "min_rating":4.0,
         "max_rating":5.0
      }
   }
}'

استجابة إحصاءات الحوسبة

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

{
  "count": "846"
}

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

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