نمونه ها

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

مکان های درون یک دایره را برگردانید

همه رستوران‌ها را در شعاع 200 متری میدان ترافالگار لندن برگردانید.

  • منطقه جستجو یک دایره است که بر روی یک طول و عرض جغرافیایی خاص متمرکز شده است. شعاع این دایره 200 متر است که اندازه منطقه جستجو را مشخص می کند.
  • نوع مکان درخواستی رستوران است و با استفاده از includedTypes در typeFilters ارسال می شود.
  • تعداد با استفاده از INSIGHTS_COUNT درخواست می‌شود و شناسه‌های مکان با استفاده از INSIGHTS_PLACES درخواست می‌شوند. 
curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "circle": {
        "latLng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "typeFilter": { "includedTypes": "restaurant" }
  }
}'

انواع مکان را حذف کنید

می‌توانید انواع مکان را از شمارش حذف کنید.

درخواست زیر مانند مثال اول است، اما excludedTypes به typeFilters اضافه می کند. می توانید از یک رشته یا آرایه ای از رشته ها برای includedTypes و excludedTypes استفاده کنید.

این مثال دو نوع مکان: cafe و bakery را از شمارش restaurant حذف می کند. 

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
    "filter": {
        "locationFilter": {
            "circle": {
                "latLng": { "latitude": 51.508, "longitude": -0.128},
                "radius": 200
            }
        },
        "typeFilter": {
            "includedTypes": "restaurant",
            "excludedTypes": [
                "cafe",
                "bakery"
            ]
        }
    }
}'

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

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

curl --location 'https://areainsights.googleapis.com/v1:computeInsights' \
--header 'X-Goog-Api-Key: API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "insights": ["INSIGHT_COUNT", "INSIGHT_PLACES"],
  "filter": {
    "locationFilter": {
      "circle": {
        "latLng": { "latitude": 51.508, "longitude": -0.128},
        "radius": 200
      }
    },
    "typeFilter": { "includedPrimaryTypes": "restaurant" }
  }
}'

چند ضلعی سفارشی

این مثال نشان می دهد که چگونه از یک چند ضلعی سفارشی برای تعریف منطقه جستجوی خود استفاده کنید. به خاطر داشته باشید که تعیین INSIGHTS_PLACES جستجو را به مناطقی محدود می کند که به اندازه کافی کوچک هستند تا حداکثر 100 شناسه مکان را برگردانند. برای مناطق بزرگتر، از INSIGHTS_COUNT برای دور زدن این محدودیت استفاده کنید تا سرویس نیازی به بازگرداندن شناسه مکان های فردی نداشته باشد.

مانند قبل، نوع مکان مورد استفاده restaurant است. این مثال همچنین سه فیلتر دیگر را معرفی می کند:

  • operatingStatus : این مثال فقط مکان های عملیاتی را در نظر می گیرد.
  • priceLevel : این مثال فقط مکان‌های ارزان و با قیمت متوسط ​​را در نظر می‌گیرد.
  • ratingFilter : این مثال فقط مکان هایی را می شمارد که امتیاز بازبینی بین 4.0 تا 5.0 دارند. 
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": {
            "customArea": {
                "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 }
                    ]
                }
            }
        },
        "typeFilter": {
            "includedTypes": "restaurant"
        },
        "operatingStatus": [ "OPERATING_STATUS_OPERATIONAL" ],
        "priceLevels": [ "PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE" ],
        "ratingFilter": { "minRating": 4.0, "maxRating": 5.0 }
    }
}'

منطقه جغرافیایی

این مثال از شناسه مکان جغرافیایی برای تنظیم منطقه جستجو استفاده می کند. این شناسه‌های مکان شامل هندسه یک مکان، مانند یک شهر یا شهر است. شناسه مکان مورد استفاده در اینجا ChIJiQHsW0m3j4ARm69rRkrUF3w است که مربوط به شهر Mountain View، کالیفرنیا است.

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

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

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/ChIJiQHsW0m3j4ARm69rRkrUF3w"
            }
        },
        "typeFilter": {
            "includedTypes": [
                "restaurant"
            ]
        }
    }
}'