অবস্থানের কাছাকাছি স্থান অনুসন্ধান করুন.
HTTP অনুরোধ
POST https://places.googleapis.com/v1/places:searchNearby
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
JSON প্রতিনিধিত্ব |
---|
{ "languageCode": string, "regionCode": string, "includedTypes": [ string ], "excludedTypes": [ string ], "includedPrimaryTypes": [ string ], "excludedPrimaryTypes": [ string ], "maxResultCount": integer, "locationRestriction": { object ( |
ক্ষেত্র | |
---|---|
language Code | উপলব্ধ থাকলে পছন্দের ভাষার সাথে স্থানের বিবরণ প্রদর্শিত হবে। ভাষা কোড অনির্দিষ্ট বা অচেনা হলে, যেকোন ভাষার স্থানের বিবরণ ফেরত দেওয়া যেতে পারে, যদি এই ধরনের বিবরণ বিদ্যমান থাকে তবে ইংরেজিকে অগ্রাধিকার দেওয়া হবে। সমর্থিত ভাষার বর্তমান তালিকা: https://developers.google.com/maps/faq#languagesupport । |
region Code | যে জায়গা থেকে অনুরোধ আসছে তার ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি স্থানের বিবরণ প্রদর্শন করতে ব্যবহার করা হয়, যেমন অঞ্চল-নির্দিষ্ট স্থানের নাম, যদি উপলব্ধ থাকে। প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে। আরও তথ্যের জন্য, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html দেখুন। মনে রাখবেন যে 3-সংখ্যার অঞ্চল কোডগুলি বর্তমানে সমর্থিত নয়৷ |
included Types[] | https://developers.google.com/maps/documentation/places/web-service/place-types থেকে স্থানের ধরন (যেমন, "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") অন্তর্ভুক্ত। সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে। যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি প্রকার অন্তর্ভুক্ত টাইপ এবং বাদ দেওয়া উভয় প্রকারে উপস্থিত হয়, একটি INVALID_ARGUMENT ত্রুটি প্রদান করা হয়। যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না। |
excluded Types[] | https://developers.google.com/maps/documentation/places/web-service/place-types থেকে স্থানের প্রকার (যেমন, "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") বাদ দেওয়া হয়েছে। সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে। যদি ক্লায়েন্ট অন্তর্ভুক্ত প্রকার (যেমন রেস্তোরাঁ) এবং বহিষ্কৃত প্রকার (যেমন ক্যাফে) উভয়ই প্রদান করে, তাহলে প্রতিক্রিয়াতে এমন জায়গাগুলি অন্তর্ভুক্ত করা উচিত যেগুলি রেস্টুরেন্ট কিন্তু ক্যাফে নয়। প্রতিক্রিয়ার মধ্যে এমন স্থানগুলি অন্তর্ভুক্ত রয়েছে যা অন্তর্ভুক্ত প্রকারগুলির মধ্যে অন্তত একটির সাথে মেলে এবং বাদ দেওয়া প্রকারগুলির একটির সাথেও মেলে না৷ যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি প্রকার অন্তর্ভুক্ত টাইপ এবং বাদ দেওয়া উভয় প্রকারে উপস্থিত হয়, একটি INVALID_ARGUMENT ত্রুটি প্রদান করা হয়। যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না। |
included Primary Types[] | https://developers.google.com/maps/documentation/places/web-service/place-types থেকে প্রাথমিক স্থানের প্রকার (যেমন "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") অন্তর্ভুক্ত। একটি স্থানের সাথে যুক্ত সমর্থিত প্রকার সারণী থেকে শুধুমাত্র একটি প্রাথমিক প্রকার থাকতে পারে। সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে। যদি কোন বিরোধপূর্ণ প্রাথমিক প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত প্রাইমারি টাইপস এবং বাদ দেওয়া প্রাইমারি টাইপ উভয় ক্ষেত্রেই প্রদর্শিত হয়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়৷ যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না। |
excluded Primary Types[] | https://developers.google.com/maps/documentation/places/web-service/place-types থেকে প্রাথমিক স্থানের প্রকার (যেমন "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") বাদ দেওয়া হয়েছে। সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে। যদি কোন বিরোধপূর্ণ প্রাথমিক প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত প্রাইমারি টাইপস এবং বাদ দেওয়া প্রাইমারি টাইপ উভয় ক্ষেত্রেই প্রদর্শিত হয়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়৷ যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না। |
max Result Count | ফলাফলের সর্বাধিক সংখ্যা ফেরত দিতে। এটি অবশ্যই 1 এবং 20 এর মধ্যে হতে হবে (ডিফল্ট), সমেত। যদি নম্বরটি সেট না করা থাকে তবে এটি উপরের সীমাতে ফিরে আসে। সংখ্যাটি ঋণাত্মক সেট করা থাকলে বা উপরের সীমা অতিক্রম করলে, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়। |
location Restriction | প্রয়োজন। অঞ্চল অনুসন্ধান. |
rank Preference | কিভাবে ফলাফল প্রতিক্রিয়া র্যাঙ্ক করা হবে. |
routing Parameters | ঐচ্ছিক। পরামিতি যা অনুসন্ধান ফলাফলের রাউটিংকে প্রভাবিত করে। |
প্রতিক্রিয়া শরীর
কাছাকাছি অনুসন্ধানের জন্য প্রতিক্রিয়া প্রোটো.
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{ "places": [ { object ( |
ক্ষেত্র | |
---|---|
places[] | জায়গাগুলির একটি তালিকা যা ব্যবহারকারীর প্রয়োজনীয়তা পূরণ করে যেমন জায়গার ধরন, স্থানের সংখ্যা এবং নির্দিষ্ট অবস্থানের সীমাবদ্ধতা। |
routing Summaries[] | রাউটিং সারাংশের একটি তালিকা যেখানে প্রতিটি এন্ট্রি |
অবস্থান সীমাবদ্ধতা
অঞ্চল অনুসন্ধান.
JSON প্রতিনিধিত্ব |
---|
{ // Union field |
ক্ষেত্র | |
---|---|
ইউনিয়ন ক্ষেত্রের | |
circle | কেন্দ্র বিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত। |
র্যাঙ্ক পছন্দ
কিভাবে ফলাফল প্রতিক্রিয়া র্যাঙ্ক করা হবে.
Enums | |
---|---|
RANK_PREFERENCE_UNSPECIFIED | RankPreference মান সেট করা হয়নি। ডিফল্টরূপে POPULARITY দ্বারা র্যাঙ্ক ব্যবহার করবে৷ |
DISTANCE | দূরত্ব অনুসারে ফলাফলের ক্রম। |
POPULARITY | জনপ্রিয়তার ভিত্তিতে রেঙ্ক ফলাফল। |