ভূমিকা
Places API , Place Details (Legacy) সমর্থন করে। আপনি যদি Places API (Legacy)-এর সাথে পরিচিত হন, তাহলে Place Details (New) নিম্নলিখিত পরিবর্তনগুলি এনেছে:
- ফিল্ড মাস্কিং আবশ্যক। রেসপন্সে আপনি কোন ফিল্ডগুলো ফেরত পেতে চান, তা আপনাকে অবশ্যই নির্দিষ্ট করতে হবে। ফেরত আসা ফিল্ডগুলোর কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, তাহলে মেথডগুলো একটি এরর দেখাবে। আরও তথ্যের জন্য, FieldMask দেখুন।
- স্থানের বিবরণ (নতুন) প্রমাণীকরণ পদ্ধতি হিসেবে এপিআই কী এবং ওঅথ টোকেন উভয়ই সমর্থন করে।
- প্লেস ডিটেইলস (নতুন)-এ রেসপন্স ফরম্যাট হিসেবে শুধুমাত্র JSON সমর্থিত।
- Places API (New)-এর JSON রেসপন্স ফরম্যাটটি লিগ্যাসি API-গুলোর ফরম্যাট থেকে পরিবর্তিত হয়েছে। আরও বিস্তারিত জানতে, Places API রেসপন্স মাইগ্রেট করুন (Migrate the Places API response ) দেখুন।
নিম্নলিখিত সারণিতে প্লেস ডিটেইলস (লেগ্যাসি)-এর সেই প্যারামিটারগুলোর তালিকা দেওয়া হয়েছে, যেগুলো প্লেস ডিটেইলস (নিউ)-এর জন্য নতুন নামকরণ বা পরিবর্তন করা হয়েছে, অথবা যেগুলো এখন আর সমর্থিত নয়।
| বর্তমান প্যারামিটার | নতুন প্যারামিটার | নোট |
|---|---|---|
place_id | places/ PLACE_ID | places/ PLACE_ID স্ট্রিংটিকে প্লেস রিসোর্স নেম- ও বলা হয়। `Place Details (New)`, `Nearby Search (New)`, এবং `Text Search (New)` অনুরোধের রেসপন্সে, এই স্ট্রিংটি রেসপন্সের 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 স্ট্রিংটিকে প্লেস রিসোর্স নেম- ও বলা হয়। `Place Details (New)`, `Nearby Search (New)`, এবং `Text Search (New)` অনুরোধের রেসপন্সে, এই স্ট্রিংটি রেসপন্সের name ফিল্ডে থাকে। স্বতন্ত্র প্লেস আইডিটি রেসপন্সের id ফিল্ডে থাকে।