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

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

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

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

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

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

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

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

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

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

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

ফিল্টার

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

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

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

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

গুরুত্বপূর্ণ: যেকোনো অবস্থানের ফিল্টারের জন্য ক্ষেত্রফল 1556.86 বর্গ মিটার (প্রায় একটি ছোট শহরের ব্লকের আকার) এবং 2 ট্রিলিয়ন বর্গ মিটার (আনুমানিক আলাস্কার আকার) এর মধ্যে হতে হবে। এই সীমার বাইরের অঞ্চলগুলির সাথে অনুরোধগুলি একটি INVALID_ARGUMENT ত্রুটি ফিরিয়ে দেবে৷

দ্রষ্টব্য: পার্ক বা বিমানবন্দরের মতো সংজ্ঞায়িত বহুভুজ সীমানা সহ সত্তার জন্য, যদি এর বহুভুজের কোনো অংশ সংজ্ঞায়িত অনুসন্ধান এলাকা (বৃত্ত, অঞ্চল বা কাস্টম বহুভুজ) এর সাথে ছেদ করে তবে সত্তাটিকে অনুসন্ধান এলাকার মধ্যে বিবেচনা করা হয়। সত্তার কেন্দ্র বিন্দু অনুসন্ধান এলাকার মধ্যে হতে হবে না.

বৃত্ত

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

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

অঞ্চল

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

গুরুত্বপূর্ণ: INSIGHT_PLACES অন্তর্দৃষ্টি টাইপ সহ region ফিল্টার ব্যবহার করার সময়, Google পরিষেবাগুলির যথার্থতা এবং নিরপেক্ষতা নিশ্চিত করতে বিতর্কিত এলাকাগুলি অন্তর্ভুক্ত করার অনুরোধগুলি স্বয়ংক্রিয়ভাবে প্রত্যাখ্যান করা হয়৷ বিরোধপূর্ণ এলাকাগুলি হল বিভিন্ন দেশ বা সংস্থার দ্বারা বিরোধপূর্ণ সীমানা বা আঞ্চলিক দাবি সহ অঞ্চল। বিতর্কিত সীমানাগুলি Google মানচিত্রে একটি ড্যাশযুক্ত ধূসর রেখা হিসাবে প্রদর্শিত হয়৷

বিতর্কিত অঞ্চলগুলি কীভাবে চিহ্নিত করা হয় সে সম্পর্কে আরও তথ্যের জন্য, দেশের সীমানা এবং নামগুলি বুঝুন দেখুন।

গুরুত্বপূর্ণ: Google নিম্নলিখিত ধরণের অঞ্চলের নির্দিষ্ট স্থানের আইডি সমর্থন করে না:

• অঞ্চলের প্রকারগুলি এত বড় যে সেগুলির ফলে উচ্চ বিলম্ব হয়৷
• অঞ্চলের ধরনগুলি এত ছোট যে তারা গোপনীয়তা সম্মতিতে আপস করে।

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

অসমর্থিত স্থানের প্রকারগুলি অন্তর্ভুক্ত:

• establishment : সাধারণত এমন একটি স্থান নির্দেশ করে যা এখনও শ্রেণীবদ্ধ করা হয়নি।
• intersection : একটি প্রধান ছেদ নির্দেশ করে, সাধারণত দুটি প্রধান রাস্তা।
• subpremise : প্রিমিস স্তরের নীচে একটি ঠিকানাযোগ্য সত্তা নির্দেশ করে, যেমন একটি অ্যাপার্টমেন্ট, ইউনিট, বা স্যুট৷

দ্রষ্টব্য: এমনকি উপরে তালিকাভুক্ত নয় এমন কিছু স্থান প্রত্যাখ্যান করা হতে পারে যদি তাদের একটি সু-সংজ্ঞায়িত বহুভুজ জ্যামিতি না থাকে। এটি neighborhood , locality , sublocality , এবং এর সংখ্যাযুক্ত ভেরিয়েন্টগুলির সাথে আরও সাধারণ ( sublocality_level_1 , sublocality_level_2 , sublocality_level_3 , sublocality_level_4 )। এই ক্ষেত্রে একটি 400 ত্রুটি কোড ফেরত দেওয়া হয়।

কাস্টম এলাকা

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

গুরুত্বপূর্ণ: বহুভুজের শীর্ষবিন্দু সংজ্ঞায়িত স্থানাঙ্কগুলি অবশ্যই ঘড়ির কাঁটার বিপরীতে তালিকাভুক্ত করা উচিত। এটি বহুভুজ সংজ্ঞায়িত করার জন্য ইন্ডাস্ট্রি স্ট্যান্ডার্ড কনভেনশন অনুসরণ করে, যেখানে ঘড়ির কাঁটার বিপরীতে ক্রম নির্দেশ করে বহুভুজের অভ্যন্তরটি সীমানা প্রান্তের বাম দিকে অবস্থিত।

গুরুত্বপূর্ণ: কাস্টম এলাকায় 7000টি শীর্ষবিন্দু বা তার কম থাকতে হবে।

আপনি দেখতে পারেন 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
   }
]

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

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

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

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

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

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

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

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

operatingStatus ফিল্টার দিয়ে, আপনি অপারেটিং স্ট্যাটাসের উপর ভিত্তি করে ফিল্টার করতে পারেন যেমন OPERATIONAL বা TEMPORARILY_CLOSED । operatingStatus ফিল্টার আচরণ নিম্নরূপ কাজ করে:

• যদি কোন ফিল্টার প্রদান করা না হয়, শুধুমাত্র OPERATING_STATUS_OPERATIONAL এর অপারেটিং স্থিতি সহ স্থানগুলিকে ফলাফলে অন্তর্ভুক্ত করা হয়৷
• যদি এক বা একাধিক ফিল্টার প্রদান করা হয়, তাহলে আপনাকে অবশ্যই বৈধ অপারেটিং স্ট্যাটাস মান উল্লেখ করতে হবে ( OPERATING_STATUS_OPERATIONAL , OPERATING_STATUS_PERMANENTLY_CLOSED , অথবা OPERATING_STATUS_TEMPORARILY_CLOSED )।

মূল্য স্তর

priceLevels ফিল্টার দিয়ে, আপনি স্থানগুলিকে তাদের প্রাইস লেভেলের উপর ভিত্তি করে ফিল্টার করতে পারেন। বৈধ মূল্য স্তরের মানগুলি হল: PRICE_LEVEL_FREE , PRICE_LEVEL_INEXPENSIVE , PRICE_LEVEL_MODERATE , PRICE_LEVEL_EXPENSIVE , এবং PRICE_LEVEL_VERY_EXPENSIVE ।

priceLevels ফিল্টারের আচরণ নিম্নরূপ:

• যদি কোন ফিল্টার প্রদান করা না হয়: সমস্ত স্থান ফেরত দেওয়া হয়, তাদের মূল্য স্তর নির্ধারণ করা হোক না কেন । এর মধ্যে মূল্য স্তরের তথ্য নেই এমন স্থানগুলি অন্তর্ভুক্ত, যেগুলি নির্দিষ্ট মূল্য স্তর দ্বারা ফিল্টার করার সময় ফেরত নাও যেতে পারে৷
• যদি এক বা একাধিক ফিল্টার প্রদান করা হয়: শুধুমাত্র নির্দিষ্ট মূল্য স্তর(গুলি) এর সাথে মেলে এমন স্থানগুলি ফেরত দেওয়া হয়৷

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

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

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

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