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

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

ভূমিকা

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

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

Nearby Search (নতুন) ব্যবহার করে, আপনি একটি 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