ভূমিকা
Places API-তে জায়গার বিবরণ (লিগ্যাসি) কাজ করে। আপনি যদি Places API (Legacy)-এর সাথে পরিচিত হন, তাহলে জায়গার বিবরণ (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:
- ফিল্ড মাস্কিং প্রয়োজন। উত্তরে কোন ফিল্ডগুলি ফেরত পেতে চান তা আপনাকে অবশ্যই উল্লেখ করতে হবে। রিটার্ন করা ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি এই তালিকা বাদ দিলে, মেথড একটি সমস্যা রিটার্ন করে। আরও তথ্যের জন্য, FieldMask দেখুন।
- প্লেস বিবরণ (নতুন) যাচাইকরণ পদ্ধতি হিসেবে API কী ও OAuth টোকেন, দুটিই ব্যবহার করা যায়।
- 'প্লেস বিবরণ (নতুন)' টুলে শুধু JSON ফর্ম্যাট কাজ করে।
- Places API (নতুন)-এর JSON উত্তর ফর্ম্যাট পুরনো API-এর ফর্ম্যাট থেকে পরিবর্তিত হয়েছে। আরও জানতে, Places API রেসপন্স মাইগ্রেট করুন।
নিম্নলিখিত সারণীতে Place Details (Legacy)-এর প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে যেগুলি Place Details (New)-এর জন্য নাম পরিবর্তন বা সংশোধন করা হয়েছে, অথবা যে প্যারামিটারগুলি আর কাজ করে না।
| বর্তমান প্যারামিটার | নতুন প্যারামিটার | নোট |
|---|---|---|
place_id |
places/PLACE_ID |
places/PLACE_ID স্ট্রিংটিকে
জায়গার রিসোর্স নেমও বলা হয়। জায়গার বিবরণ (নতুন),
আশেপাশের সার্চ (নতুন) ও টেক্সট সার্চ (নতুন)
অনুরোধের উত্তরে, এই স্ট্রিংটি উত্তরের name ফিল্ডে থাকে।
স্ট্যান্ডঅ্যালোন জায়গার আইডি উত্তরের id ফিল্ডে থাকে। |
language |
languageCode |
|
region |
regionCode |
অনুরোধের উদাহরণ
নিচে দেওয়া GET অনুরোধের উদাহরণে স্থান সম্পর্কিত বিবরণ (লিগ্যাসি) ব্যবহার করা হয়েছে। এই
উদাহরণে, আপনি একটি JSON রেসপন্স চেয়েছেন যাতে কোনও প্লেস আইডি সম্পর্কে তথ্য আছে এবং
URL প্যারামিটার হিসেবে সব প্যারামিটার পাস করেছেন। এই উদাহরণে fields-ও ব্যবহার করা হয়েছে, তাই
উত্তরে শুধুমাত্র জায়গার ডিসপ্লে নাম ও ফর্ম্যাট করা ঠিকানা রয়েছে:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
'স্থানের বিবরণ (নতুন)' ব্যবহার করে, আপনি একটি GET অনুরোধ করেন এবং অনুরোধের অংশ হিসেবে URL প্যারামিটার ও হেডার এ সব প্যারামিটার পাস করেন। এই উদাহরণে ফিল্ড মাস্কও ব্যবহার করা হয়েছে, তাই উত্তরে শুধুমাত্র জায়গার ডিসপ্লে নাম ও ফর্ম্যাট করা ঠিকানা দেখানো হয়েছে:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
places/PLACE_ID স্ট্রিংটিকে জায়গা
রিসোর্স নামও বলা হয়। জায়গার বিবরণ (নতুন),
আশেপাশের সার্চ (নতুন) ও টেক্সট সার্চ (নতুন) অনুরোধ থেকে পাওয়া উত্তরে, এই স্ট্রিংটি
উত্তরের name ফিল্ডে থাকে। স্ট্যান্ডঅ্যালোন প্লেস আইডিটি
উত্তরের id ফিল্ডে থাকে।