Places API বিদ্যমান কাছাকাছি অনুসন্ধান সমর্থন করে৷ আপনি যদি বিদ্যমান কাছাকাছি অনুসন্ধানের সাথে পরিচিত হন, তাহলে কাছাকাছি অনুসন্ধানের নতুন সংস্করণ নিম্নলিখিত পরিবর্তনগুলি করে:
- নতুন কাছাকাছি অনুসন্ধান HTTP POST অনুরোধগুলি ব্যবহার করে৷ একটি HTTP POST অনুরোধের অংশ হিসাবে অনুরোধের বডিতে বা হেডারে প্যারামিটারগুলি পাস করুন৷ বিপরীতে, বিদ্যমান কাছাকাছি অনুসন্ধানের সাথে, আপনি একটি HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটার পাস করেন।
- ক্ষেত্র মাস্কিং প্রয়োজন. প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত দিতে চান তা অবশ্যই উল্লেখ করতে হবে। প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, ফিল্ডমাস্ক দেখুন।
- নতুন কাছাকাছি অনুসন্ধান প্রমাণীকরণ প্রক্রিয়া হিসাবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
- নতুন কাছাকাছি অনুসন্ধানে শুধুমাত্র JSON একটি প্রতিক্রিয়া বিন্যাস হিসাবে সমর্থিত।
- একটি পাঠ্য ক্যোয়ারী অন্তর্ভুক্ত সমস্ত অনুরোধ এখন পাঠ্য অনুসন্ধান (নতুন) ব্যবহার করা উচিত কারণ কাছাকাছি অনুসন্ধান (নতুন) পাঠ্য ইনপুট সমর্থন করে না।
- নিকটবর্তী অনুসন্ধান (নতুন) API-এর জন্য JSON প্রতিক্রিয়া বিন্যাস বিদ্যমান API-এর বিন্যাস থেকে পরিবর্তিত হয়েছে। আরও বিশদ বিবরণের জন্য, স্থানান্তর করুন এপিআই প্রতিক্রিয়া দেখুন।
নিম্নলিখিত সারণীটি বিদ্যমান আশেপাশের অনুসন্ধানের প্যারামিটারগুলিকে তালিকাভুক্ত করে যা নতুন আশেপাশের অনুসন্ধানের জন্য পুনঃনামকরণ বা সংশোধন করা হয়েছে, বা প্যারামিটারগুলি যা আর সমর্থিত নয়৷
বর্তমান পরামিতি | নতুন প্যারামিটার | নোট |
---|---|---|
keyword | সমর্থিত নয়। পরিবর্তে পাঠ্য অনুসন্ধান (নতুন) ব্যবহার করুন। | |
language | languageCode | |
location | locationRestriction | প্রয়োজন। |
maxprice/minprice |
| সমর্থিত নয়। |
maxResultCount | নতুন প্যারামিটার। | |
opennow |
| সমর্থিত নয়। |
pagetoken | সমর্থিত নয়। | |
radius |
| এখন locationRestriction ব্যবহার করুন। |
rankby | rankPreference | |
regionCode | নতুন প্যারামিটার। | |
type | includedTypes excludedTypes includedPrimaryTypes excludedPrimaryTypes | নতুন প্যারামিটারগুলি একাধিক প্রকারের মানও গ্রহণ করে। বিদ্যমান API শুধুমাত্র একটি একক মান গ্রহণ করে। |
উদাহরণ অনুরোধ
নিম্নলিখিত উদাহরণ GET অনুরোধ বিদ্যমান কাছাকাছি অনুসন্ধান ব্যবহার করে. এই উদাহরণে, আপনি 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'
কাছাকাছি অনুসন্ধান (নতুন), আপনি একটি 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