Places API বিদ্যমান স্থানের বিবরণ সমর্থন করে। আপনি যদি বিদ্যমান Places API-এর সাথে পরিচিত হন, তাহলে স্থানের বিবরণের নতুন সংস্করণ নিম্নলিখিত পরিবর্তনগুলি করে:
- ক্ষেত্র মাস্কিং প্রয়োজন. প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত দিতে চান তা অবশ্যই উল্লেখ করতে হবে। প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, ফিল্ডমাস্ক দেখুন।
- নতুন স্থানের বিবরণ প্রমাণীকরণ প্রক্রিয়া হিসাবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
- নতুন স্থানের বিবরণে শুধুমাত্র JSON একটি প্রতিক্রিয়া বিন্যাস হিসেবে সমর্থিত।
- স্থানের বিবরণ (নতুন) API-এর জন্য JSON প্রতিক্রিয়া বিন্যাসটি বিদ্যমান API-এর বিন্যাস থেকে পরিবর্তিত হয়েছে। আরও বিশদ বিবরণের জন্য, স্থানান্তর করুন এপিআই প্রতিক্রিয়া দেখুন।
নিম্নলিখিত সারণীটি বিদ্যমান স্থানের বিশদ বিবরণে পরামিতিগুলিকে তালিকাভুক্ত করে যা নতুন স্থানের বিশদ বিবরণের জন্য পুনঃনামকরণ বা পরিবর্তন করা হয়েছে, বা প্যারামিটারগুলি যা আর সমর্থিত নয়৷
| বর্তমান পরামিতি | নতুন প্যারামিটার | নোট |
|---|---|---|
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 ক্ষেত্রের মধ্যে রয়েছে।
Places API বিদ্যমান স্থানের বিবরণ সমর্থন করে। আপনি যদি বিদ্যমান Places API-এর সাথে পরিচিত হন, তাহলে স্থানের বিবরণের নতুন সংস্করণ নিম্নলিখিত পরিবর্তনগুলি করে:
- ক্ষেত্র মাস্কিং প্রয়োজন. প্রতিক্রিয়ায় আপনি কোন ক্ষেত্রগুলি ফেরত দিতে চান তা অবশ্যই উল্লেখ করতে হবে। প্রত্যাবর্তিত ক্ষেত্রের কোনো ডিফল্ট তালিকা নেই। আপনি যদি এই তালিকাটি বাদ দেন, পদ্ধতিগুলি একটি ত্রুটি ফেরত দেয়। আরও তথ্যের জন্য, ফিল্ডমাস্ক দেখুন।
- নতুন স্থানের বিবরণ প্রমাণীকরণ প্রক্রিয়া হিসাবে API কী এবং OAuth টোকেন উভয়কেই সমর্থন করে।
- নতুন স্থানের বিবরণে শুধুমাত্র JSON একটি প্রতিক্রিয়া বিন্যাস হিসেবে সমর্থিত।
- স্থানের বিবরণ (নতুন) API-এর জন্য JSON প্রতিক্রিয়া বিন্যাসটি বিদ্যমান API-এর বিন্যাস থেকে পরিবর্তিত হয়েছে। আরও বিশদ বিবরণের জন্য, স্থানান্তর করুন এপিআই প্রতিক্রিয়া দেখুন।
নিম্নলিখিত সারণীটি বিদ্যমান স্থানের বিশদ বিবরণে পরামিতিগুলিকে তালিকাভুক্ত করে যা নতুন স্থানের বিশদ বিবরণের জন্য পুনঃনামকরণ বা পরিবর্তন করা হয়েছে, বা প্যারামিটারগুলি যা আর সমর্থিত নয়৷
| বর্তমান পরামিতি | নতুন প্যারামিটার | নোট |
|---|---|---|
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 ক্ষেত্রের মধ্যে রয়েছে।