Places API বিদ্যমান পাঠ্য অনুসন্ধান সমর্থন করে। আপনি যদি বিদ্যমান পাঠ্য অনুসন্ধানের সাথে পরিচিত হন তবে পাঠ্য অনুসন্ধানের নতুন সংস্করণ নিম্নলিখিত পরিবর্তনগুলি করে:
- নতুন পাঠ্য অনুসন্ধান HTTP POST অনুরোধগুলি ব্যবহার করে৷ একটি HTTP POST অনুরোধের অংশ হিসাবে অনুরোধের বডিতে বা হেডারে প্যারামিটারগুলি পাস করুন৷ বিপরীতে, বিদ্যমান পাঠ্য অনুসন্ধানের সাথে, আপনি একটি HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটার পাস করেন।
- ক্ষেত্র মাস্কিং প্রয়োজন. প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত দিতে চান তা অবশ্যই উল্লেখ করতে হবে। প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, ফিল্ডমাস্ক দেখুন।
- নতুন পাঠ্য অনুসন্ধান প্রমাণীকরণ প্রক্রিয়া হিসাবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
- নতুন পাঠ্য অনুসন্ধানে শুধুমাত্র JSON একটি প্রতিক্রিয়া বিন্যাস হিসাবে সমর্থিত।
বিদ্যমান পাঠ্য অনুসন্ধান আপনাকে কোয়েরি স্ট্রিং-এ অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক নির্দিষ্ট করতে দেয়। যেমন:
query=37.4239,-122.0925
। এই বিকল্পটি নতুন পাঠ্য অনুসন্ধানে সমর্থিত নয়।স্থানাঙ্ক অনুসন্ধান করতে এবং একটি ঠিকানা ফেরত দিতে বিপরীত জিওকোডিং ব্যবহার করুন, অথবা একটি নির্দিষ্ট অবস্থানের আশেপাশে স্থানগুলি খুঁজে পেতে কাছাকাছি অনুসন্ধান (নতুন) ব্যবহার করুন৷
- টেক্সট সার্চ (নতুন) API-এর জন্য JSON প্রতিক্রিয়া বিন্যাস বিদ্যমান API-এর বিন্যাস থেকে পরিবর্তিত হয়েছে। আরও বিশদ বিবরণের জন্য, স্থানান্তর করুন এপিআই প্রতিক্রিয়া দেখুন।
নিম্নলিখিত সারণীটি বিদ্যমান পাঠ্য অনুসন্ধানের পরামিতিগুলিকে তালিকাভুক্ত করে যা নতুন পাঠ্য অনুসন্ধানের জন্য পুনঃনামকরণ বা পরিবর্তন করা হয়েছে, বা পরামিতিগুলি যা আর সমর্থিত নয়।
বর্তমান পরামিতি | নতুন প্যারামিটার | নোট |
---|---|---|
evOptions | নতুন প্যারামিটার। | |
language | languageCode | |
location | locationBias | |
maxprice/minprice | priceLevels | |
opennow | openNow | |
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 অনুরোধ করেন এবং 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'