Method: searchText

টেক্সট কোয়েরি ব্যবহার করে জায়গা সার্চ করুন।

HTTP অনুরোধ

POST https://mapstools.googleapis.com/v1:searchText

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

অনুরোধের বডি

অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "pageSize": integer,
  "includeExtendedDetails": boolean,
  "locationBias": {
    object (LocationBias)
  }
}
ফিল্ড
textQuery

string

প্রয়োজনীয়। টেক্সট কোয়েরি।

languageCode

string

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

যেমন, ইংরেজির জন্য "en"।

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

regionCode

string

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

যেমন, মার্কিন যুক্তরাষ্ট্রের জন্য "US"।

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

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

pageSize

integer

ঐচ্ছিক। সর্বাধিক ১০টি জায়গা রিটার্ন করা যাবে। পরিষেবাটি এই মানের চেয়ে কম রিটার্ন করতে পারে। ডিফল্ট ভ্যালু হল ৫।

৫টির বেশি জায়গার জন্য অনুরোধ করলে Pro টিয়ার ট্রিগার হবে এবং এর ফলে বিলিং খরচ ও লেটেন্সি বেশি হবে।

includeExtendedDetails

boolean

ঐচ্ছিক। উত্তরে জায়গার আরও বিবরণ অন্তর্ভুক্ত করে।

ব্যবহারকারীর অনুরোধে সমৃদ্ধ গুণগত ইনসাইট, রিয়েল-টাইম ডাইনামিক্স বা বিশেষ এন্টিটি অ্যাট্রিবিউটের প্রয়োজন হলে এই ফিল্ডটি true-এ সেট করুন: - গুণগত রিভিউ, গ্রাহকের মনোভাব এবং মতামত। - মেনু আইটেম, ডিশ, বিশেষ খাবার, পানীয় বা ব্যবসার হাইলাইটের মতো নির্দিষ্ট অফার। - গুণগত পরিবেশ, ইন্টিরিয়র ডেকর, নান্দনিকতা, পরিবেশ বা মুড। - রিয়েল-টাইম ডেটা এবং বিশেষ সুবিধার স্পেসিফিকেশন, ভিজিটর নীতি/পরামর্শ, অপেক্ষার সময়।

স্ট্যান্ডার্ড পরোক্ষ অনুসন্ধান (যেমন, ক্যুইজিন, স্টোরের ধরন), লোকেশন/ঠিকানা খোঁজা, পরিচিতির তথ্য, কর্মসময় এবং স্ট্যান্ডার্ড মেটাডেটা/সুযোগ-সুবিধার জন্য false (ডিফল্ট) ছেড়ে দিন।

এই ফিল্ড চালু করলে Pro টিয়ার ট্রিগার হবে এবং এর ফলে বিলিং খরচ ও লেটেন্সি বেশি হবে।

locationBias

object (LocationBias)

সার্চ ফলাফলকে প্রভাবিত করার জন্য একটি ঐচ্ছিক অঞ্চল। textQuery-এ কোনও সুনির্দিষ্ট লোকেশন থাকলে, এই ফিল্ডের পরিবর্তে সার্চ ফলাফলকে প্রভাবিত করতে এটি ব্যবহার করা হবে।

প্রতিক্রিয়ার বডি

সফল হলে, প্রতিক্রিয়ার বডিতে একটি SearchTextResponse-এর ইন্সট্যান্স থাকে।

অনুমোদনের স্কোপ

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

  • https://www.googleapis.com/auth/maps-platform.mapstools