أمثلة

يتناول هذا القسم سلسلة من الأمثلة على الطلبات المُرسَلة إلى Places Insights API.

لاستخدام computeInsights، أرسِل طلب HTTP POST بالشكل التالي:

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

عرض الأماكن ضمن دائرة

إرجاع جميع المطاعم التي تقع ضمن نطاق 200 متر من ميدان "ترافالغار سكوير" في لندن

  • منطقة البحث هي دائرة تتمحور حول خطَي عرض وطول معيّنين. ويبلغ نصف قطر هذه الدائرة 200 متر، وهو ما يحدد حجم منطقة البحث.
  • نوع المكان المطلوب هو مطعم، ويتم تمريره باستخدام included_types ضمن type_filters.
  • يتم طلب العدد باستخدام INSIGHTS_COUNT، ويتم طلب أرقام تعريف الأماكن باستخدام INSIGHTS_PLACES.
{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_types": "restaurant" }
  }
}

استبعاد أنواع الأماكن

يمكنك أيضًا استبعاد أنواع الأماكن من العدّ.

الطلب التالي مماثل للمثال الأول، لكنه يضيف excluded_types إلى type_filters. يمكنك استخدام سلسلة أو صفيف السلاسل لكل من included_types وexcluded_types.

يستثني هذا المثال نوعين من الأماكن: cafe وbakery، من عدد restaurant

{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "location_filter": {
            "circle": {
                "lat_lng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "type_filter": {
            "included_types": "restaurant",
            "excluded_types": [
                "cafe",
                "bakery"
            ]
        }
    }
}

استخدام النوع الأساسي

يعمل هذا المثال على تعديل الطلب من المثال الأول ليشمل الأماكن فقط. التي تحتوي على primaryType من restaurant.

{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "location_filter": {
      "circle": {
        "lat_lng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "type_filter": { "included_primary_types": "restaurant" }
  }
}

مضلّع مخصّص

يوضح هذا المثال كيفية استخدام مضلّع مخصّص لتحديد بحثك واحدة. يُرجى الأخذ في الاعتبار أن تحديد INSIGHTS_PLACES يحصر البحث على صغيرة بما يكفي لعرض ما يصل إلى 100 معرّف مكان. للمناطق الأكبر، استخدم INSIGHTS_COUNT لتجاوز هذا الحد كي لا تحتاج الخدمة إلى تنفيذ أرقام تعريف الأماكن الفردية.

وكما في السابق، نوع المكان المُستخدَم هو restaurant. يقدم هذا المثال أيضًا ثلاثة عوامل تصفية أخرى:

  • operating_status: يحسب هذا المثال الأماكن التشغيلية فقط.
  • price_level: يحسب هذا المثال التكلفة غير المكلفة ومعقولة السعر فقط. مكانًا.
  • rating_filter: لا يحتسب هذا المثال سوى الأماكن التي حصلت على تقييم مراجعة بين 4.0 و5.0.
{
    "insights": [ "INSIGHT_COUNT" ],
    "filter": {
        "location_filter": {
            "custom_area": {
                "polygon": {
                    "coordinates": [
                        { "latitude": 37.776, "longitude": -122.666 },
                        { "latitude": 37.130, "longitude": -121.898 },
                        { "latitude": 37.326, "longitude": -121.598 },
                        { "latitude": 37.912, "longitude": -122.247 },
                        { "latitude": 37.776, "longitude": -122.666 }
                    ]
                }
            }
        },
        "type_filter": {
            "included_types": "restaurant"
        },
        "operating_status": [ "OPERATING_STATUS_OPERATIONAL" ],
        "price_levels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "rating_filter": { "min_rating": 4.0, "max_rating": 5.0 }
    }
}

المنطقة الجغرافية

يستخدم هذا المثال رقم تعريف مكان منطقة جغرافية لضبط منطقة البحث. تتضمن معرّفات الأماكن هندسة المكان، مثل بلدة أو مدينة. تشير رسالة الأشكال البيانية رقم تعريف المكان المُستخدَم هنا هو ChIJiQHsW0m3j4ARm69rRkrUF3w، والذي يتجاوب مع مدينة ماونتن فيو، كاليفورنيا.

يؤدي تمرير رقم تعريف المكان إلى Places Insights API إلى ضبط منطقة البحث على الحدود. من المنطقة الجغرافية يتم تمرير رقم تعريف المكان باستخدام place، بالتنسيق places/<place_ID>

يمكنك الحصول على رقم تعريف مكان حسب المنطقة الجغرافية من خلال أي من الطرق التالية:

{
    "insights": [
        "INSIGHT_COUNT"
    ],
    "filter": {
        "location_filter": {
            "region": {
                "place": "places/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "type_filter": {
            "included_types": [
                "restaurant"
            ]
        }
    }
}