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