Places SDK for iOS-এর সাথে সরবরাহ করা GitHub- এর ডেমো অ্যাপটিতে Place Autocomplete এবং Place Photos-সহ বেশ কিছু ফিচার প্রদর্শন করা হয়েছে। এছাড়াও, আপনি এই ডেভেলপার গাইডের প্রতিটি পৃষ্ঠায় কোড স্নিপেট খুঁজে পাবেন। অ্যাপটি ইম্পোর্ট ও বিল্ড করুন, আপনার API কী যোগ করুন, ডেমোটি দেখুন এবং আপনার অ্যাপের সূচনা হিসেবে সরবরাহ করা নমুনা কোডটি ব্যবহার করুন।
যখন আপনি নমুনা অ্যাপটি চালাবেন, তখন এটি উপলব্ধ নমুনাগুলির একটি তালিকা প্রদর্শন করবে যা আপনি আপনার নিজের ডিভাইসে চালাতে পারেন। বিকল্পগুলি থেকে একটি বেছে নিন।
সম্পূর্ণ নমুনা অ্যাপটি স্থানীয়ভাবে চালান
Places SDK for iOS স্যাম্পল অ্যাপটি GitHub থেকে একটি ডাউনলোড আর্কাইভ হিসেবে পাওয়া যায়। Places SDK for iOS স্যাম্পল অ্যাপটি ইনস্টল ও ব্যবহার করে দেখার জন্য এই ধাপগুলো অনুসরণ করুন।
- গিটহাব থেকে কোড স্যাম্পল আর্কাইভটি ডাউনলোড করে আনপ্যাক করুন। বিকল্পভাবে, রিপোজিটরিটি আপনার স্থানীয় কোনো ডিরেক্টরিতে ক্লোন করুন:
git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
একটি টার্মিনাল উইন্ডো খুলুন, সেই ডিরেক্টরিতে যান যেখানে আপনি নমুনা ফাইলগুলি এক্সপ্যান্ড করেছেন, এবং আপনি যে সংস্করণটি ব্যবহার করতে চান তার ডিরেক্টরিতে প্রবেশ করুন:
SwiftUI
cd ios-places-sdk-samples/GooglePlacesDemos/
open GooglePlacesDemos.xcodeprojসুইফট
cd ios-places-sdk-samples/GooglePlaces-Swift/
open GooglePlacesSwiftDemos.xcodeprojউদ্দেশ্য-সি
cd ios-places-sdk-samples/Archive/GooglePlaces
open GooglePlacesXCFrameworkDemos.xcodeproj- Xcode প্রজেক্টে, File > Add Package Dependencies- এ যান। URL হিসেবে https://github.com/googlemaps/ios-places-sdk লিখুন, প্যাকেজটি যুক্ত করতে Enter চাপুন এবং Add Package-এ ক্লিক করুন।
- আপনার গুগল ক্লাউড কনসোল প্রজেক্টের জন্য আইওএস-এর প্লেসেস এসডিকে এবং আইওএস-এর ম্যাপস এসডিকে সক্রিয় করুন।
- আপনার প্রজেক্ট থেকে একটি এপিআই কী (API key) নিন, যেখানে প্লেসেস এপিআই (Places API) এবং/অথবা প্লেসেস এপিআই (নতুন) (Places API (New)) সক্রিয় করা আছে ।
- নিচের উপযুক্ত নির্দেশাবলী অনুসরণ করে আপনার এপিআই কী (API key) অ্যাপটিতে যুক্ত করুন।
SwiftUI
আপনার এপিআই কী-এর জন্য, ডেমো অ্যাপ্লিকেশনটির
Info.plistফাইলের (GooglePlacesDemos/GooglePlacesDemos) একই ডিরেক্টরিতেGooglePlacesDemos.xcconfigনামে একটি স্থানীয় কনফিগারেশন ফাইল তৈরি করুন।আপনার API কীগুলো নির্ধারণ করতে আপনার কনফিগারেশন ফাইলে দুটি লাইন যোগ করুন:
PLACES_API_KEY = YOUR_PLACES_API_KEYএবংMAPS_API_KEY = YOUR_MAPS_API_KEY।পূর্ববর্তী ধাপগুলো থেকে প্রাপ্ত এপিআই কীগুলো দিয়ে
YOUR_PLACES_API_KEYএবংYOUR_MAPS_API_KEYপ্রতিস্থাপন করুন।স্থানীয় কনফিগারেশন ফাইল তৈরি করার বিষয়ে সাহায্যের জন্য কনফিগারেশন সেটিংস ফাইল (xcconfig) ফরম্যাট দেখুন।
সুইফট
SDKDemoAPIKeyফাইলটি সম্পাদনা করুন এবং আপনার API কী-টি উপযুক্ত কনস্ট্যান্টে পেস্ট করুন। উদাহরণস্বরূপ:let placesAPIKey = "YOUR_API_KEY"
যদি থাকে, তাহলে নিম্নলিখিত লাইনটি মুছে ফেলুন:
#error (Register for API Key and insert here. Then delete this line.)
সম্পাদনার জন্য Xcode যদি আপনাকে
SDKDemoAPIKeyফাইলটি আনলক করতে বলে, তাহলে ‘আনলক’ (Unlock ) বিকল্পটি বেছে নিন।উদ্দেশ্য-সি
SDKDemoAPIKeyফাইলটি সম্পাদনা করুন এবং আপনার API কী-টি উপযুক্ত কনস্ট্যান্টে পেস্ট করুন। উদাহরণস্বরূপ:static NSString *const kAPIKey = @"YOUR_API_KEY";
যদি থাকে, তাহলে নিম্নলিখিত লাইনটি মুছে ফেলুন।
#error (Register for API Key and insert here. Then delete this line.)সম্পাদনার জন্য Xcode যদি আপনাকে
SDKDemoAPIKeyফাইলটি আনলক করতে বলে, তাহলে ‘আনলক’ (Unlock ) বিকল্পটি বেছে নিন। - অ্যাপটি তৈরি করুন ।
- প্রথমবার চালানোর সময় যদি বিল্ড ব্যর্থ হয় বা আপনার এপিআই কী (API key) সংক্রান্ত কোনো ত্রুটির কারণে অ্যাপটি ক্র্যাশ করে, তাহলে নিশ্চিত করুন যে আপনি উপরের নির্দেশাবলীতে প্রয়োজনীয় কীগুলো প্রদান করেছেন।
- আপনি নমুনা অ্যাপটি চালালে, iOS সিমুলেটর উইন্ডোতে প্লেসেস ডেমোগুলোর একটি তালিকা দেখানো হবে।
- ডেমো অ্যাপটিকে আপনার অবস্থান অ্যাক্সেস করার অনুমতি দিতে বলা হলে, 'অনুমতি দিন' (Allow ) নির্বাচন করুন।
- আপনার নির্বাচিত নমুনাটি এখন চালানোর জন্য প্রস্তুত।