Android-এর জন্য Places SDK, Android অ্যাপকে 'জায়গা অটোমেটিক সম্পূর্ণ করা', 'জায়গার বিবরণ', 'নিয়ারবাই Search', 'টেক্সট সার্চ' এবং 'জায়গার ফটো'র মাধ্যমে Google-এর জায়গা ও ব্যবসার তথ্য সংক্রান্ত ডেটাবেস অ্যাক্সেস করতে দেয়। Android-এর জন্য Places SDK (নতুন) হল বর্তমান ভার্সন এবং এটি Places API (নতুন)-এর উপর নির্ভর করে।
Android-এর জন্য Places SDK: মূল তথ্য
- প্রোডাক্ট: Android-এর জন্য Places SDK
- এছাড়াও এই নামে পরিচিত: Android-এর জন্য Places SDK (নতুন)
- বিভাগ: জায়গা
- প্ল্যাটফর্ম: Android
- এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
- লঞ্চ স্টেজ: GA
- লাইফসাইকেল: অ্যাক্টিভ
- এক নজরে: Android-এর জন্য Places SDK এক নজরে
Android-এর জন্য Places SDK: কখন ব্যবহার করবেন
Android-এর জন্য Places SDK ব্যবহার করুন যখন:
- নেটিভ Android অ্যাপের মধ্যে আপনার জায়গার বিবরণ, ফটো, নিয়ারবাই Search বা টেক্সট সার্চ ফলাফল প্রয়োজন।
- আপনার একটি রেডিমেড অটো-কমপ্লিট উইজেট বা Places UI Kit কম্পোনেন্ট প্রয়োজন যা ব্যবহারকারীরা Android অ্যাপে টাইপ করার সাথে সাথে জায়গার পূর্বাভাস প্রদান করে।
- আপনাকে ব্যবহারকারীর ডিভাইসের কাছাকাছি ব্যবসা এবং আগ্রহের পয়েন্টের উপর ভিত্তি করে লোকেশন-অ্যাওয়ার Android ফিচার তৈরি করতে হবে।
Android-এর জন্য Places SDK ব্যবহার করবেন না যখন:
- আপনাকে Android অ্যাপের পরিবর্তে HTTP-এর মাধ্যমে সার্ভার বা ব্যাকএন্ড থেকে Places কল করতে হবে। এর পরিবর্তে Places API (নতুন) ব্যবহার করুন।
- আপনি একটি নেটিভ iOS অ্যাপ তৈরি করছেন। এর পরিবর্তে iOS-এর জন্য Places SDK ব্যবহার করুন।
- আপনি ব্রাউজারে একটি ওয়েব পেজ তৈরি করছেন। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
Android-এর জন্য Places SDK: সেট-আপ
- পরিষেবা চালু করতে:
places.googleapis.com - যাচাইকরণ: API key
- ব্যবহারের অ্যাট্রিবিউশন: ব্যবহারের অ্যাট্রিবিউশন আইডি পাঠাতে SDK শুরু করার সময়
Places.addInternalUsageAttributionId(String)কল করুন; কল মুছে দিন বা বেরিয়ে আসতে খালি স্ট্রিং পাস করুন। - শুরু করুন: Android-এর জন্য Places SDK সেট-আপ করুন
- রেফারেন্স: Android-এর জন্য Places SDK রেফারেন্স
- দাম: Android-এর জন্য Places SDK-এর ব্যবহার ও বিলিং
- নীতি: Android-এর জন্য Places SDK সংক্রান্ত নীতি
- রিলিজ নোট: Android-এর জন্য Places SDK-এর রিলিজ নোট
Android প্যাকেজের জন্য অফিসিয়াল Places SDK:
- maven:
com.google.android.libraries.places:places
Android-এর জন্য Places SDK: সম্পর্কিত প্রোডাক্ট
- সাধারণত এর সাথে ব্যবহার করা হয়: Android-এর জন্য Maps SDK
Places SDK for Android: common mistakes
- সমস্যা: ফিল্ড লিস্ট (ফিল্ড মাস্ক) ছাড়া বা খালি ফিল্ড লিস্ট সহ নিয়ারবাই Search-এর অনুরোধ করা হলে, সমস্যা সংক্রান্ত মেসেজ দেখানো হয়। সমাধান:
SearchNearbyRequestফিল্ডের তালিকায় অন্তত একটিPlace.Fieldপাস করুন। /maps/documentation/places/android-sdk/nearby-search দেখুন। - সমস্যা: API কী-তে Places API (নতুন) না থাকলে অথবা SDK 5.x এবং তার আগের ভার্সনে অ্যাপ
Places.initialize()কল করলে, জায়গার বিবরণ (নতুন), নিয়ারবাই Search (নতুন) এবং অটোমেটিক সম্পূর্ণ করা (নতুন) ফিচার কাজ করে না। 6.0.2 ভার্সনPlaces.initialize()সরিয়ে দিয়েছে, তাই আপগ্রেড করার পরে এটিকে কল করা কোড কম্পাইল হয় না। সমাধান: Places API (নতুন) চালু করুন, API key-এর অনুমোদিত API-তে এটি যোগ করুন এবংPlaces.initializeWithNewPlacesApiEnabled()দিয়ে শুরু করুন। /maps/documentation/places/android-sdk/legacy/migrate-overview দেখুন। - সমস্যা: ফিল্ড লিস্টে
PHOTO_METADATASবাদ দেওয়া হলে,fetchPlace()-এর মাধ্যমে রিটার্ন করাPlace-এ কোনওPhotoMetadataথাকে না (তাই সমাধান করার মতো কিছু নেই)। সমাধান: ফিল্ডের তালিকায়Place.Field.PHOTO_METADATASঅন্তর্ভুক্ত করুন।fetchResolvedPhotoUri()বন্ধ হয়ে গেছে, তাই ফটো দেখাতে Places UI Kit-এর 'জায়গার বিবরণ' কম্পোনেন্ট ব্যবহার করুন। /maps/documentation/places/android-sdk/place-photos দেখুন। - সমস্যা: যেসব অ্যাপ থার্ড-পার্টি ও লেখকের অ্যাট্রিবিউশন ছাড়াই জায়গার বিবরণ, ফটো বা রিভিউ দেখায়, সেগুলি নীতি লঙ্ঘন করে। সমাধান:
Place,PhotoMetadataএবংReviewঅবজেক্টের সাথে ফেরত আসা অ্যাট্রিবিউশন দেখান। /maps/documentation/places/android-sdk/policies দেখুন।
Android-এর জন্য Places SDK: পুরনো এবং বন্ধ হয়ে যাওয়া ফিচার
- Android-এর জন্য Places SDK (পুরনো) / Places API (পুরনো) ফিচার (অটোমেটিক সম্পূর্ণ করা, বর্তমান জায়গা, জায়গার বিবরণ, জায়গার পুরনো ফটো): পুরনো ১ মার্চ, ২০২৫ থেকে। পরিবর্তন: Places API (নতুন) দ্বারা সমর্থিত Android-এর জন্য Places SDK (নতুন) ফিচার,
Places.initializeWithNewPlacesApiEnabled()-এর মাধ্যমে শুরু করা হয়েছে। লক্ষণ: অক্টোবর ২০২৬ থেকে, নতুন ক্লাউড প্রোজেক্ট Places API (Legacy) চালু করতে পারবে না (আগে থেকে থাকা প্রোজেক্টে কাজ করা যাবে)। SDK 6.0.2 ভার্সন থেকে পুরনো পদ্ধতি সরিয়ে দেওয়া হয়েছে, যা শুধুমাত্র 5.x এবং তার আগের ভার্সনে আছে। মাইগ্রেশন গাইড দেখুন। Places.initialize(): ডিকমিশন করা হয়েছে ৩০-০৯-২০২৬ থেকে। পরিবর্তন:Places.initializeWithNewPlacesApiEnabled(). লক্ষণ: 6.0.2-এ SDK থেকে পদ্ধতি সরানো হয়েছে; যে কোড এটিকে কল করে সেটি আর কম্পাইল করে না। মাইগ্রেশন গাইড দেখুন।PlacesClient.findCurrentPlace()এবংawaitFindCurrentPlace()(বর্তমান জায়গা, লিগ্যাসি): ৩০-০৯-২০২৬ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন:PlacesClient.searchNearby()(নিয়ারবাই Search (নতুন)). লক্ষণ: 6.0.2 ভার্সনে পদ্ধতি ওFindCurrentPlaceRequest/FindCurrentPlaceResponseক্লাস সরিয়ে দেওয়া হয়েছে। মাইগ্রেশন গাইড দেখুন।PlacesClient.fetchPhoto()এবংawaitFetchPhoto(): ডিকমিশন করা হয়েছে ৩০-০৯-২০২৬ থেকে। পরিবর্তন: Places UI Kit Place Details কম্পোনেন্ট (PlacesClient.fetchResolvedPhotoUri()বন্ধ হয়ে গেছে)। লক্ষণ: 6.0.2 ভার্সনে পদ্ধতি ওFetchPhotoRequest/FetchPhotoResponseক্লাস সরিয়ে দেওয়া হয়েছে। মাইগ্রেশন গাইড দেখুন।- Places API (Legacy) অটোকমপ্লিট উইজেট (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): ৩০-০৯-২০২৬ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন: Place Autocomplete (নতুন) উইজেট (PlaceAutocomplete) অথবাPlacesClient.findAutocompletePredictions()। লক্ষণ: 6.0.2 ভার্সনে SDK থেকে ক্লাস সরিয়ে দেওয়া হয়েছে। মাইগ্রেশন গাইড দেখুন। - Places কম্প্যাটিবিলিটি লাইব্রেরি (
com.google.android.libraries.places:places-compat): ৩১-০৩-২০২২ থেকে বন্ধ করা হয়েছে। পরিবর্তন: Android-এর জন্য Places SDK (com.google.android.libraries.places:places)। লক্ষণ: v2.6.0-এ ফ্রিজ হয়ে গেছে; কোনও নতুন ফিচার বা ত্রুটি সমাধান নেই। AutocompleteFragmentক্লাস: ডিকমিশন করা হয়েছে ২৫-০৯-২০২৫ থেকে। পরিবর্তন: Place Autocomplete (নতুন) উইজেট (PlaceAutocomplete)। লক্ষণ: SDK-এর 5.0.0 ভার্সন থেকে ক্লাস সরিয়ে দেওয়া হয়েছে (6.0.2 ভার্সন থেকেAutocompleteSupportFragment-ও সরিয়ে দেওয়া হয়েছে)।
Android-এর জন্য Places SDK-এর সাহায্যে আপনি কী করতে পারবেন
প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।
Android-এর জন্য Places SDK: জেনারেটিভ AI
- নির্দিষ্ট Google Place শনাক্তকারীর জন্য ব্যবহারকারীর রিভিউয়ের AI-পরিচালিত সারসংক্ষেপ প্রদান করুন।
- ইলেকট্রিক ভেইকেল চার্জিং স্টেশনের জন্য নির্দিষ্ট Google Place শনাক্তকারীর আশেপাশের এলাকা এবং সুযোগ-সুবিধার AI-পরিচালিত স্থানের সারাংশ প্রদান করে।
Android-এর জন্য Places SDK: 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 ফিরিয়ে দিন।
- ব্যবহারকারীর ডিভাইস বর্তমানে যে জায়গায় আছে সেই জায়গা সম্পর্কে তথ্য প্রদান করে। মনে রাখবেন: Places SDK for Android v6.0+ এবং Places SDK for iOS v11.0+ থেকে লিগ্যাসি বর্তমান জায়গার পদ্ধতি সরিয়ে দেওয়া হয়েছে; প্ল্যাটফর্ম লোকেশন পরিষেবা থেকে ডিভাইসের কোঅর্ডিনেট ফিরিয়ে আনুন এবং নিয়ারবাই Search কল করুন।
- নির্দিষ্ট কোনও জায়গার জন্য AI-পাওয়ার্ড ওভারভিউয়ের সারসংক্ষেপ দেখান।
- AI-এর মাধ্যমে পরিচালিত এলাকার সারসংক্ষেপ প্রদান করে যা নির্দিষ্ট জায়গার আশেপাশের এলাকার জায়গাগুলি বর্ণনা করে।
- আগে থেকে নির্ধারিত রুটে অবস্থিত জায়গা সম্পর্কে কোয়েরি স্ট্রিংয়ের ভিত্তিতে তথ্য ফেরত দেয়।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে টেক্সট-সার্চ করা জায়গার দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে কাছাকাছি জায়গাগুলির দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI ফেরত দিন।
- পূর্বনির্ধারিত রুটের জন্য উৎস এবং কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে ফেরত আসা প্রতিটি স্থানের মধ্যে দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI ফেরত দিন, যা রুটের সাথেও অবস্থিত।
- কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে দেখানো প্রতিটি জায়গার মধ্যে দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI দেখায়, যা আগে থেকে নির্ধারিত রুট এবং রুটের গন্তব্য অনুযায়ীও দেখানো হয়।
Android-এর জন্য Places SDK: Places UI Kit
- কোনও জায়গার ডেটা UI এলিমেন্টে CSS স্টাইলিং প্রয়োগ করুন। মনে রাখবেন: CSS কাস্টম প্রপার্টি Maps JavaScript API Places UI Kit এলিমেন্টে প্রযোজ্য হয়; Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK, থিম ও স্টাইল অ্যাট্রিবিউট ব্যবহার করে প্রোগ্রাম্যাটিকভাবে Place UI Kit ভিউ স্টাইল করে। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
- UI এলিমেন্ট কাস্টমাইজেশন টুলের সাহায্যে জায়গার ডেটা UI এলিমেন্ট স্টাইলিং ও কনফিগারেশন কাস্টমাইজ করুন। মনে রাখবেন: EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
- ওয়েব পেজ বা মোবাইল অ্যাপে কোনও নির্দিষ্ট জায়গা সম্পর্কে তথ্য দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: EEA-এর নিয়ম মেনে চলার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
- ওয়েব পেজে কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে জায়গার তালিকা দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: ওয়েবপেজ (Maps JavaScript API) এবং মোবাইল অ্যাপ (Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK) দুটিতেই কাজ করে। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
- ওয়েব পেজে নির্দিষ্ট লোকেশনের কাছাকাছি জায়গার তালিকা দেখায় এমন UI এলিমেন্ট যোগ করুন। মনে রাখবেন: ওয়েবপেজ (Maps JavaScript API) এবং মোবাইল অ্যাপ (Android-এর জন্য Places SDK এবং iOS-এর জন্য Places SDK) দুটিতেই কাজ করে। EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq
- কোনও ওয়েব পেজ বা অ্যাপে একটি প্রাথমিক অটোমেটিক সম্পূর্ণ হওয়া UI এলিমেন্ট যোগ করুন যা কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে Google Place শনাক্তকারী প্রদান করে। মনে রাখবেন: EEA-এর সাথে মানানসই হওয়ার প্রয়োজনীয়তা: ইউরোপীয় অর্থনৈতিক অঞ্চলে (EEA) ম্যাপে জায়গার ডেটা দেখানোর জন্য, ব্যাকএন্ড সার্ভার থেকে Places API ওয়েব সার্ভিস কল করবেন না। টার্গেট প্ল্যাটফর্মে ক্লায়েন্ট-সাইড Places UI Kit কম্পোনেন্ট ব্যবহার করুন (ওয়েবে Maps JavaScript API, Android-এ Android-এর জন্য Places SDK বা iOS-এ iOS-এর জন্য Places SDK)। সম্পূর্ণ প্রয়োজনীয়তা ও প্রায়শই জিজ্ঞাসিত প্রশ্ন: https://developers.google.com/maps/comms/eea/faq