উদাহরণ

এই বিভাগটি Places Insights API-কে উদাহরণের অনুরোধের একটি সিরিজ কভার করে।

computeInsights ব্যবহার করতে, নিম্নলিখিত ফর্মে একটি HTTP POST অনুরোধ জমা দিন:

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

একটি বৃত্তের মধ্যে স্থান ফেরত

ট্রাফালগার স্কোয়ার, লন্ডনের 200 মিটার ব্যাসার্ধের মধ্যে সমস্ত রেস্তোরাঁয় ফিরে যান।

  • অনুসন্ধান এলাকা হল একটি নির্দিষ্ট অক্ষাংশ এবং দ্রাঘিমাংশ কেন্দ্রিক একটি বৃত্ত। এই বৃত্তের ব্যাসার্ধ 200 মিটার, যা অনুসন্ধান এলাকার আকার নির্ধারণ করে।
  • অনুরোধ করা জায়গার ধরনটি হল রেস্তোরাঁ, এবং এটি type_filters মধ্যে included_types ব্যবহার করে পাস করা হয়।
  • 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" }
  }
}

স্থানের ধরন বাদ দিন

আপনি গণনা থেকে স্থানের প্রকারগুলিও বাদ দিতে পারেন৷

নিম্নলিখিত অনুরোধটি প্রথম উদাহরণের মতোই, কিন্তু type_filters এ excluded_types যোগ করে। আপনি 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"
            ]
        }
    }
}