Places API (নতুন) হল একটি ওয়েব পরিষেবা যা প্রতিষ্ঠান, ভৌগোলিক লোকেশন এবং আগ্রহের জায়গা সম্পর্কে JSON লোকেশন ডেটা প্রদান করে। এটি টেক্সট সার্চ (নতুন), নিয়ারবাই সার্চ (নতুন), অটো-কমপ্লিট (নতুন), জায়গার বিবরণ (নতুন) এবং জায়গার ফটো (নতুন) ফিচারকে সাপোর্ট করে।
Places API (নতুন): গুরুত্বপূর্ণ তথ্য
- প্রোডাক্ট: Places API (নতুন)
- এছাড়াও এই নামে পরিচিত: Places API
- বিভাগ: জায়গা
- প্ল্যাটফর্ম: ওয়েব পরিষেবা (REST)
- রান করে: সার্ভার (ব্যাকএন্ড কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Places API (নতুন) এক নজরে
- আঞ্চলিক উপলভ্যতা: বিশ্বব্যাপী। EEA বিলিং অ্যাড্রেস সহ প্রোজেক্টগুলি Google Maps Platform EEA পরিষেবার শর্তাবলী (৮ জুলাই ২০২৫ থেকে কার্যকর) ব্যবহার করে, যেখানে অক্ষাংশ, দ্রাঘিমাংশ এবং স্থান আইডি ছাড়া Places API কন্টেন্ট Places UI Kit ছাড়া অন্য কোনও ম্যাপের সাথে ব্যবহার করা যাবে না। AI-পরিচালিত জায়গা, রিভিউ ও এলাকার সারসংক্ষেপ শুধুমাত্র কাজ করে এমন ভাষা ও অঞ্চলে উপলভ্য।
Places API (নতুন): এটি কখন ব্যবহার করবেন
Places API (নতুন) ব্যবহার করুন যখন:
- আপনাকে টেক্সট কোয়েরি (টেক্সট সার্চ (নতুন)) বা কোনও লোকেশনের আশেপাশে (নিয়ারবাই সার্চ (নতুন)) ব্যবহার করে সার্ভার থেকে জায়গা সার্চ করতে হবে।
- আপনাকে অটোকমপ্লিট (নতুন) ফিচারের মাধ্যমে ব্যাকএন্ড থেকে টাইপ-অ্যাহেড জায়গা বা কোয়েরি সংক্রান্ত পূর্বাভাস পেতে হবে।
- আপনার কাছে কোনও জায়গার আইডি আছে এবং ঠিকানা, ফোন নম্বর, রেটিং, রিভিউ বা ফটোর মতো বিবরণ প্রয়োজন।
- কোনও জায়গার জন্য আপনার AI-পরিচালিত জায়গা, রিভিউ বা এলাকার সারসংক্ষেপ প্রয়োজন।
Places API (নতুন) ব্যবহার করবেন না যখন:
- আপনি একটি নেটিভ Android অ্যাপ তৈরি করছেন। এর পরিবর্তে Android-এর জন্য Places SDK ব্যবহার করুন।
- আপনি একটি নেটিভ iOS অ্যাপ তৈরি করছেন। এর পরিবর্তে iOS-এর জন্য Places SDK ব্যবহার করুন।
- আপনি একটি ব্রাউজার ওয়েব অ্যাপ তৈরি করছেন এবং জাভাস্ক্রিপ্টে Places লাইব্রেরি লোড করতে চান। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
Places API (New): setup
- পরিষেবা চালু করতে:
places.googleapis.com - যাচাইকরণ: API key, OAuth 2.0
- শুরু করুন: Places API (নতুন) সেট-আপ করুন
- রেফারেন্স: Places API (নতুন) রেফারেন্স
- দাম: Places API (নতুন) ব্যবহার ও বিলিং
- নীতি: Places API (নতুন) নীতি
- রিলিজ নোট: Places API (নতুন) রিলিজ নোট
অফিসিয়াল Places API (নতুন) প্যাকেজ:
- npm:
@googlemaps/places - pypi:
google-maps-places - যান:
cloud.google.com/go/maps
Places API (নতুন): সম্পর্কিত প্রোডাক্ট
- পরিবর্তন করে: Places API (Legacy)
- সাধারণত এগুলির সাথে ব্যবহার করা হয়: Geocoding API, Routes API, Address Validation API
Places API (নতুন): সাধারণ ভুল
- সমস্যা: জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং টেক্সট সার্চ (নতুন) ফিল্ডে কোনও ডিফল্ট তালিকা নেই; ফিল্ড মাস্ক ছাড়া অনুরোধ করলে সমস্যা হয়। সমাধান:
fieldsবা$fieldsপ্যারামিটার অথবাX-Goog-FieldMaskহেডারের সাথে একটি রেসপন্স ফিল্ড মাস্ক পাস করুন। /maps/documentation/places/web-service/choose-fields দেখুন। - সমস্যা: সেশন শেষ হওয়ার পরে Autocomplete (New) সেশন টোকেন বাদ দেওয়া বা আবার ব্যবহার করা হলে, প্রতিটি অনুরোধের জন্য SKU: Autocomplete Requests হিসেবে আলাদাভাবে বিল করা হয়। সমাধান: প্রতিটি সেশনের জন্য একটি নতুন সেশন টোকেন (UUID v4 সাজেস্ট করা হয়) তৈরি করুন এবং জায়গার বিবরণ (নতুন) বা Address Validation অনুরোধের মাধ্যমে এটি শেষ করুন। /maps/documentation/places/web-service/place-session-tokens দেখুন।
- সমস্যা: আগে থেকে থাকা বা AI-জেনারেটেড কোড যা Places API (Legacy) বা Maps JavaScript API
PlacesService-কে কল করে, সেটি কোনও প্রোজেক্টে লিগ্যাসি API চালু না থাকলেLegacyApiNotActivatedMapError-এর সাথে ব্যর্থ হয়। সমাধান: Places API (নতুন)-এ কল মাইগ্রেট করুন এবং প্রয়োজনীয় ফিল্ড মাস্ক অন্তর্ভুক্ত করুন। /maps/legacy#LegacyApiNotActivatedMapError দেখুন। - সমস্যা: সেভ করা জায়গার আইডি পুরনো হয়ে যেতে পারে; সেক্ষেত্রে জায়গার বিবরণ (নতুন)
NOT_FOUND(HTTP 404) দেখায় এবং ভুল বা অসম্পূর্ণ আইডি HTTP 400INVALID_ARGUMENTদেখায়। সমাধান: ১২ মাসের বেশি পুরনো স্টোর করা জায়গার আইডি রিফ্রেশ করুন। এর জন্য জায়গার বিবরণ (নতুন) সংক্রান্ত অনুরোধ করুন যাতে শুধুidফিল্ডের (কোনও চার্জ লাগবে না) ব্যাপারে জিজ্ঞাসা করা হয়। /maps/documentation/places/web-service/place-id#refresh-id দেখুন।
Places API (নতুন) ব্যবহার করে আপনি কী কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
Places API (নতুন): জেনারেটিভ AI
- নির্দিষ্ট Google Place শনাক্তকারীর জন্য ব্যবহারকারীর রিভিউয়ের AI-পরিচালিত সারসংক্ষেপ প্রদান করুন।
- ইলেকট্রিক ভেইকেল চার্জিং স্টেশনের জন্য নির্দিষ্ট Google Place শনাক্তকারীর আশেপাশের এলাকা এবং সুযোগ-সুবিধার AI-পরিচালিত স্থানের সারাংশ প্রদান করে।
Places API (নতুন): Places
- কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে জায়গা ও জায়গার বিবরণের তালিকা দেখায়।
- নির্দিষ্ট লোকেশনের কাছাকাছি জায়গার তালিকা ও জায়গার বিবরণ দেখায়।
- কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে জায়গা সম্পর্কে অটোমেটিক সম্পূর্ণ হওয়া ফলাফল দেখান।
- নির্দিষ্ট কোনও জায়গা সম্পর্কে বিস্তারিত তথ্য প্রদান করা।
- নির্দিষ্ট কোনও জায়গার ফটো দেখান। মনে রাখবেন: প্রতিটি ফটোর সাথে তার লেখকের অ্যাট্রিবিউশন (লেখকের নাম, তার প্রোফাইল URI-এর সাথে লিঙ্ক করা) দেখান। প্রতিটি প্ল্যাটফর্মের জন্য Places নীতিতে এটি প্রয়োজন, যেমন /maps/documentation/javascript/policies#photo-attributions এবং /maps/documentation/places/web-service/policies#photos-and-review।
- জায়গার ফটো ছোট বড় করুন।
- নির্দিষ্ট জায়গার জন্য রেটিং ও রিভিউ দেখায়। মনে রাখবেন: Places API (নতুন) ওয়েব সার্ভিসে, জায়গার বিবরণ হল X-Goog-FieldMask (যেমন, রেটিং, userRatingCount, রিভিউ) সহ https://places.googleapis.com/v1/places/{placeId}-এ HTTP GET অনুরোধ; টেক্সট সার্চ, নিয়ারবাই সার্চ এবং অটো-কমপ্লিট POST ব্যবহার করে। Android-এ, PlacesClient.fetchPlace()-এ Place.Field.RATING, USER_RATING_COUNT এবং REVIEWS পাস করুন। iOS-এ, GMSFetchPlaceRequest-এ GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal এবং GMSPlacePropertyReviews পাস করুন।
- জায়গার তথ্য সংক্রান্ত উত্তরে অন্তর্ভুক্ত ডেটা ফিল্ড নির্দিষ্ট করুন।
- জায়গার তথ্য সংক্রান্ত উত্তরে অন্তর্ভুক্ত করার জন্য জায়গার ধরন নির্দিষ্ট করুন।
- Google Maps-এ কোনও জায়গার বিবরণ পৃষ্ঠা খোলার জন্য URI ফিরিয়ে দিন।
- কোনও জায়গার জন্য Google Maps-এ দিকনির্দেশ পৃষ্ঠা খোলার জন্য URI ফিরিয়ে দিন।
- Google Maps-এ কোনও জায়গার জন্য রিভিউ লেখার পৃষ্ঠা খুলতে URI ফিরিয়ে দিন।
- Google Maps-এ কোনও জায়গার রিভিউ পড়ার পৃষ্ঠা খোলার জন্য URI রিটার্ন করুন।
- কোনও জায়গার জন্য Google Maps-এ ফটো পৃষ্ঠা খোলার URI ফিরিয়ে দিন।
- নির্দিষ্ট কোনও জায়গার জন্য AI-পাওয়ার্ড ওভারভিউয়ের সারসংক্ষেপ দেখান।
- AI-এর মাধ্যমে পরিচালিত এলাকার সারসংক্ষেপ প্রদান করে যা নির্দিষ্ট জায়গার আশেপাশের এলাকার জায়গাগুলি বর্ণনা করে।
- আগে থেকে নির্ধারিত রুটে অবস্থিত জায়গা সম্পর্কে কোয়েরি স্ট্রিংয়ের ভিত্তিতে তথ্য ফেরত দেয়।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে টেক্সট-সার্চ করা জায়গার দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে কাছাকাছি জায়গাগুলির দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI ফেরত দিন।
- পূর্বনির্ধারিত রুটের জন্য উৎস এবং কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে ফেরত আসা প্রতিটি স্থানের মধ্যে দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI ফেরত দিন, যা রুটের সাথেও অবস্থিত।
- কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে দেখানো প্রতিটি জায়গার মধ্যে দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI দেখায়, যা আগে থেকে নির্ধারিত রুট এবং রুটের গন্তব্য অনুযায়ীও দেখানো হয়।