Method: places.searchNearby

অবস্থানের কাছাকাছি স্থান অনুসন্ধান করুন.

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 (LocationRestriction)
  },
  "rankPreference": enum (RankPreference),
  "routingParameters": {
    object (RoutingParameters)
  }
}
ক্ষেত্র
language Code

string

উপলব্ধ থাকলে পছন্দের ভাষার সাথে স্থানের বিবরণ প্রদর্শিত হবে। ভাষা কোড অনির্দিষ্ট বা অচেনা হলে, যেকোন ভাষার স্থানের বিবরণ ফেরত দেওয়া যেতে পারে, যদি এই ধরনের বিবরণ বিদ্যমান থাকে তবে ইংরেজিকে অগ্রাধিকার দেওয়া হবে।

সমর্থিত ভাষার বর্তমান তালিকা: https://developers.google.com/maps/faq#languagesupport

region Code

string

যে জায়গা থেকে অনুরোধ আসছে তার ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি স্থানের বিবরণ প্রদর্শন করতে ব্যবহার করা হয়, যেমন অঞ্চল-নির্দিষ্ট স্থানের নাম, যদি উপলব্ধ থাকে। প্যারামিটার প্রযোজ্য আইনের উপর ভিত্তি করে ফলাফলকে প্রভাবিত করতে পারে।

আরও তথ্যের জন্য, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html দেখুন।

মনে রাখবেন যে 3-সংখ্যার অঞ্চল কোডগুলি বর্তমানে সমর্থিত নয়৷

included Types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types থেকে স্থানের ধরন (যেমন, "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") অন্তর্ভুক্ত।

সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে।

যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি প্রকার অন্তর্ভুক্ত টাইপ এবং বাদ দেওয়া উভয় প্রকারে উপস্থিত হয়, একটি INVALID_ARGUMENT ত্রুটি প্রদান করা হয়।

যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না।

excluded Types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types থেকে স্থানের প্রকার (যেমন, "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") বাদ দেওয়া হয়েছে।

সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে।

যদি ক্লায়েন্ট অন্তর্ভুক্ত প্রকার (যেমন রেস্তোরাঁ) এবং বহিষ্কৃত প্রকার (যেমন ক্যাফে) উভয়ই প্রদান করে, তাহলে প্রতিক্রিয়াতে এমন জায়গাগুলি অন্তর্ভুক্ত করা উচিত যেগুলি রেস্টুরেন্ট কিন্তু ক্যাফে নয়। প্রতিক্রিয়ার মধ্যে এমন স্থানগুলি অন্তর্ভুক্ত রয়েছে যা অন্তর্ভুক্ত প্রকারগুলির মধ্যে অন্তত একটির সাথে মেলে এবং বাদ দেওয়া প্রকারগুলির একটির সাথেও মেলে না৷

যদি কোনো পরস্পরবিরোধী প্রকার থাকে, যেমন একটি প্রকার অন্তর্ভুক্ত টাইপ এবং বাদ দেওয়া উভয় প্রকারে উপস্থিত হয়, একটি INVALID_ARGUMENT ত্রুটি প্রদান করা হয়।

যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না।

included Primary Types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types থেকে প্রাথমিক স্থানের প্রকার (যেমন "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") অন্তর্ভুক্ত। একটি স্থানের সাথে যুক্ত সমর্থিত প্রকার সারণী থেকে শুধুমাত্র একটি প্রাথমিক প্রকার থাকতে পারে।

সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে।

যদি কোন বিরোধপূর্ণ প্রাথমিক প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত প্রাইমারি টাইপস এবং বাদ দেওয়া প্রাইমারি টাইপ উভয় ক্ষেত্রেই প্রদর্শিত হয়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়৷

যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না।

excluded Primary Types[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types থেকে প্রাথমিক স্থানের প্রকার (যেমন "রেস্তোরাঁ" বা "গ্যাস_স্টেশন") বাদ দেওয়া হয়েছে।

সারণি A থেকে 50 প্রকার পর্যন্ত নির্দিষ্ট করা যেতে পারে।

যদি কোন বিরোধপূর্ণ প্রাথমিক প্রকার থাকে, যেমন একটি টাইপ অন্তর্ভুক্ত প্রাইমারি টাইপস এবং বাদ দেওয়া প্রাইমারি টাইপ উভয় ক্ষেত্রেই প্রদর্শিত হয়, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়৷

যদি একটি স্থানের ধরন একাধিক প্রকারের বিধিনিষেধের সাথে নির্দিষ্ট করা হয়, তবে শুধুমাত্র সেই স্থানগুলি ফেরত দেওয়া হবে যা সমস্ত বিধিনিষেধ পূরণ করে। উদাহরণস্বরূপ, যদি আমাদের কাছে {includedTypes = ["restaurant"], excludedPrimaryTypes = ["restaurant"]} থাকে, তাহলে প্রত্যাবর্তিত স্থানগুলি "রেস্তোরাঁ" সম্পর্কিত পরিষেবা প্রদান করে কিন্তু প্রাথমিকভাবে "রেস্তোরাঁ" হিসাবে কাজ করে না।

max Result Count

integer

ফলাফলের সর্বাধিক সংখ্যা ফেরত দিতে। এটি অবশ্যই 1 এবং 20 এর মধ্যে হতে হবে (ডিফল্ট), সমেত। যদি নম্বরটি সেট না করা থাকে তবে এটি উপরের সীমাতে ফিরে আসে। সংখ্যাটি ঋণাত্মক সেট করা থাকলে বা উপরের সীমা অতিক্রম করলে, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

location Restriction

object ( LocationRestriction )

প্রয়োজন। অঞ্চল অনুসন্ধান.

rank Preference

enum ( RankPreference )

কিভাবে ফলাফল প্রতিক্রিয়া র্যাঙ্ক করা হবে.

routing Parameters

object ( RoutingParameters )

ঐচ্ছিক। পরামিতি যা অনুসন্ধান ফলাফলের রাউটিংকে প্রভাবিত করে।

প্রতিক্রিয়া শরীর

কাছাকাছি অনুসন্ধানের জন্য প্রতিক্রিয়া প্রোটো.

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
ক্ষেত্র
places[]

object ( Place )

জায়গাগুলির একটি তালিকা যা ব্যবহারকারীর প্রয়োজনীয়তা পূরণ করে যেমন জায়গার ধরন, স্থানের সংখ্যা এবং নির্দিষ্ট অবস্থানের সীমাবদ্ধতা।

routing Summaries[]

object ( RoutingSummary )

রাউটিং সারাংশের একটি তালিকা যেখানে প্রতিটি এন্ট্রি places ক্ষেত্রে একই সূচকে সংশ্লিষ্ট স্থানে সংযুক্ত করে। যদি রাউটিং সারাংশ স্থানগুলির একটির জন্য উপলব্ধ না হয় তবে এটিতে একটি খালি এন্ট্রি থাকবে৷ অনুরোধ করা হলে এই তালিকায় স্থানের তালিকার মতো অনেকগুলি এন্ট্রি থাকা উচিত৷

অবস্থান সীমাবদ্ধতা

অঞ্চল অনুসন্ধান.

JSON প্রতিনিধিত্ব
{

  // Union field type can be only one of the following:
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
ক্ষেত্র

ইউনিয়ন ক্ষেত্রের type

type নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:

circle

object ( Circle )

কেন্দ্র বিন্দু এবং ব্যাসার্ধ দ্বারা সংজ্ঞায়িত একটি বৃত্ত।

র‍্যাঙ্ক পছন্দ

কিভাবে ফলাফল প্রতিক্রিয়া র্যাঙ্ক করা হবে.

Enums
RANK_PREFERENCE_UNSPECIFIED RankPreference মান সেট করা হয়নি। ডিফল্টরূপে POPULARITY দ্বারা র্যাঙ্ক ব্যবহার করবে৷
DISTANCE দূরত্ব অনুসারে ফলাফলের ক্রম।
POPULARITY জনপ্রিয়তার ভিত্তিতে রেঙ্ক ফলাফল।