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

এই দস্তাবেজটি স্থানগুলির অন্তর্দৃষ্টি 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 : সাধারণত এমন একটি স্থান নির্দেশ করে যা এখনও শ্রেণীবদ্ধ করা হয়নি।
• street_number : সুনির্দিষ্ট রাস্তার নম্বর নির্দেশ করে।
• floor : একটি বিল্ডিং ঠিকানার মেঝে নির্দেশ করে।
• post_box : একটি নির্দিষ্ট পোস্টাল বক্স নির্দেশ করে।
• street_address : একটি সুনির্দিষ্ট রাস্তার ঠিকানা নির্দেশ করে।
• room : একটি বিল্ডিং ঠিকানার ঘর নির্দেশ করে।
• intersection : একটি প্রধান ছেদ নির্দেশ করে, সাধারণত দুটি প্রধান রাস্তা।
• landmark : একটি কাছাকাছি স্থান নির্দেশ করে যা একটি রেফারেন্স হিসাবে ব্যবহৃত হয়, নেভিগেশনে সহায়তা করার জন্য।
• subpremise : প্রিমিস স্তরের নীচে একটি ঠিকানাযোগ্য সত্তা নির্দেশ করে, যেমন একটি অ্যাপার্টমেন্ট, ইউনিট, বা স্যুট৷
• sublocality_level_5 : উপলোক্যালিটি ঠিকানা উপাদানগুলির সবচেয়ে নির্দিষ্ট দানাদার স্তর। সাধারণত একটি শহরের মধ্যে একটি খুব ছোট পাড়া মহকুমা বা হাইপার-লোকাল এলাকা প্রতিনিধিত্ব করে।

কাস্টম এলাকা

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

আপনি দেখতে পারেন 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 : স্থানের রেটিং পরিসীমা নির্দিষ্ট করে। কোন ফিল্টারিং ডিফল্ট (সমস্ত রেটিং ফলাফল অন্তর্ভুক্ত করা হয়)।

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

operatingStatus ফিল্টার দিয়ে, আপনি অপারেটিং স্ট্যাটাসের উপর ভিত্তি করে ফিল্টার করতে পারেন (যেমন অপারেশনাল বা সাময়িকভাবে বন্ধ)। operatingStatus ফিল্টার সেট করা না থাকলে, শুধুমাত্র OPERATING_STATUS_OPERATIONAL এর অপারেটিং স্ট্যাটাস সহ স্থানগুলিকে ফলাফলে অন্তর্ভুক্ত করা হয়।

মূল্য স্তর

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

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

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

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

উপরন্তু, minRating মান সর্বদা maxRating মানের থেকে কম বা সমান হতে হবে। যদি minRating maxRating এর চেয়ে বড় হিসাবে নির্দিষ্ট করা হয়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়৷