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)
  },
  "includeFutureOpeningBusinesses": boolean
}
ক্ষেত্র
languageCode

string

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

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

regionCode

string

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

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

উল্লেখ্য যে, বর্তমানে ৩-সংখ্যার অঞ্চল কোড সমর্থিত নয়।

includedTypes[]

string

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

সারণি A থেকে সর্বোচ্চ ৫০টি প্রকার নির্দিষ্ট করা যেতে পারে।

যদি কোনো সাংঘর্ষিক টাইপ থাকে, অর্থাৎ কোনো টাইপ includedTypes এবং excludedTypes উভয় তালিকায়ই থাকে, তাহলে একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

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

excludedTypes[]

string

https://developers.google.com/maps/documentation/places/web-service/place-types থেকে বাদ দেওয়া স্থানের ধরণ (যেমন, 'restaurant' বা 'gas_station')।

সারণি A থেকে সর্বোচ্চ ৫০টি প্রকার নির্দিষ্ট করা যেতে পারে।

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

যদি কোনো সাংঘর্ষিক টাইপ থাকে, অর্থাৎ কোনো টাইপ includedTypes এবং excludedTypes উভয় তালিকায়ই থাকে, তাহলে একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

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

includedPrimaryTypes[]

string

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

সারণি A থেকে সর্বোচ্চ ৫০টি প্রকার নির্দিষ্ট করা যেতে পারে।

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

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

excludedPrimaryTypes[]

string

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

সারণি A থেকে সর্বোচ্চ ৫০টি প্রকার নির্দিষ্ট করা যেতে পারে।

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

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

maxResultCount

integer

ফেরত দেওয়ার জন্য ফলাফলের সর্বোচ্চ সংখ্যা। এটি অবশ্যই ১ থেকে ২০ (ডিফল্ট) এর মধ্যে হতে হবে। সংখ্যাটি সেট করা না থাকলে, এটি সর্বোচ্চ সীমায় ফিরে যাবে। সংখ্যাটি ঋণাত্মক হলে বা সর্বোচ্চ সীমা অতিক্রম করলে, একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

locationRestriction

object ( LocationRestriction )

আবশ্যক। অনুসন্ধানের জন্য অঞ্চল।

rankPreference

enum ( RankPreference )

প্রতিক্রিয়ায় ফলাফলগুলো কীভাবে ক্রমবিন্যাস করা হবে

routingParameters

object ( RoutingParameters )

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

includeFutureOpeningBusinesses

boolean

ঐচ্ছিক। যদি সত্য হয়, তবে সেই ব্যবসাগুলোও অন্তর্ভুক্ত করুন যেগুলো এখনও চালু হয়নি কিন্তু ভবিষ্যতে চালু হবে।

প্রতিক্রিয়া সংস্থা

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

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

JSON উপস্থাপনা 
{
  "places": [
    {
      object (Place)
    }
  ],
  "routingSummaries": [
    {
      object (RoutingSummary)
    }
  ]
}
ক্ষেত্র
places[]

object ( Place )

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

routingSummaries[]

object ( RoutingSummary )

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

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.places.nearbysearch
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform

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

অনুসন্ধান করার অঞ্চল।

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 )

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

র‍্যাঙ্কপ্রেফারেন্স

প্রতিক্রিয়ায় ফলাফলগুলো কীভাবে ক্রমবিন্যাস করা হবে

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