ভূমিকা
Places API (Legacy) টেক্সট সার্চ (Legacy) সমর্থন করে। যদি আপনি টেক্সট সার্চ (Legacy) এর সাথে পরিচিত হন, তাহলে টেক্সট সার্চ (New) নিম্নলিখিত পরিবর্তনগুলি করে:
- টেক্সট সার্চ (নতুন) HTTP POST অনুরোধ ব্যবহার করে। HTTP POST অনুরোধের অংশ হিসেবে অনুরোধের বডিতে বা হেডারে প্যারামিটার পাস করে। বিপরীতে, টেক্সট সার্চ (লিগ্যাসি) এর ক্ষেত্রে, আপনি HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটার পাস করেন।
- ফিল্ড মাস্কিং আবশ্যক। প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত চান তা অবশ্যই উল্লেখ করতে হবে। ফেরত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। যদি আপনি এই তালিকাটি বাদ দেন, তাহলে পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, FieldMask দেখুন।
- টেক্সট সার্চ (নতুন) প্রমাণীকরণ প্রক্রিয়া হিসেবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
- টেক্সট সার্চ (নতুন) -এ শুধুমাত্র 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 অনুরোধটি টেক্সট সার্চ (লেগ্যাসি) ব্যবহার করে। এই উদাহরণে, আপনি "অস্ট্রেলিয়ায় সিডনিতে মশলাদার নিরামিষ খাবার" সম্পর্কে তথ্য সম্বলিত একটি 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 অনুরোধ তৈরি করেন এবং POST অনুরোধের অংশ হিসাবে JSON অনুরোধের বডিতে বা হেডারে সমস্ত প্যারামিটার পাস করেন। এই উদাহরণে একটি ফিল্ড মাস্কও ব্যবহার করা হয়েছে তাই প্রতিক্রিয়াতে কেবল স্থানের প্রদর্শন নাম এবং ফর্ম্যাট করা ঠিকানা অন্তর্ভুক্ত থাকে:
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'