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