পরামিতি অনুরোধ

এই দস্তাবেজটি স্থানগুলির অন্তর্দৃষ্টি API-এর জন্য অনুরোধের পরামিতিগুলি বর্ণনা করে এবং এই পরিষেবাটি ব্যবহার করার জন্য অন্তর্দৃষ্টি এবং সর্বোত্তম অনুশীলনগুলি অন্তর্ভুক্ত করে৷

Places Insights API আপনাকে বেশ কিছু মূল ফাংশন সম্পাদন করতে দেয়:

  • স্থান গণনা করুন : নির্দিষ্ট মানদণ্ডের সাথে মেলে এমন স্থানের সংখ্যা নির্ধারণ করুন, যেমন অবস্থানের ধরন, অপারেটিং স্থিতি, মূল্য স্তর এবং রেটিং।
  • স্থানের বিশদ পুনরুদ্ধার করুন : নির্দিষ্ট ফিল্টার পূরণ করে এমন স্থানের নাম পান, তারপর স্থান API ব্যবহার করে আরও বিস্তারিত তথ্য আনুন।
  • নমনীয় ফিল্টারিং : সুনির্দিষ্ট অন্তর্দৃষ্টি পেতে ব্যাপক ফিল্টার প্রয়োগ করুন। উপলব্ধ ফিল্টার নিম্নলিখিত অন্তর্ভুক্ত:
    • ভৌগলিক এলাকা (বৃত্ত, অঞ্চল বা কাস্টম বহুভুজ)
    • স্থানের ধরন
    • অপারেটিং অবস্থা
    • দামের মাত্রা
    • রেটিং রেঞ্জ

প্রয়োজনীয় পরামিতি

Places Insights API-কে একটি অনুরোধ জারি করার সময় এই বিভাগটি প্রয়োজনীয় প্যারামিটারগুলিকে কভার করে৷ প্রতিটি অনুরোধ নিম্নলিখিত সরবরাহ করা আবশ্যক:

  • এক ধরনের অন্তর্দৃষ্টি।
  • একটি অবস্থান ফিল্টার এবং টাইপ ফিল্টার.

অন্তর্দৃষ্টি টাইপ

আপনি যে ধরনের অন্তর্দৃষ্টি গণনা করতে চান তা নির্দিষ্ট করে। নিম্নলিখিত অন্তর্দৃষ্টি প্রকারগুলি সমর্থিত:

  • INSIGHT_COUNT : ফিল্টারের মানদণ্ডের সাথে মিলে যাওয়া স্থানের সংখ্যা প্রদান করে।

  • INSIGHT_PLACES : ফিল্টারের মানদণ্ডের সাথে মিলে যাওয়া জায়গার আইডি ফেরত দেয়।

    দ্রষ্টব্য : আপনি যদি INSIGHT_PLACES নির্বাচন করেন, তাহলে Places Insights API শুধুমাত্র 100 বা তার কম count হলেই স্থানের আইডি প্রদান করে৷

ফিল্টার

ফিল্টারিং জায়গাগুলির জন্য মানদণ্ড নির্দিষ্ট করে৷ সর্বনিম্নভাবে, আপনাকে অবশ্যই LocationFilter এবং TypeFilter নির্দিষ্ট করতে হবে।

অবস্থান ফিল্টার

একটি অবস্থান ফিল্টার নিম্নলিখিত ধরনের হতে পারে:

  • circle : কেন্দ্র এবং ব্যাসার্ধ সহ একটি ক্ষেত্রকে বৃত্ত হিসাবে সংজ্ঞায়িত করে।
  • region : একটি অঞ্চলকে একটি অঞ্চল হিসাবে সংজ্ঞায়িত করে।
  • customArea : একটি এলাকাকে কাস্টম বহুভুজ হিসাবে সংজ্ঞায়িত করে।
বৃত্ত

আপনি যদি একটি বৃত্ত হিসাবে আপনার ভৌগলিক এলাকা নির্বাচন করেন, তাহলে আপনাকে একটি center এবং একটি radius প্রদান করতে হবে। কেন্দ্রটি হয় একটি অক্ষাংশ এবং দ্রাঘিমাংশ, অথবা বৃত্তের কেন্দ্রের স্থান আইডি হতে পারে।

  • center :
    • latLng : বৃত্তের কেন্দ্রের অক্ষাংশ এবং দ্রাঘিমাংশ। অক্ষাংশ অবশ্যই -90, 90 এর মধ্যে একটি সংখ্যা হতে হবে। দ্রাঘিমাংশ অবশ্যই -180, 180 এর মধ্যে একটি সংখ্যা হতে হবে।
    • place : বৃত্তের কেন্দ্রস্থলের আইডি। উল্লেখ্য যে শুধুমাত্র পয়েন্ট স্থান সমর্থিত. এই স্ট্রিংটি অবশ্যই places/ উপসর্গ দিয়ে শুরু করতে হবে।
  • radius : মিটারে বৃত্তের ব্যাসার্ধ। এই সংখ্যা ইতিবাচক হতে হবে.
অঞ্চল

place প্যারামিটারে একটি স্থান আইডি পাস করে আপনার এলাকাটিকে একটি অঞ্চল হিসাবে সংজ্ঞায়িত করুন। স্থান আইডি একটি ভৌগলিক এলাকা (যেমন একটি বহুভুজ দ্বারা প্রতিনিধিত্বযোগ্য একটি এলাকা) প্রতিনিধিত্ব করে। উদাহরণস্বরূপ, Tampa, FL-এর স্থান আইডি হল places/ChIJ4dG5s4K3wogRY7SWr4kTX6c । মনে রাখবেন যে সমস্ত স্থানের আইডিগুলির একটি ভালভাবে সংজ্ঞায়িত জ্যামিতি নেই এবং এই ক্ষেত্রে Places Insights API একটি 400 ত্রুটি কোড প্রদান করে একটি বার্তা সহ যা নির্দেশ করে যে অঞ্চলটি সমর্থিত নয়৷

নিম্নলিখিত সারণীতে অসমর্থিত অঞ্চলের ধরন তালিকাভুক্ত করা হয়েছে। একটি স্থান আইডি একটি অসমর্থিত অঞ্চলের প্রকারের প্রতিনিধিত্ব করে কিনা তা নির্ধারণ করতে, একটি জিওকোডিং API অনুরোধে স্থান আইডি পাস করুন৷ প্রতিক্রিয়াতে স্থান আইডির সাথে যুক্ত অঞ্চলগুলির তালিকাভুক্ত type অ্যারে অন্তর্ভুক্ত থাকে, যেমন city , neighborhood বা country ৷

অসমর্থিত অঞ্চল প্রকার
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise
কাস্টম এলাকা

অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক ব্যবহার করে একটি কাস্টম বহুভুজের এলাকা সংজ্ঞায়িত করে।

আপনি একটি কাস্টম বহুভুজ আঁকতে এবং অনুরোধে সেই স্থানাঙ্কগুলি প্রবেশ করতে https://geojson.io/ এ যেতে পারেন। একটি বহুভুজের ন্যূনতম 4টি স্থানাঙ্ক থাকতে হবে, যেখানে প্রথম এবং শেষ স্থানাঙ্কগুলি অভিন্ন৷ প্রদত্ত স্থানাঙ্কগুলির মধ্যে কমপক্ষে 3টি অনন্য হতে হবে৷ প্রথম এবং শেষ স্থানাঙ্কগুলি ছাড়াও, অন্য কোনও সদৃশ স্থানাঙ্ক থাকতে হবে না। অতিরিক্তভাবে, অ-সংলগ্ন প্রান্তগুলিকে ছেদ করার অনুমতি দেওয়া হয় না এবং 180 ডিগ্রি দৈর্ঘ্যের প্রান্তগুলি অনুমোদিত নয় (অর্থাৎ, সন্নিহিত শীর্ষগুলি অ্যান্টিপোডাল হতে পারে না)।

যেমন: 

"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
   }
]

ফিল্টার টাইপ করুন

অন্তর্ভুক্ত বা বাদ দিতে স্থানের ধরন নির্দিষ্ট করে। স্থানের অন্তর্দৃষ্টি API সমর্থন করে এমন প্রাথমিক এবং মাধ্যমিক উভয় প্রকারের স্থানের তালিকার জন্য, স্থান API (নতুন) এর জন্য স্থানের প্রকারের অধীনে সারণি A দেখুন। আপনাকে অবশ্যই অন্তত একটি includedTypes বা includedPrimaryTypes টাইপ নির্দিষ্ট করতে হবে।

  • includedTypes : অন্তর্ভুক্ত স্থানের প্রকারের তালিকা।
  • excludedTypes : বাদ দেওয়া স্থানের প্রকারের তালিকা।
  • includedPrimaryTypes : অন্তর্ভুক্ত প্রাথমিক স্থানের প্রকারের তালিকা।
  • excludedPrimaryTypes : বাদ দেওয়া প্রাথমিক স্থানের প্রকারের তালিকা।

টাইপ ফিল্টার এবং স্থানের প্রকারগুলি কীভাবে কাজ করে সে সম্পর্কে আরও জানতে, টাইপ ফিল্টার সম্পর্কে আরও দেখুন।

ঐচ্ছিক পরামিতি

এই ফিল্টারগুলি ঐচ্ছিক:

  • operatingStatus : অন্তর্ভুক্ত বা বাদ দেওয়ার জায়গাগুলির স্থিতি নির্দিষ্ট করে৷ operatingStatus: OPERATING_STATUS_OPERATIONAL (একটি নির্দিষ্ট মান)।
  • priceLevels : স্থানের মূল্য স্তর নির্দিষ্ট করে। কোন ফিল্টারিং ডিফল্ট (সমস্ত মূল্য স্তর ফলাফল অন্তর্ভুক্ত করা হয়)।
  • ratingFilter : স্থানের রেটিং পরিসীমা নির্দিষ্ট করে। কোন ফিল্টারিং ডিফল্ট (সমস্ত রেটিং ফলাফল অন্তর্ভুক্ত করা হয়)।

অপারেটিং অবস্থা

অপারেটিং স্ট্যাটাসের উপর ভিত্তি করে ফিল্টার করুন (যেমন অপারেশনাল বা সাময়িকভাবে বন্ধ)।

মূল্য স্তর

মূল্য স্তরের উপর ভিত্তি করে ফিল্টার করুন (যেমন বিনামূল্যে, মাঝারি, বা ব্যয়বহুল)।

রেটিং ফিল্টার

তাদের গড় ব্যবহারকারীর রেটিং এর উপর ভিত্তি করে স্থানগুলিকে ফিল্টার করে৷ এই দুটি ক্ষেত্রই ঐচ্ছিক এবং তাই যদি সেগুলি বাদ দেওয়া হয়, তবে তারা ডিফল্ট এমন জায়গাগুলিকেও অন্তর্ভুক্ত করবে যেগুলির রেটিং নেই৷

  • minRating : সর্বনিম্ন গড় ব্যবহারকারী রেটিং (1.0 এবং 5.0 এর মধ্যে)।
  • maxRating : সর্বোচ্চ গড় ব্যবহারকারী রেটিং (1.0 এবং 5.0 এর মধ্যে)।