ভূমিকা
Places API , Place Autocomplete (Legacy) এবং Query Autocomplete (Legacy) API-গুলোকে সমর্থন করে। আপনি যদি এই API-গুলোর সাথে পরিচিত হন, তাহলে Autocomplete (New) নিম্নলিখিত পরিবর্তনগুলো এনেছে:
- অটোকমপ্লিট (নতুন) HTTP POST রিকোয়েস্ট ব্যবহার করে। একটি HTTP POST রিকোয়েস্টের অংশ হিসেবে রিকোয়েস্ট বডিতে অথবা হেডারে প্যারামিটার পাস করুন। এর বিপরীতে, পুরোনো API-গুলোর ক্ষেত্রে, একটি HTTP GET রিকোয়েস্ট ব্যবহার করে URL প্যারামিটার পাস করা হতো।
- অটোকমপ্লিট (নতুন) প্রমাণীকরণ পদ্ধতি হিসেবে এপিআই কী এবং ওঅথ টোকেন উভয়ই সমর্থন করে।
- অটোকমপ্লিট (নতুন)-এ প্রতিক্রিয়া বিন্যাস হিসাবে শুধুমাত্র JSON সমর্থিত।
নিম্নলিখিত সারণিতে প্লেস অটোকমপ্লিট (লেগ্যাসি) এবং কোয়েরি অটোকমপ্লিট (লেগ্যাসি)-এর সেই প্যারামিটারগুলোর তালিকা দেওয়া হয়েছে, যেগুলো অটোকমপ্লিট (নিউ)-এর জন্য নতুন নামকরণ বা পরিবর্তন করা হয়েছে, অথবা যেগুলো এখন আর সমর্থিত নয়।
| বর্তমান প্যারামিটার | নতুন প্যারামিটার | নোট |
|---|---|---|
components | includedRegionCodes | |
language | languageCode | |
location | locationBias | |
ipbias | আপনি যদি locationBias এবং locationRestriction উভয়ই বাদ দেন, তাহলে API ডিফল্টরূপে IP biasing ব্যবহার করে। | |
offset | inputOffset | |
radius | locationBias বা locationRestriction | |
region | regionCode | |
stricbounds | locationRestriction | |
sessiontoken | sessionToken | |
types | includedPrimaryTypes |
উদাহরণ অনুরোধ
নিম্নলিখিত উদাহরণ GET অনুরোধটি প্লেস অটোকমপ্লিট (লেগ্যাসি) ব্যবহার করে। এই উদাহরণে, আপনি 'অ্যামিবা' নামক স্থান সম্পর্কিত তথ্য সম্বলিত একটি JSON প্রতিক্রিয়ার জন্য অনুরোধ করছেন, যে স্থানগুলো establishment ধরনের এবং আপনি সমস্ত প্যারামিটার 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 রিকোয়েস্ট বডিতে অথবা হেডারে সমস্ত প্যারামিটার পাস করতে হবে।
অটোকমপ্লিট (নতুন) অনুরোধের জন্য ফিল্ড মাস্ক আবশ্যক নয়, কিন্তু রেসপন্সে নির্দিষ্ট ফলাফল ফিল্টার করার জন্য এটি ব্যবহার করা যেতে পারে। উদাহরণস্বরূপ, নিম্নলিখিত অনুরোধটিতে একটি ফিল্ড মাস্ক ব্যবহার করা হয়েছে, যার ফলে রেসপন্সে শুধুমাত্র সাজেশনের 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
ফিল্ড মাস্ক ব্যবহার সম্পর্কে আরও জানতে, স্থানের বিবরণ (নতুন) দেখুন।