نمونه ها

این بخش مجموعه‌ای از درخواست‌های نمونه به API Places Insights را پوشش می‌دهد.

برای استفاده از 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"
            ]
        }
    }
}

از نوع اولیه استفاده کنید

این مثال درخواست مثال اول را تغییر می‌دهد تا فقط مکان‌هایی را شامل شود که دارای یک نوع restaurant primaryType در شمارش هستند.

{
  "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 است که مربوط به شهر Mountain View، کالیفرنیا است.

ارسال شناسه مکان به Places Insights API، ناحیه جستجو را در محدوده منطقه جغرافیایی قرار می دهد. شناسه مکان با استفاده از place ، در قالب places/<place_ID> ارسال می‌شود.

شما می توانید شناسه مکان منطقه جغرافیایی را به یکی از روش های زیر دریافت کنید:

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