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

এই নথিটি Places Insights API-এর মধ্যে সমস্ত পরামিতিগুলির একটি পরিষ্কার ওভারভিউ প্রদান করে৷ আপনার ভৌগলিক ডেটার প্রয়োজনে এই টুলটি ব্যবহার করতে আপনাকে সাহায্য করার জন্য আমরা অন্তর্দৃষ্টি এবং সর্বোত্তম অনুশীলনগুলি অফার করে প্রতিটিকে বিস্তারিতভাবে কভার করব।

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

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

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

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

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

অন্তর্দৃষ্টি

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

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

দ্রষ্টব্য : যদি এই বিকল্পটি নির্বাচন করা হয়, তবে স্থানের অন্তর্দৃষ্টি API শুধুমাত্র 100 বা count কম হলেই স্থানের আইডি প্রদান করে।

ফিল্টার

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

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

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

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

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

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

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

অসমর্থিত অঞ্চল প্রকার
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

আপনি একটি জায়গার আইডির সাথে যুক্ত অবস্থান বা ঠিকানার ধরন নির্ধারণ করতে একটি জিওকোডিং API কল থেকে types ক্ষেত্র ব্যবহার করতে পারেন, যেমন এটি একটি শহর, প্রতিবেশী বা দেশ কিনা।

কাস্টম এলাকা

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

আপনি একটি কাস্টম বহুভুজ আঁকতে এবং অনুরোধে সেই স্থানাঙ্কগুলি প্রবেশ করতে https://geojson.io/ এ যেতে পারেন। একটি বহুভুজের ন্যূনতম 4টি স্থানাঙ্ক থাকতে হবে, যেখানে প্রথম এবং শেষ স্থানাঙ্কগুলি অভিন্ন৷ প্রথম এবং শেষ স্থানাঙ্ক ছাড়াও, অন্য কোনও সদৃশ স্থানাঙ্ক থাকতে হবে না। অতিরিক্তভাবে, অ-সংলগ্ন প্রান্তগুলিকে ছেদ করার অনুমতি দেওয়া হয় না, এবং 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 দেখুন। কমপক্ষে একটি included_types বা included_primary_types প্রকার অবশ্যই অন্তর্ভুক্ত করতে হবে।

  • included_types : অন্তর্ভুক্ত স্থানের প্রকারের তালিকা।
  • excluded_types : বাদ দেওয়া স্থানের প্রকারের তালিকা।
  • included_primary_types : অন্তর্ভুক্ত প্রাথমিক স্থানের প্রকারের তালিকা।
  • excluded_primary_types : বাদ দেওয়া প্রাথমিক স্থানের প্রকারের তালিকা।

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

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

বাকি তিনটি ফিল্টার ঐচ্ছিক:

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

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

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

মূল্য স্তর

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

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

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

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

এই নথিটি Places Insights API-এর মধ্যে সমস্ত পরামিতিগুলির একটি পরিষ্কার ওভারভিউ প্রদান করে৷ আপনার ভৌগলিক ডেটার প্রয়োজনে এই টুলটি ব্যবহার করতে আপনাকে সাহায্য করার জন্য আমরা অন্তর্দৃষ্টি এবং সর্বোত্তম অনুশীলনগুলি অফার করে প্রতিটিকে বিস্তারিতভাবে কভার করব।

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

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

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

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

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

অন্তর্দৃষ্টি

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

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

দ্রষ্টব্য : যদি এই বিকল্পটি নির্বাচন করা হয়, তবে স্থানের অন্তর্দৃষ্টি API শুধুমাত্র 100 বা count কম হলেই স্থানের আইডি প্রদান করে।

ফিল্টার

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

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

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

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

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

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

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

অসমর্থিত অঞ্চল প্রকার
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

আপনি একটি জায়গার আইডির সাথে যুক্ত অবস্থান বা ঠিকানার ধরন নির্ধারণ করতে একটি জিওকোডিং API কল থেকে types ক্ষেত্র ব্যবহার করতে পারেন, যেমন এটি একটি শহর, প্রতিবেশী বা দেশ কিনা।

কাস্টম এলাকা

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

আপনি একটি কাস্টম বহুভুজ আঁকতে এবং অনুরোধে সেই স্থানাঙ্কগুলি প্রবেশ করতে https://geojson.io/ এ যেতে পারেন। একটি বহুভুজের ন্যূনতম 4টি স্থানাঙ্ক থাকতে হবে, যেখানে প্রথম এবং শেষ স্থানাঙ্কগুলি অভিন্ন৷ প্রথম এবং শেষ স্থানাঙ্ক ছাড়াও, অন্য কোনও সদৃশ স্থানাঙ্ক থাকতে হবে না। অতিরিক্তভাবে, অ-সংলগ্ন প্রান্তগুলিকে ছেদ করার অনুমতি দেওয়া হয় না, এবং 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 দেখুন। কমপক্ষে একটি included_types বা included_primary_types প্রকার অবশ্যই অন্তর্ভুক্ত করতে হবে।

  • included_types : অন্তর্ভুক্ত স্থানের প্রকারের তালিকা।
  • excluded_types : বাদ দেওয়া স্থানের প্রকারের তালিকা।
  • included_primary_types : অন্তর্ভুক্ত প্রাথমিক স্থানের প্রকারের তালিকা।
  • excluded_primary_types : বাদ দেওয়া প্রাথমিক স্থানের প্রকারের তালিকা।

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

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

বাকি তিনটি ফিল্টার ঐচ্ছিক:

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

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

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

মূল্য স্তর

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

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

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

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