iOS-এর জন্য Places SDK ডাউনলোড করতে, আপনার অ্যাপে লাইব্রেরি এবং এর নির্ভরতা যোগ করতে এবং কোনো চার্জ ছাড়াই একটি API কী পেতে এই গাইডের ধাপগুলি অনুসরণ করুন।
রিলিজ নোট প্রতিটি রিলিজের জন্য উপলব্ধ.
ধাপ 1: এক্সকোডের সর্বশেষ সংস্করণ পান
iOS এর জন্য Places SDK ব্যবহার করে একটি প্রকল্প তৈরি করতে, আপনার প্রয়োজন:
ধাপ 2: SDK ইনস্টল করুন
একটি নতুন প্রকল্পে API ইনস্টল করতে, এই পদক্ষেপগুলি অনুসরণ করুন:কোকোপড ব্যবহার করুন
iOS-এর জন্য Places SDK একটি CocoaPod পড হিসেবে উপলব্ধ, GooglePlaces , যাতে সমস্ত স্থানের কার্যকারিতা রয়েছে৷
CocoaPods হল সুইফট এবং অবজেক্টিভ-সি কোকো প্রকল্পগুলির জন্য একটি ওপেন সোর্স নির্ভরতা ব্যবস্থাপক। আপনার যদি ইতিমধ্যেই CocoaPods টুল না থাকে, তাহলে টার্মিনাল থেকে নিম্নলিখিত কমান্ডটি চালিয়ে ম্যাকোসে এটি ইনস্টল করুন। বিস্তারিত জানার জন্য, CocoaPods শুরু করার নির্দেশিকা দেখুন।
sudo gem install cocoapods
iOS এর জন্য স্থান SDK-এর জন্য একটি Podfile
তৈরি করুন এবং SDK এবং এর নির্ভরতা ইনস্টল করতে এটি ব্যবহার করুন:
- আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রকল্প ডিরেক্টরিতে
Podfile
নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে। -
Podfile
সম্পাদনা করুন এবং তাদের সংস্করণ সহ আপনার নির্ভরতা যোগ করুন। এখানে একটি উদাহরণ যা আপনার অ্যাপ্লিকেশন লক্ষ্যের নাম এবংGooglePlaces
পডের নাম উল্লেখ করে:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '8.0.0' end
আপনি সর্বদা সর্বশেষে আছেন তা নিশ্চিত করার জন্য একটি নতুন সংস্করণ আছে তা সনাক্ত করতে নিয়মিতভাবেpod outdated
চালানো নিশ্চিত করুন৷ -
Podfile
সংরক্ষণ করুন। একটি টার্মিনাল খুলুন এবং
Podfile
ধারণকারী ডিরেক্টরিতে যান:cd <path-to-project>
pod install
কমান্ড চালান। এটিPodfile
এ নির্দিষ্ট করা APIগুলিকে ইনস্টল করবে, সাথে তাদের যে কোনো নির্ভরতা থাকতে পারে।pod install
Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রকল্পের
.xcworkspace
ফাইল খুলুন (ডাবল-ক্লিক করুন)। এই সময় থেকে, আপনাকে প্রকল্পটি খুলতে.xcworkspace
ফাইলটি ব্যবহার করতে হবে।
একটি বিদ্যমান প্রকল্পের জন্য API আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- একটি টার্মিনাল খুলুন এবং
Podfile
ধারণকারী প্রকল্প ডিরেক্টরিতে যান। -
pod update
কমান্ড চালান। এটিPodfile
এ উল্লিখিত সমস্ত API সর্বশেষ সংস্করণে আপডেট করবে।
কার্থেজ ব্যবহার করুন
IOS-এর জন্য Places SDK Carthage- এর সাথে ব্যবহার করার জন্য উপলব্ধ, সুইফট এবং অবজেক্টিভ-সি কোকো প্রকল্পগুলির জন্য একটি সহজ, বিকেন্দ্রীকৃত নির্ভরতা পরিচালক৷
- কার্থেজ ইনস্টল করুন। বিভিন্ন পদ্ধতি আছে, তাই সঠিক পদক্ষেপের জন্য Carthage README ফাইলটি দেখুন ।
- আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রকল্প ডিরেক্টরিতে
Cartfile
নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে। -
Cartfile
সম্পাদনা করুন এবং তাদের সংস্করণ সহ আপনার নির্ভরতা যুক্ত করুন:
binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1
আপনি সর্বদা সর্বশেষে আছেন তা নিশ্চিত করার জন্য একটি নতুন সংস্করণ আছে তা সনাক্ত করতে নিয়মিতভাবেcarthage outdated
চালানো নিশ্চিত করুন৷ -
Cartfile
সংরক্ষণ করুন। - একটি টার্মিনাল উইন্ডোতে,
Cartfile
ধারণকারী ডিরেক্টরিতে যান:
cd <path-to-project>
-
carthage update
কমান্ড চালান। এটিCartfile
নির্দিষ্ট করা APIগুলিকে ইনস্টল করবে, সাথে তাদের যে কোনো নির্ভরতা থাকতে পারে। - ফাইন্ডারে, আপনার প্রজেক্ট ডিরেক্টরিতে, ডাউনলোড করা ফ্রেমওয়ার্ক ফাইলগুলিতে যান
Carthage/Build/iOS
এর অধীনে। - নিম্নলিখিত বান্ডিলগুলিকে আপনার প্রকল্পে টেনে আনুন (যখন অনুরোধ করা হয়, প্রয়োজনে আইটেমগুলি অনুলিপি করুন নির্বাচন করুন):
-
GooglePlaces-xxx/Frameworks/GooglePlaces.xcframework
-
- আপনার প্রোজেক্টে
GooglePlaces.xcframework
রাইট-ক্লিক করুন এবং ফাইন্ডারে দেখান নির্বাচন করুন। - আপনার প্রকল্পে
Resources
ফোল্ডার থেকেGooglePlaces.bundle
টেনে আনুন। যখন অনুরোধ করা হয়, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গোষ্ঠীর ফোল্ডারে অনুলিপি করুন নির্বাচন করা হয়নি ৷ - প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
- বিল্ড ফেজ ট্যাবটি খুলুন এবং লাইব্রেরিগুলির সাথে লিঙ্ক বাইনারির মধ্যে, নিম্নলিখিত কাঠামো এবং লাইব্রেরিগুলি যুক্ত করুন:
-
CoreGraphics.framework
-
CoreLocation.framework
-
libc++.tbd
-
libz.tbd
-
QuartzCore.framework
-
UIKit.framework
-
একটি নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন।
- অন্যান্য লিঙ্কার পতাকা বিভাগে,
-ObjC
যোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তবে বিল্ড সেটিংস বারে ফিল্টারটি বেসিক থেকে সকলে পরিবর্তন করুন৷
একটি বিদ্যমান প্রকল্পের জন্য API আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- একটি টার্মিনাল খুলুন এবং
Cartfile
ধারণকারী প্রকল্প ডিরেক্টরিতে যান। -
carthage update
কমান্ড চালান। এটিCartfile
নির্দিষ্ট করা সমস্ত API সর্বশেষ সংস্করণে আপডেট করবে।
ম্যানুয়ালি ইনস্টল করুন
এই নির্দেশিকাটি দেখায় কিভাবে ম্যানুয়ালি আপনার প্রোজেক্টে GooglePlaces ফ্রেমওয়ার্ক যোগ করবেন এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করবেন।
- SDK সোর্স ফাইল ডাউনলোড করুন: GooglePlaces-8.0.0
- উৎস ফাইল আনপ্যাক.
- Xcode চালু করুন এবং হয় একটি বিদ্যমান প্রকল্প খুলুন, অথবা একটি নতুন প্রকল্প তৈরি করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রোজেক্ট থেকে আগের রিলিজ থেকে যেকোনও ম্যাপ বান্ডিল সরান।
- নিম্নলিখিত বান্ডিলগুলিকে আপনার প্রকল্পে টেনে আনুন (যখন অনুরোধ করা হয়, প্রয়োজনে আইটেমগুলি অনুলিপি করুন নির্বাচন করুন):
-
GooglePlaces-xxx/Frameworks/GooglePlaces.xcframework
-
- আপনার প্রোজেক্টে
GooglePlaces.xcframework
রাইট-ক্লিক করুন এবং ফাইন্ডারে দেখান নির্বাচন করুন। - আপনার প্রকল্পে
Resources
ফোল্ডার থেকেGooglePlaces.bundle
টেনে আনুন। যখন অনুরোধ করা হয়, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গোষ্ঠীর ফোল্ডারে অনুলিপি করুন নির্বাচন করা হয়নি ৷ - প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
- বিল্ড ফেজ ট্যাবটি খুলুন এবং লাইব্রেরিগুলির সাথে লিঙ্ক বাইনারির মধ্যে, নিম্নলিখিত কাঠামো এবং লাইব্রেরিগুলি যুক্ত করুন:
-
CoreGraphics.framework
-
CoreLocation.framework
-
libc++.tbd
-
libz.tbd
-
QuartzCore.framework
-
UIKit.framework
-
একটি নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন।
- অন্যান্য লিঙ্কার পতাকা বিভাগে,
-ObjC
যোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তবে বিল্ড সেটিংস বারে ফিল্টারটি বেসিক থেকে সকলে পরিবর্তন করুন৷
XCFramework ইনস্টল করুন
একটি XCFramework হল একটি বাইনারি প্যাকেজ যা আপনি iOS-এর জন্য Places SDK ইনস্টল করতে M1 চিপসেট ব্যবহার করা মেশিন সহ একাধিক প্ল্যাটফর্মে ব্যবহার করতে পারেন। এই গাইডটি দেখায় কিভাবে আপনার প্রোজেক্টে iOS এর জন্য Places SDK ধারণকারী XCFramework যোগ করতে হয় এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করতে হয়।
কার্থেজের সাথে
IOS-এর জন্য Places SDK Carthage- এর সাথে ব্যবহার করার জন্য উপলব্ধ, সুইফট এবং অবজেক্টিভ-সি কোকো প্রকল্পগুলির জন্য একটি সহজ, বিকেন্দ্রীকৃত নির্ভরতা পরিচালক৷
- কার্থেজ ইনস্টল করুন। বিভিন্ন পদ্ধতি আছে, তাই সঠিক পদক্ষেপের জন্য Carthage README ফাইলটি দেখুন ।
- আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রকল্প ডিরেক্টরিতে
Cartfile
নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে। Cartfile
সম্পাদনা করুন এবং তাদের সংস্করণ সহ আপনার নির্ভরতা যুক্ত করুন:binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1-beta
-
Cartfile
সংরক্ষণ করুন। একটি টার্মিনাল উইন্ডোতে,
Cartfile
ধারণকারী ডিরেক্টরিতে যান:cd <path-to-project>
-
carthage update
কমান্ড চালান। এটিCartfile
নির্দিষ্ট করা APIগুলিকে ইনস্টল করবে, সাথে তাদের যে কোনো নির্ভরতা থাকতে পারে। - ফাইন্ডারে, আপনার প্রকল্প ডিরেক্টরিতে,
Carthage/Build
এর অধীনে ডাউনলোড করা ফ্রেমওয়ার্ক ফাইলগুলিতে যান। - ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্টের অধীনে নিম্নলিখিত XCFrameworkটিকে আপনার প্রকল্পে টেনে আনুন। এম্বেড করবেন না নির্বাচন নিশ্চিত করুন:
-
GooglePlaces-xxx/GooglePlaces.xcframework
-
- আপনার প্রোজেক্টে
GooglePlaces.xcframework
রাইট-ক্লিক করুন এবং ফাইন্ডারে দেখান নির্বাচন করুন। -
ios-arm64/GooglePlaces.framework/Resources
ফোল্ডার থেকে আপনার Xcode প্রকল্পের শীর্ষ স্তরের ডিরেক্টরিতেGooglePlaces.bundle
টেনে আনুন৷ যখন অনুরোধ করা হয়, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গোষ্ঠীর ফোল্ডারে অনুলিপি করুন নির্বাচন করা হয়নি ৷ - প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
- বিল্ড ফেজ ট্যাবটি খুলুন, এবং লাইব্রেরিগুলির সাথে লিঙ্ক বাইনারি এর মধ্যে, এবং নিম্নলিখিত ফ্রেমওয়ার্ক এবং লাইব্রেরিগুলি যুক্ত করুন:
-
CoreGraphics.framework
-
CoreLocation.framework
-
libc++.tbd
-
libz.tbd
-
QuartzCore.framework
-
UIKit.framework
-
একটি নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন।
- অন্যান্য লিঙ্কার পতাকা বিভাগে,
-ObjC
যোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তবে বিল্ড সেটিংস বারে ফিল্টারটি বেসিক থেকে সকলে পরিবর্তন করুন৷
ম্যানুয়ালি
এই নির্দেশিকাটি দেখায় কিভাবে ম্যানুয়ালি আপনার প্রোজেক্টে iOS এর জন্য Maps SDK যোগ করবেন এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করবেন।
- SDK সোর্স ফাইল ডাউনলোড করুন: GooglePlaces-8.0.0 ।
- উৎস ফাইল আনপ্যাক. XCFramework অ্যাক্সেস করতে ফ্রেমওয়ার্ক ফোল্ডারে নেভিগেট করুন।
- Xcode চালু করুন এবং হয় একটি বিদ্যমান প্রকল্প খুলুন, অথবা একটি নতুন প্রকল্প তৈরি করুন। আপনি যদি iOS এ নতুন হন, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্টের অধীনে নিম্নলিখিত XCFrameworkটিকে আপনার প্রকল্পে টেনে আনুন। এম্বেড করবেন না নির্বাচন নিশ্চিত করুন:
-
GooglePlaces-xxx/GooglePlaces.xcframework
-
- আপনার প্রোজেক্টে
GooglePlaces.xcframework
রাইট-ক্লিক করুন এবং ফাইন্ডারে দেখান নির্বাচন করুন। -
ios-arm64/GooglePlaces.framework/Resources
ফোল্ডার থেকে আপনার Xcode প্রকল্পের শীর্ষ স্তরের ডিরেক্টরিতেGooglePlaces.bundle
টেনে আনুন৷ যখন অনুরোধ করা হয়, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গোষ্ঠীর ফোল্ডারে অনুলিপি করুন নির্বাচন করা হয়নি ৷ - প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
- বিল্ড ফেজ ট্যাবটি খুলুন, এবং লাইব্রেরিগুলির সাথে লিঙ্ক বাইনারি এর মধ্যে, এবং নিম্নলিখিত ফ্রেমওয়ার্ক এবং লাইব্রেরিগুলি যুক্ত করুন:
-
CoreGraphics.framework
-
CoreLocation.framework
-
libc++.tbd
-
libz.tbd
-
QuartzCore.framework
-
UIKit.framework
-
একটি নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন।
- অন্যান্য লিঙ্কার পতাকা বিভাগে,
-ObjC
যোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তবে বিল্ড সেটিংস বারে ফিল্টারটি বেসিক থেকে সকলে পরিবর্তন করুন৷
ধাপ 3: আপনার অ্যাপে API কী যোগ করুন
নিম্নলিখিত উদাহরণগুলিতে, আপনার API কী দিয়ে YOUR_API_KEY
প্রতিস্থাপন করুন।
সুইফট
নিম্নরূপ আপনার AppDelegate.swift
এ আপনার API কী যোগ করুন:
- নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
import GooglePlaces
- আপনার
application(_:didFinishLaunchingWithOptions:)
পদ্ধতিতে নিম্নলিখিতগুলি যোগ করুন, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
উদ্দেশ্য গ
নিম্নরূপ আপনার AppDelegate.m
এ আপনার API কী যোগ করুন:
- নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
@import GooglePlaces;
- আপনার
application:didFinishLaunchingWithOptions:
পদ্ধতি, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
ধাপ 4: কোড লেখা শুরু করুন
নিম্নলিখিত কোড নমুনাগুলি বর্তমান স্থানটি কীভাবে পেতে হয় তা প্রদর্শন করে।
সুইফট
import GooglePlaces import UIKit class GetStartedViewController : UIViewController { // Add a pair of UILabels in Interface Builder, and connect the outlets to these variables. @IBOutlet private var nameLabel: UILabel! @IBOutlet private var addressLabel: UILabel! private var placesClient: GMSPlacesClient! override func viewDidLoad() { super.viewDidLoad() placesClient = GMSPlacesClient.shared() } // Add a UIButton in Interface Builder, and connect the action to this function. @IBAction func getCurrentPlace(_ sender: UIButton) { let placeFields: GMSPlaceField = [.name, .formattedAddress] placesClient.findPlaceLikelihoodsFromCurrentLocation(withPlaceFields: placeFields) { [weak self] (placeLikelihoods, error) in guard let strongSelf = self else { return } guard error == nil else { print("Current place error: \(error?.localizedDescription ?? "")") return } guard let place = placeLikelihoods?.first?.place else { strongSelf.nameLabel.text = "No current place" strongSelf.addressLabel.text = "" return } strongSelf.nameLabel.text = place.name strongSelf.addressLabel.text = place.formattedAddress } } }
উদ্দেশ্য গ
#import "GetStartedViewController.h" @import GooglePlaces; @interface GetStartedViewController () // Add a pair of UILabels in Interface Builder and connect the outlets to these variables @property (weak, nonatomic) IBOutlet UILabel *nameLabel; @property (weak, nonatomic) IBOutlet UILabel *addressLabel; @end @implementation GetStartedViewController { GMSPlacesClient *_placesClient; } - (void)viewDidLoad { [super viewDidLoad]; _placesClient = [GMSPlacesClient sharedClient]; } // Add a pair of UILabels in Interface Builder and connect the outlets to these variables. - (IBAction)getCurrentPlace:(UIButton *)sender { GMSPlaceField placeFields = (GMSPlaceFieldName | GMSPlaceFieldFormattedAddress); __weak typeof(self) weakSelf = self; [_placesClient findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:placeFields callback:^(NSArray<GMSPlaceLikelihood *> * _Nullable likelihoods, NSError * _Nullable error) { __typeof__(self) strongSelf = weakSelf; if (strongSelf == nil) { return; } if (error != nil) { NSLog(@"An error occurred %@", [error localizedDescription]); return; } GMSPlace *place = likelihoods.firstObject.place; if (place == nil) { strongSelf.nameLabel.text = @"No current place"; strongSelf.addressLabel.text = @""; return; } strongSelf.nameLabel.text = place.name; strongSelf.addressLabel.text = place.formattedAddress; }]; } @end
পরবর্তী পদক্ষেপ
আপনার প্রোজেক্ট কনফিগার হওয়ার পরে, আপনি নমুনা অ্যাপগুলি অন্বেষণ করতে পারেন৷ আপনাকে Cocoapods v1.6.1 ইনস্টল করতে হবে।