Android-এর জন্য Places SDK-এর দ্রুত রেফারেন্স

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: সেট-আপ

Android প্যাকেজের জন্য অফিসিয়াল Places SDK:

  • maven: com.google.android.libraries.places:places

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

Android-এর জন্য Places SDK: Places

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