ভূমিকা
প্লেসেস এপিআই (লেগ্যাসি) টেক্সট সার্চ (লেগ্যাসি) সমর্থন করে। আপনি যদি টেক্সট সার্চ (লেগ্যাসি)-এর সাথে পরিচিত হন, তাহলে টেক্সট সার্চ (নিউ) নিম্নলিখিত পরিবর্তনগুলি নিয়ে আসে:
- টেক্সট সার্চ (নিউ) HTTP POST রিকোয়েস্ট ব্যবহার করে। একটি HTTP POST রিকোয়েস্টের অংশ হিসেবে রিকোয়েস্ট বডিতে অথবা হেডারে প্যারামিটার পাস করুন। এর বিপরীতে, টেক্সট সার্চ (লেগ্যাসি)-তে, আপনি একটি HTTP GET রিকোয়েস্ট ব্যবহার করে URL প্যারামিটার পাস করেন।
- ফিল্ড মাস্কিং আবশ্যক। রেসপন্সে আপনি কোন ফিল্ডগুলো ফেরত পেতে চান, তা আপনাকে অবশ্যই নির্দিষ্ট করতে হবে। ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, তাহলে মেথডগুলো একটি এরর দেখাবে। আরও তথ্যের জন্য, FieldMask দেখুন।
- টেক্সট সার্চ (নতুন) প্রমাণীকরণ পদ্ধতি হিসেবে এপিআই কী এবং ওঅথ টোকেন উভয়ই সমর্থন করে।
- টেক্সট সার্চ (নতুন)-এ প্রতিক্রিয়া ফরম্যাট হিসেবে শুধুমাত্র JSON সমর্থিত।
টেক্সট সার্চ (লেগ্যাসি)-তে আপনি কোয়েরি স্ট্রিং-এ অক্ষাংশ এবং দ্রাঘিমাংশের স্থানাঙ্ক উল্লেখ করতে পারেন। উদাহরণস্বরূপ:
query=37.4239,-122.0925। টেক্সট সার্চ (নিউ)-তে এই অপশনটি সমর্থিত নয়।স্থানাঙ্কের ভিত্তিতে অনুসন্ধান করে ঠিকানা পেতে রিভার্স জিওকোডিং ব্যবহার করুন, অথবা কোনো নির্দিষ্ট অবস্থানের আশেপাশের স্থানগুলি খুঁজে পেতে নিয়ারবাই সার্চ (নতুন) ব্যবহার করুন।
- টেক্সট সার্চ (নতুন)-এর জন্য JSON রেসপন্স ফরম্যাটটি লিগ্যাসি API-গুলোর ফরম্যাট থেকে পরিবর্তিত হয়েছে। আরও বিস্তারিত জানতে, প্লেসেস API রেসপন্স মাইগ্রেট করুন দেখুন।
নিম্নলিখিত সারণিতে টেক্সট সার্চ (লেগ্যাসি)-এর সেই প্যারামিটারগুলোর তালিকা দেওয়া হয়েছে, যেগুলো টেক্সট সার্চ (নিউ)-এর জন্য নতুন নামকরণ বা পরিবর্তন করা হয়েছে, অথবা যেগুলো এখন আর সমর্থিত নয়।
| বর্তমান প্যারামিটার | নতুন প্যারামিটার | নোট |
|---|---|---|
evOptions | নতুন প্যারামিটার। | |
language | languageCode | |
location | locationBias | |
maxprice/minprice | priceLevels | |
opennow | openNow | |
pagetoken | pageToken | |
query | textQuery | সকল অনুরোধের ক্ষেত্রে আবশ্যক। |
radius | locationBias | locationBias নির্ধারণ করার সময় ব্যাসার্ধ নির্দিষ্ট করুন। |
region | regionCode | |
type | includedType | শুধুমাত্র একটি মান গ্রহণ করে। |
strictTypeFiltering | নতুন প্যারামিটার। |
উদাহরণ অনুরোধ
নিম্নলিখিত উদাহরণ GET অনুরোধটি টেক্সট সার্চ (লেগ্যাসি) ব্যবহার করে। এই উদাহরণে, আপনি 'Spicy Vegetarian Food in Sydney, Australia' সম্পর্কিত তথ্য সম্বলিত একটি JSON প্রতিক্রিয়ার জন্য অনুরোধ করছেন এবং সমস্ত প্যারামিটার URL প্যারামিটার হিসাবে পাস করছেন:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
টেক্সট সার্চ (নতুন) এর মাধ্যমে, আপনি একটি POST রিকোয়েস্ট পাঠান এবং সমস্ত প্যারামিটার JSON রিকোয়েস্ট বডিতে অথবা POST রিকোয়েস্টের অংশ হিসেবে হেডারে পাস করেন। এই উদাহরণটিতে একটি ফিল্ড মাস্কও ব্যবহার করা হয়েছে, ফলে রেসপন্সে শুধুমাত্র স্থানটির প্রদর্শিত নাম এবং ফরম্যাট করা ঠিকানা অন্তর্ভুক্ত থাকে:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'