কাছাকাছি অনুসন্ধানে স্থানান্তরিত করুন (নতুন)

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

ভূমিকা

Places API Nearby Search (Legacy) সমর্থন করে। যদি আপনি Nearby Search (Legacy) এর সাথে পরিচিত হন, তাহলে Nearby Search (New) নিম্নলিখিত পরিবর্তনগুলি করে:

  • কাছাকাছি অনুসন্ধান (নতুন) HTTP POST অনুরোধ ব্যবহার করে। HTTP POST অনুরোধের অংশ হিসেবে অনুরোধের বডিতে বা হেডারে প্যারামিটারগুলি পাস করে। বিপরীতে, কাছাকাছি অনুসন্ধান (লিগ্যাসি) এর ক্ষেত্রে, আপনি HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটারগুলি পাস করেন।
  • ফিল্ড মাস্কিং আবশ্যক। প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত চান তা অবশ্যই উল্লেখ করতে হবে। ফেরত ক্ষেত্রগুলির কোনও ডিফল্ট তালিকা নেই। যদি আপনি এই তালিকাটি বাদ দেন, তাহলে পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, FieldMask দেখুন।
  • Nearby Search (New) প্রমাণীকরণ প্রক্রিয়া হিসেবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
  • কাছাকাছি অনুসন্ধান (নতুন) -এ শুধুমাত্র JSON একটি প্রতিক্রিয়া ফর্ম্যাট হিসাবে সমর্থিত।
  • টেক্সট কোয়েরি সহ সকল অনুরোধে এখন টেক্সট সার্চ (নতুন) ব্যবহার করা উচিত কারণ কাছাকাছি সার্চ (নতুন) টেক্সট ইনপুট সমর্থন করে না।
  • Nearby Search (New) এর JSON রেসপন্স ফর্ম্যাটটি লিগ্যাসি API গুলির ফর্ম্যাট থেকে পরিবর্তিত হয়েছে। আরও বিস্তারিত জানার জন্য, Places API রেসপন্স মাইগ্রেট করুন দেখুন।

নিচের টেবিলে Nearby Search (Legacy) এর প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে যেগুলি Nearby Search (New) এর জন্য পুনঃনামকরণ বা সংশোধন করা হয়েছে, অথবা যে প্যারামিটারগুলি আর সমর্থিত নয়।

বর্তমান প্যারামিটার নতুন প্যারামিটার মন্তব্য
keyword সমর্থিত নয়। পরিবর্তে টেক্সট সার্চ (নতুন) ব্যবহার করুন।
language languageCode
location locationRestriction প্রয়োজন।
maxprice/minprice সমর্থিত নয়।
maxResultCount নতুন প্যারামিটার।
opennow সমর্থিত নয়।
pagetoken সমর্থিত নয়।
radius এখনই locationRestriction ব্যবহার করুন।
rankby rankPreference
regionCode নতুন প্যারামিটার।
type includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes		 নতুন প্যারামিটারগুলি একাধিক ধরণের মান গ্রহণ করে। লিগ্যাসি API শুধুমাত্র একটি একক মান গ্রহণ করে।

উদাহরণ অনুরোধ

নিচের উদাহরণে GET অনুরোধটি Nearby Search (Legacy) ব্যবহার করে। এই উদাহরণে, আপনি একটি JSON প্রতিক্রিয়া অনুরোধ করেন যেখানে restaurant ধরণের স্থান সম্পর্কে তথ্য থাকে এবং সমস্ত পরামিতি URL প্যারামিটার হিসাবে পাস করেন:

curl -L -X GET \
'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'

কাছাকাছি অনুসন্ধান (নতুন) এর মাধ্যমে, আপনি একটি POST অনুরোধ করেন এবং POST অনুরোধের অংশ হিসাবে JSON অনুরোধের বডিতে বা হেডারগুলিতে সমস্ত প্যারামিটার পাস করেন। এই উদাহরণে একটি ফিল্ড মাস্কও ব্যবহার করা হয়েছে তাই প্রতিক্রিয়াতে কেবল স্থানের প্রদর্শন নাম এবং ফর্ম্যাট করা ঠিকানা অন্তর্ভুক্ত থাকে:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 37.7937,
        "longitude": -122.3965},
      "radius": 500.0
    }
  }
}' \
-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:searchNearby