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: সেট-আপ
- পরিষেবা চালু করতে:
places.googleapis.com - যাচাইকরণ: API key
- ব্যবহারের অ্যাট্রিবিউশন: ব্যবহারের অ্যাট্রিবিউশন আইডি যোগ করতে
GMSPlacesClient(Objective-C/Swift) বাPlacesClient(GooglePlacesSwift)-এ ক্লাস মেথডaddInternalUsageAttributionIDকল করুন; কল মুছে দিলে অপ্ট-আউট হয়ে যাবে। - শুরু করা: iOS-এর জন্য Places SDK সেট-আপ করা
- রেফারেন্স: iOS-এর জন্য Places SDK রেফারেন্স
- দাম: iOS-এর জন্য Places SDK-এর ব্যবহার ও বিলিং
- নীতি: iOS-এর জন্য Places SDK সংক্রান্ত নীতি
- রিলিজ নোট: iOS-এর জন্য Places SDK-এর রিলিজ নোট
iOS প্যাকেজের জন্য অফিসিয়াল Places SDK:
- swift_package:
https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)
iOS-এর জন্য Places SDK: সম্পর্কিত প্রোডাক্ট
- সাধারণত এর সাথে ব্যবহার করা হয়: iOS-এর জন্য Maps SDK
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) নেই, যার ফলে কম্পাইলেশন ভেঙে যায়। মাইগ্রেশন গাইড দেখুন। GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerএবংGMSAutocompleteFetcherinitWithBounds:filter: ১৩-১০-২০২০ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন:GMSAutocompleteRequest-এGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:-এর সাথেGMSAutocompleteFilter(locationBiasঅথবাlocationRestriction) অথবা UI উইজেটের জন্যGooglePlacesSwiftplaceAutocompleteঅথবাbasicPlaceAutocompleteমডিফায়ার। লক্ষণ: SDK 4.0.0 এবং তার পরবর্তী ভার্সনে পদ্ধতিগুলি নেই (এবং SDK 11.0.0-এGMSAutocompleteResultsViewControllerওGMSAutocompleteFetcherসরিয়ে দেওয়া হয়েছে)। মাইগ্রেশন গাইড দেখুন।GMSCoordinateBounds-ভিত্তিক অটোকমপ্লিট বাউন্ড (GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;findAutocompletePredictionsFromQueryএবংautocompleteQuery-এরbounds/boundsModeপ্যারামিটার): ১৩-১০-২০২০ থেকে ডিকমিশন করা হয়েছে। পরিবর্তন:GMSAutocompleteFilter(locationBiasবাlocationRestriction) এবংGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:দিয়েGMSAutocompleteRequest, অথবা UI উইজেটের জন্যGooglePlacesSwiftplaceAutocompleteবাbasicPlaceAutocompleteমডিফায়ার। লক্ষণ: SDK 4.0.0 এবং তার পরবর্তী ভার্সনে প্রপার্টি ও প্যারামিটার নেই (এবং SDK 11.0.0 থেকেGMSAutocompleteViewControllerওfindAutocompletePredictionsFromQueryসরিয়ে দেওয়া হয়েছে)। মাইগ্রেশন গাইড দেখুন।GMSPlace.openNowStatus: ডিকমিশন করা হয়েছে ১৩-১০-২০২০ থেকে। পরিবর্তন:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) অথবাPlacesClient.isPlaceOpen(with:),GooglePlacesSwift-এ। লক্ষণ: SDK 4.0.0 ও তার পরবর্তী ভার্সনে প্রপার্টি নেই। মাইগ্রেশন গাইড দেখুন।GMSPlaceFieldNS_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
- নির্দিষ্ট Google Place শনাক্তকারীর জন্য ব্যবহারকারীর রিভিউয়ের AI-পরিচালিত সারসংক্ষেপ প্রদান করুন।
- ইলেকট্রিক ভেইকেল চার্জিং স্টেশনের জন্য নির্দিষ্ট Google Place শনাক্তকারীর আশেপাশের এলাকা এবং সুযোগ-সুবিধার AI-পরিচালিত স্থানের সারাংশ প্রদান করে।
iOS-এর জন্য 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 পাস করুন।
- কোনও ওয়েব পেজ বা অ্যাপে একটি অটোমেটিক সম্পূর্ণ করার উইজেট যোগ করুন যা কোয়েরি স্ট্রিংয়ের উপর ভিত্তি করে জায়গা সম্পর্কে ফলাফল দেখায়।
- জায়গার তথ্য সংক্রান্ত উত্তরে অন্তর্ভুক্ত ডেটা ফিল্ড নির্দিষ্ট করুন।
- জায়গার তথ্য সংক্রান্ত উত্তরে অন্তর্ভুক্ত করার জন্য জায়গার ধরন নির্দিষ্ট করুন।
- ব্যবহারকারীর ডিভাইস বর্তমানে যে জায়গায় আছে সেই জায়গা সম্পর্কে তথ্য প্রদান করে। মনে রাখবেন: Places SDK for Android v6.0+ এবং Places SDK for iOS v11.0+ থেকে লিগ্যাসি বর্তমান জায়গার পদ্ধতি সরিয়ে দেওয়া হয়েছে; প্ল্যাটফর্ম লোকেশন পরিষেবা থেকে ডিভাইসের কোঅর্ডিনেট ফিরিয়ে আনুন এবং নিয়ারবাই সার্চ কল করুন।
- নির্দিষ্ট কোনও জায়গার জন্য AI-পাওয়ার্ড ওভারভিউয়ের সারসংক্ষেপ দেখান।
- AI-এর মাধ্যমে পরিচালিত এলাকার সারসংক্ষেপ প্রদান করে যা নির্দিষ্ট জায়গার আশেপাশের এলাকার জায়গাগুলি বর্ণনা করে।
- আগে থেকে নির্ধারিত রুটে অবস্থিত জায়গা সম্পর্কে কোয়েরি স্ট্রিংয়ের ভিত্তিতে তথ্য ফেরত দেয়।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে টেক্সট-সার্চ করা জায়গার দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI রিটার্ন করুন।
- অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কের সেট থেকে কাছাকাছি জায়গাগুলির দূরত্ব, ভ্রমণের সময় এবং দিকনির্দেশ URI ফেরত দিন।
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