অটোমেটিক সম্পূর্ণ (নতুন) ফিচারে মাইগ্রেট করা

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

ভূমিকা

Places API-তে জায়গা অটোমেটিক সম্পূর্ণ করা (লিগ্যাসি) এবং কোয়েরি অটোমেটিক সম্পূর্ণ করা (লিগ্যাসি) API কাজ করে। আপনি এইসব API সম্পর্কে জানলে, অটোমেটিক সম্পূর্ণ করা (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:

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

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

বর্তমান প্যারামিটার নতুন প্যারামিটার নোট
components includedRegionCodes
language languageCode
location locationBias
ipbias আপনি locationBias ও locationRestriction, দুটিই বাদ দিলে, API ডিফল্ট হিসেবে IP বায়াসিং ব্যবহার করে।
offset inputOffset
radius locationBias বা locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

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

নিচে দেওয়া উদাহরণ GET অনুরোধে প্লেস অটোকমপ্লিট (Legacy) ব্যবহার করা হয়েছে। এই উদাহরণে, আপনি establishment ধরনের "Amoeba" নামের জায়গা সম্পর্কে তথ্য সহ JSON রেসপন্সের অনুরোধ করেন এবং URL প্যারামিটার হিসেবে সব প্যারামিটার পাস করেন:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

অটোমেটিক সম্পূর্ণ করার (নতুন) মাধ্যমে, আপনি একটি POST অনুরোধ করেন এবং JSON অনুরোধের বডিতে বা POST অনুরোধের অংশ হিসেবে হেডারে সমস্ত প্যারামিটার পাস করেন।

অটোকমপ্লিট (নতুন) অনুরোধের জন্য ফিল্ড মাস্কের প্রয়োজন নেই, তবে রেসপন্সে নির্দিষ্ট ফলাফল ফিল্টার করার জন্য এটি ব্যবহার করা যেতে পারে। যেমন, নিচের অনুরোধে ফিল্ড মাস্ক ব্যবহার করা হয়েছে, তাই উত্তরে শুধু সাজেশনের suggestions.placePrediction.text অন্তর্ভুক্ত করা হয়েছে:

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

ফিল্ড মাস্ক ব্যবহার করা সম্পর্কে আরও জানতে, স্থান সম্পর্কিত বিবরণ (নতুন) দেখুন।