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