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

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

ভূমিকা

প্লেসেস এপিআই নিয়ারবাই সার্চ (লেগ্যাসি) সমর্থন করে। আপনি যদি নিয়ারবাই সার্চ (লেগ্যাসি)-এর সাথে পরিচিত হন, তবে নিয়ারবাই সার্চ (নিউ)-তে নিম্নলিখিত পরিবর্তনগুলি আনা হয়েছে:

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

নিম্নলিখিত সারণিতে 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		 নতুন প্যারামিটারগুলো একাধিক টাইপ ভ্যালুও গ্রহণ করে। পুরোনো এপিআই কেবল একটি ভ্যালু গ্রহণ করে।

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

নিম্নলিখিত উদাহরণ GET অনুরোধটি Nearby Search (Legacy) ব্যবহার করে। এই উদাহরণে, আপনি restaurant ধরনের স্থান সম্পর্কিত তথ্য সম্বলিত একটি JSON প্রতিক্রিয়ার জন্য অনুরোধ করছেন এবং সমস্ত প্যারামিটার 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 রিকোয়েস্ট পাঠান এবং সমস্ত প্যারামিটার JSON রিকোয়েস্ট বডিতে অথবা POST রিকোয়েস্টের অংশ হিসেবে হেডারে পাস করেন। এই উদাহরণটিতে একটি ফিল্ড মাস্কও ব্যবহার করা হয়েছে, ফলে রেসপন্সে শুধুমাত্র স্থানটির প্রদর্শিত নাম এবং ফরম্যাট করা ঠিকানা অন্তর্ভুক্ত থাকে:

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