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

ইউরোপিয়ান ইকোনমিক এরিয়া (EEA) ডেভেলপার

ভূমিকা

Places API কাছাকাছি অনুসন্ধান (লেগেসি) সমর্থন করে। আপনি যদি কাছাকাছি অনুসন্ধান (উত্তরাধিকার) এর সাথে পরিচিত হন তবে কাছাকাছি অনুসন্ধান (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:

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

নিচের সারণীটি কাছাকাছি অনুসন্ধান (উত্তরাধিকার) এর প্যারামিটারগুলিকে তালিকাভুক্ত করে যেগুলি কাছাকাছি অনুসন্ধান (নতুন) এর জন্য পুনঃনামকরণ বা পরিবর্তন করা হয়েছে, বা যে প্যারামিটারগুলি আর সমর্থিত নয়৷

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

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

নিম্নলিখিত উদাহরণ GET অনুরোধ কাছাকাছি অনুসন্ধান (উত্তরাধিকার) ব্যবহার করে। এই উদাহরণে, আপনি 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