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

iOS-এর জন্য Places SDK, iOS অ্যাপকে জায়গার বিবরণ, জায়গার ফটো, টেক্সট সার্চ, আশেপাশের সার্চ এবং অটোমেটিক সম্পূর্ণ করার মাধ্যমে জায়গা (ব্যবসা, আগ্রহের জায়গা, ভৌগোলিক লোকেশন) সম্পর্কে তথ্য পেতে দেয়। Places API (নতুন) হল SDK-এর বর্তমান ভার্সন।

iOS-এর জন্য Places SDK: গুরুত্বপূর্ণ তথ্য

  • প্রোডাক্ট: iOS-এর জন্য Places SDK
  • এছাড়াও এই নামে পরিচিত: iOS-এর জন্য Places SDK (নতুন)
  • বিভাগ: জায়গা
  • প্ল্যাটফর্ম: iOS
  • এতে রান করে: ক্লায়েন্ট (অ্যাপ বা ব্রাউজার কোড)
  • লঞ্চ স্টেজ: GA
  • লাইফসাইকেল: অ্যাক্টিভ
  • এক নজরে: iOS-এর জন্য Places SDK এক নজরে

iOS-এর জন্য Places SDK: কখন ব্যবহার করবেন

iOS-এর জন্য Places SDK ব্যবহার করুন যখন:

  • নেটিভ iOS অ্যাপের মধ্যে আপনার জায়গার বিবরণ, ফটো, টেক্সট সার্চ বা নিয়ারবাই সার্চ ফলাফল প্রয়োজন।
  • iOS অ্যাপে ব্যবহারকারী টাইপ করার সময় আপনাকে জায়গার নাম বা ঠিকানা অটোমেটিক সম্পূর্ণ করতে হবে।
  • আপনি iOS অ্যাপে আগে থেকে তৈরি Places UI Kit কম্পোনেন্ট (জায়গার বিবরণ, সার্চ, অটোমেটিক সম্পূর্ণ করা) চান।

iOS-এর জন্য Places SDK ব্যবহার করবেন না যখন:

  • আপনি একটি নেটিভ Android অ্যাপ তৈরি করছেন। এর পরিবর্তে Android-এর জন্য Places SDK ব্যবহার করুন।
  • আপনি ব্রাউজারে একটি ওয়েব পেজ তৈরি করছেন। পরিবর্তে Maps JavaScript API ব্যবহার করুন।
  • iOS ক্লায়েন্টের পরিবর্তে HTTP-এর মাধ্যমে সার্ভার বা ব্যাকএন্ড থেকে আপনার জায়গার ডেটা প্রয়োজন। পরিবর্তে Places API (নতুন) ব্যবহার করুন।

iOS-এর জন্য Places SDK: সেট-আপ

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

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

iOS-এর জন্য Places SDK: সাধারণ ভুল

  • সমস্যা: ক্লাউড প্রোজেক্টে Places API (নতুন) চালু করা না থাকলে অথবা API কী-এর অনুমোদিত API-এর তালিকায় না থাকলে, iOS-এর জন্য Places SDK (নতুন) কল করা যাবে না। সমাধান: Places API (নতুন) চালু করুন এবং অ্যাপের মাধ্যমে ব্যবহার করা API কী সংক্রান্ত বিধিনিষেধে এটি যোগ করুন। /maps/documentation/places/ios-sdk/legacy/migrate-overview দেখুন।
  • সমস্যা: kGMSPlacesRateLimitExceeded (-7) মানে API কী তার ব্যবহারের রেট সীমা অতিক্রম করেছে; বন্ধ করা SDK 2.x ভার্সনে (২৯ জুলাই, ২০১৯-এ বন্ধ করা হয়েছে) অ্যাপগুলিও এই সমস্যা পায়। সমাধান: Google Cloud কনসোলে Places API (নতুন)-এর কোটা ও ব্যবহার চেক করুন এবং ৩.০-এর আগের SDK ভার্সনে অ্যাপ আপডেট করুন। /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode দেখুন।
  • সমস্যা: একই প্রোজেক্টের বিভিন্ন অ্যাপে বা বিভিন্ন সেশনে সেশন টোকেন আবার ব্যবহার করা হলে, অটোমেটিক সম্পূর্ণ করার সেশন বিলিং গ্রুপিং ভেঙে যায়। সমাধান: প্রতিটি অটোমেটিক সম্পূর্ণ সেশনের জন্য একটি অনন্য সেশন টোকেন (ভার্সন ৪ UUID সাজেস্ট করা হয়েছে) তৈরি করুন; টোকেনগুলি প্রতিটি প্রোজেক্টের জন্য অনন্য হতে হবে। /maps/documentation/places/ios-sdk/use-session-tokens দেখুন।
  • সমস্যা: API-এর মাধ্যমে ফেরত পাঠানো অ্যাট্রিবিউশন ছাড়াই অ্যাপ জায়গার ডেটা দেখায়। সমাধান: নীতি পৃষ্ঠা অনুযায়ী, Places ডেটার সাথে ফেরত আসা সব প্রাসঙ্গিক অ্যাট্রিবিউশন দেখান। /maps/documentation/places/ios-sdk/overview দেখুন।

iOS-এর জন্য Places SDK: লিগ্যাসি ও বন্ধ হয়ে যাওয়া ফিচার

  • iOS-এর জন্য Places SDK (পুরনো ভার্সন): পুরনো ১ মার্চ, ২০২৫ থেকে। পরিবর্তন: iOS-এর জন্য Places SDK (নতুন) (Places API (নতুন) প্রয়োজন)। লক্ষণ: SDK 11.0.0 এবং তার পরবর্তী ভার্সনে লিগ্যাসি ক্লাস এবং পদ্ধতি (যেমন fetchPlaceFromPlaceID, GMSAutocompleteFetcher এবং GMSAutocompleteViewController) নেই, যার ফলে কম্পাইলেশন ভেঙে যায়। মাইগ্রেশন গাইড দেখুন।
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner এবং GMSAutocompleteFetcher initWithBounds:filter: ১৩-১০-২০২০ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন: GMSAutocompleteRequest-এ GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback:-এর সাথে GMSAutocompleteFilter (locationBias অথবা locationRestriction) অথবা UI উইজেটের জন্য GooglePlacesSwift placeAutocomplete অথবা basicPlaceAutocomplete মডিফায়ার। লক্ষণ: SDK 4.0.0 এবং তার পরবর্তী ভার্সনে পদ্ধতিগুলি নেই (এবং SDK 11.0.0-এ GMSAutocompleteResultsViewController ও GMSAutocompleteFetcher সরিয়ে দেওয়া হয়েছে)। মাইগ্রেশন গাইড দেখুন।
  • GMSCoordinateBounds-ভিত্তিক অটোকমপ্লিট বাউন্ড (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; findAutocompletePredictionsFromQuery এবং autocompleteQuery-এর bounds/boundsMode প্যারামিটার): ১৩-১০-২০২০ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন: GMSAutocompleteFilter (locationBias বা locationRestriction) এবং GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: দিয়ে GMSAutocompleteRequest, অথবা UI উইজেটের জন্য GooglePlacesSwift placeAutocomplete বা basicPlaceAutocomplete মডিফায়ার। লক্ষণ: SDK 4.0.0 এবং তার পরবর্তী ভার্সনে প্রপার্টি ও প্যারামিটার নেই (এবং SDK 11.0.0 থেকে GMSAutocompleteViewController ও findAutocompletePredictionsFromQuery সরিয়ে দেওয়া হয়েছে)। মাইগ্রেশন গাইড দেখুন।
  • GMSPlace.openNowStatus: ডিকমিশন করা হয়েছে ১৩-১০-২০২০ থেকে। পরিবর্তন: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) অথবা PlacesClient.isPlaceOpen(with:), GooglePlacesSwift-এ। লক্ষণ: SDK 4.0.0 ও তার পরবর্তী ভার্সনে প্রপার্টি নেই। মাইগ্রেশন গাইড দেখুন।
  • GMSPlaceField NS_ENUM হিসেবে: ডিকমিশন করা হয়েছে ১৩-১০-২০২০ থেকে। পরিবর্তন: GMSPlaceProperty কনস্ট্যান্টের পরিবর্তে GMSFetchPlaceRequest এবং GMSPlaceSearchByTextRequest-এর মতো রিকোয়েস্ট ক্লাস অথবা GooglePlacesSwift-এ PlaceProperty ব্যবহার করুন। লক্ষণ: SDK 4.0.0-এ NS_OPTIONS দ্বারা প্রতিস্থাপিত হয়েছে (GMSPlaceField যেহেতু NS_OPTIONS লিগ্যাসি API-এর অন্তর্গত এবং SDK 11.0.0 ও তার পরবর্তী ভার্সনে নেই)। মাইগ্রেশন গাইড দেখুন।
  • iOS ভার্সন ২.৭.০-এর জন্য Places SDK: ২৯-০৭-২০১৯ থেকে বন্ধ করা হয়েছে। পরিবর্তন: iOS ভার্সনের জন্য বর্তমান Places SDK। সমস্যার উপসর্গ: kGMSPlacesRateLimitExceededটি সমস্যা।

iOS-এর জন্য Places SDK-এর মাধ্যমে আপনি কী করতে পারবেন

প্রতিটি টাস্কের জন্য নিচে লিঙ্ক করা গাইড দেখুন অথবা ক্যাপাবিলিটি এক্সপ্লোরার-এ বিভিন্ন প্রোডাক্টের মধ্যে তুলনা করুন।

iOS-এর জন্য Places SDK: জেনারেটিভ AI

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

iOS-এর জন্য 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