টেক্সট কোয়েরি ব্যবহার করে জায়গা সার্চ করুন।
HTTP অনুরোধ
POST https://mapstools.googleapis.com/v1alpha:searchText
URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।
অনুরোধের বডি
অনুরোধের প্রধান অংশে নিম্নলিখিত স্ট্রাকচার সহ ডেটা থাকে:
| JSON উপস্থাপনা |
|---|
{
"textQuery": string,
"languageCode": string,
"regionCode": string,
"pageSize": integer,
"includeExtendedDetails": boolean,
"locationBias": {
object ( |
| ফিল্ড | |
|---|---|
textQuery |
প্রয়োজনীয়। টেক্সট কোয়েরি। |
languageCode |
ঐচ্ছিক। যে ভাষায় সারসংক্ষেপ চান সেই ভাষা। ভাষার কোড নির্দিষ্ট করা না থাকলে বা শনাক্ত করা না গেলে, সারসংক্ষেপের জন্য ইংরেজি ভাষাকে অগ্রাধিকার দেওয়া হবে। যেমন, ইংরেজির জন্য "en"। বর্তমানে যেসব ভাষা কাজ করে তার তালিকা: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
ঐচ্ছিক। যে লোকেশন থেকে অনুরোধ আসছে সেটির ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি জায়গার বিবরণ দেখানোর জন্য ব্যবহার করা হয়, যেমন অঞ্চল-নির্দিষ্ট জায়গার নাম, যদি উপলভ্য থাকে। প্রযোজ্য আইনের উপর ভিত্তি করে প্যারামিটার ফলাফলে প্রভাব ফেলতে পারে। যেমন, মার্কিন যুক্তরাষ্ট্রের জন্য "US"। আরও তথ্যের জন্য, https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html দেখুন। মনে রাখবেন, ৩-সংখ্যার অঞ্চল কোড বর্তমানে কাজ করে না। |
pageSize |
ঐচ্ছিক। সর্বাধিক ১০টি জায়গা রিটার্ন করা যাবে। পরিষেবাটি এই মানের চেয়ে কম রিটার্ন করতে পারে। ডিফল্ট ভ্যালু হল ৫। ৫টির বেশি জায়গার জন্য অনুরোধ করলে Pro টিয়ার ট্রিগার হবে এবং এর ফলে বিলিং খরচ ও লেটেন্সি বেশি হবে। |
includeExtendedDetails |
ঐচ্ছিক। উত্তরে জায়গার আরও বিবরণ অন্তর্ভুক্ত করে। ব্যবহারকারীর অনুরোধে সমৃদ্ধ গুণগত ইনসাইট, রিয়েল-টাইম ডাইনামিক্স বা বিশেষ এন্টিটি অ্যাট্রিবিউটের প্রয়োজন হলে এই ফিল্ডটি স্ট্যান্ডার্ড পরোক্ষ অনুসন্ধান (যেমন, ক্যুইজিন, স্টোরের ধরন), লোকেশন/ঠিকানা খোঁজা, পরিচিতির তথ্য, কর্মসময় এবং স্ট্যান্ডার্ড মেটাডেটা/সুযোগ-সুবিধার জন্য এই ফিল্ড চালু করলে Pro টিয়ার ট্রিগার হবে এবং এর ফলে বিলিং খরচ ও লেটেন্সি বেশি হবে। |
locationBias |
সার্চ ফলাফলকে প্রভাবিত করার জন্য একটি ঐচ্ছিক অঞ্চল। |
প্রতিক্রিয়ার বডি
সফল হলে, প্রতিক্রিয়ার বডিতে একটি SearchTextResponse-এর ইন্সট্যান্স থাকে।
অনুমোদনের স্কোপ
এটির জন্য নিম্নলিখিত OAuth স্কোপ প্রয়োজন:
https://www.googleapis.com/auth/maps-platform.mapstools