Method: places.get

কোনো স্থানের রিসোর্স নামের উপর ভিত্তি করে তার বিস্তারিত তথ্য পান, যা places/{placeId} ফরম্যাটের একটি স্ট্রিং।

HTTP অনুরোধ

GET https://places.googleapis.com/v1/{name=places/*}

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
name

string

আবশ্যক। কোনো স্থানের রিসোর্স নাম, places/{placeId} ফরম্যাটে।

কোয়েরি প্যারামিটার

প্যারামিটার
languageCode

string

ঐচ্ছিক। উপলব্ধ থাকলে, স্থানের বিবরণ পছন্দের ভাষায় প্রদর্শিত হবে।

বর্তমানে সমর্থিত ভাষাগুলোর তালিকা: https://developers.google.com/maps/faq#languagesupport ।

regionCode

string

ঐচ্ছিক। অনুরোধটি যে স্থান থেকে আসছে, সেখানকার ইউনিকোড দেশ/অঞ্চল কোড (CLDR)। এই প্যারামিটারটি স্থানের বিবরণ, যেমন অঞ্চল-ভিত্তিক স্থানের নাম (যদি উপলব্ধ থাকে), প্রদর্শন করতে ব্যবহৃত হয়। প্রযোজ্য আইন অনুসারে এই প্যারামিটারটি ফলাফলের উপর প্রভাব ফেলতে পারে। আরও তথ্যের জন্য, দেখুন https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html ।

উল্লেখ্য যে, বর্তমানে ৩-সংখ্যার অঞ্চল কোড সমর্থিত নয়।

sessionToken

string

ঐচ্ছিক। একটি স্ট্রিং যা বিলিংয়ের উদ্দেশ্যে একটি অটোকমপ্লিট সেশন শনাক্ত করে। এটি অবশ্যই একটি URL এবং ফাইলের নাম-সুরক্ষিত বেস৬৪ স্ট্রিং হতে হবে, যার দৈর্ঘ্য সর্বাধিক ৩৬টি ASCII অক্ষর। অন্যথায় একটি INVALID_ARGUMENT ত্রুটি ফেরত দেওয়া হয়।

ব্যবহারকারী যখন কোনো কোয়েরি টাইপ করা শুরু করেন, তখন সেশনটি শুরু হয় এবং যখন তিনি একটি স্থান নির্বাচন করেন ও স্থানের বিবরণ (Place Details) বা ঠিকানা যাচাইকরণ (Address Validation)-এর জন্য কল করা হয়, তখন এটি শেষ হয়। প্রতিটি সেশনে একাধিক কোয়েরি থাকতে পারে, যার পরে একটি স্থানের বিবরণ বা ঠিকানা যাচাইকরণের অনুরোধ করা হয়। একটি সেশনের মধ্যে প্রতিটি অনুরোধের জন্য ব্যবহৃত ক্রেডেনশিয়াল অবশ্যই একই গুগল ক্লাউড কনসোল (Google Cloud Console) প্রজেক্টের অন্তর্গত হতে হবে। একবার একটি সেশন শেষ হয়ে গেলে, টোকেনটি আর বৈধ থাকে না; আপনার অ্যাপকে প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করতে হবে। যদি sessionToken প্যারামিটারটি বাদ দেওয়া হয়, অথবা যদি আপনি একটি সেশন টোকেন পুনরায় ব্যবহার করেন, তাহলে সেশনটির জন্য এমনভাবে চার্জ করা হবে যেন কোনো সেশন টোকেন প্রদান করা হয়নি (প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হয়)।

আমরা নিম্নলিখিত নির্দেশিকাগুলো সুপারিশ করছি:

  • সমস্ত প্লেস অটোকমপ্লিট কলের জন্য সেশন টোকেন ব্যবহার করুন।
  • প্রতিটি সেশনের জন্য একটি নতুন টোকেন তৈরি করুন। ভার্সন ৪ UUID ব্যবহার করার পরামর্শ দেওয়া হয়।
  • নিশ্চিত করুন যে একটি সেশনের মধ্যে সমস্ত প্লেস অটোকমপ্লিট, প্লেস ডিটেইলস এবং অ্যাড্রেস ভ্যালিডেশন অনুরোধের জন্য ব্যবহৃত ক্রেডেনশিয়ালগুলো একই ক্লাউড কনসোল প্রজেক্টের অন্তর্গত।
  • প্রতিটি নতুন সেশনের জন্য একটি অনন্য সেশন টোকেন প্রদান করতে ভুলবেন না। একাধিক সেশনের জন্য একই টোকেন ব্যবহার করলে প্রতিটি অনুরোধের জন্য আলাদাভাবে বিল করা হবে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশ অবশ্যই খালি হতে হবে।

প্রতিক্রিয়া সংস্থা

সফল হলে, রেসপন্স বডিতে Place এর একটি ইনস্ট্যান্স থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.places.details
  • https://www.googleapis.com/auth/maps-platform.places
  • https://www.googleapis.com/auth/cloud-platform