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