'স্থান সম্পর্কিত বিবরণ (নতুন)' বিভাগে মাইগ্রেট করা

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA)-এর ডেভেলপার

ভূমিকা

Places API-তে জায়গার বিবরণ (পুরনো) কাজ করে। আপনি Places API (পুরনো) সম্পর্কে জানলে, জায়গার বিবরণ (নতুন) নিম্নলিখিত পরিবর্তনগুলি করে:

  • ফিল্ড মাস্কিং প্রয়োজন। উত্তরে আপনি কোন কোন ফিল্ড ফেরত চান তা আপনাকে নির্দিষ্ট করতে হবে। ফেরত আসা ফিল্ডের কোনও ডিফল্ট তালিকা নেই। আপনি এই তালিকা বাদ দিলে, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, FieldMask দেখুন।
  • Place Details (New) যাচাইকরণ পদ্ধতি হিসেবে API কী এবং OAuth টোকেন, দুটিকেই সাপোর্ট করে।
  • জায়গার বিবরণ (নতুন)-এ রেসপন্স ফর্ম্যাট হিসেবে শুধুমাত্র JSON কাজ করে।
  • Places API (নতুন)-এর জন্য JSON রেসপন্স ফর্ম্যাট পুরনো API-এর ফর্ম্যাট থেকে পরিবর্তিত হয়েছে। আরও জানতে, Places API রেসপন্স মাইগ্রেট করুন দেখুন।

নিম্নলিখিত সারণীতে Place Details (Legacy)-এর প্যারামিটারগুলি তালিকাভুক্ত করা হয়েছে যেগুলি Place Details (New)-এর জন্য নাম পরিবর্তন বা সংশোধন করা হয়েছে, অথবা যে প্যারামিটারগুলি আর কাজ করে না।

বর্তমান প্যারামিটার নতুন প্যারামিটার নোট
place_id places/PLACE_ID places/PLACE_ID স্ট্রিংটিকে জায়গার রিসোর্স নামও বলা হয়। জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) অনুরোধের উত্তরে, এই স্ট্রিং উত্তরের name ফিল্ডে থাকে। স্ট্যান্ডঅ্যালোন জায়গার আইডি উত্তরের id ফিল্ডে থাকে।
language languageCode
region regionCode

অনুরোধের উদাহরণ

নিম্নলিখিত উদাহরণ GET অনুরোধ, Place Details (Legacy) ব্যবহার করে। এই উদাহরণে, আপনি একটি 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 স্ট্রিংকে জায়গার রিসোর্স নামও বলা হয়। জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) অনুরোধের উত্তরে, এই স্ট্রিং উত্তরের name ফিল্ডে থাকে। স্ট্যান্ডঅ্যালোন প্লেস আইডি উত্তরের id ফিল্ডে থাকে।