নিয়ারবাই সার্চে (নতুন) মাইগ্রেট করা

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

ভূমিকা

Places API-তে নিয়ারবাই সার্চ (লিগ্যাসি) কাজ করে। আপনি যদি নিয়ারবাই Search (পুরনো) সম্পর্কে জানেন, তাহলে নিয়ারবাই Search (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:

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

নিম্নলিখিত সারণীতে নিয়ারবাই Search (Legacy)-এর প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে যেগুলি নিয়ারবাই Search (New)-এর জন্য নাম পরিবর্তন বা পরিবর্তন করা হয়েছে, অথবা প্যারামিটারগুলি আর কাজ করে না।

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

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

নিম্নলিখিত উদাহরণে GET অনুরোধ নিয়ারবাই 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'

নিয়ারবাই Search (নতুন) ফিচারের মাধ্যমে, আপনি একটি 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