সেটআপ এবং ডেমো

প্ল্যাটফর্ম নির্বাচন করুন: Android iOS

এই পৃষ্ঠাটি বর্ণনা করে কিভাবে iOS এর জন্য Maps SDK-এর জন্য ইউটিলিটি লাইব্রেরি সেট আপ করতে হয়।

এই ইউটিলিটিগুলি চেষ্টা করতে, আপনি যেটি করতে পারেন:

• ডেমো অ্যাপটি ইনস্টল করুন এবং চালান । ডেমো অ্যাপটি একটি স্বতন্ত্র প্রকল্প যাতে ইউটিলিটিগুলি চেষ্টা করার জন্য প্রয়োজনীয় সমস্ত কোড থাকে।
• একটি বিদ্যমান Xcode প্রকল্পে ইউটিলিটি লাইব্রেরি ইনস্টল করুন । আপনার নিজস্ব প্রকল্পে এই ইউটিলিটি যোগ করুন.

ঐচ্ছিকভাবে CocoaPods ইনস্টল করুন

ইউটিলিটি লাইব্রেরিটি Google-Maps-iOS-Utils নামে একটি CocoaPods পড হিসাবে উপলব্ধ। CocoaPods হল সুইফট এবং অবজেক্টিভ-সি কোকো প্রকল্পগুলির জন্য একটি ওপেন সোর্স নির্ভরতা ব্যবস্থাপক।

যদি আপনার কাছে ইতিমধ্যেই CocoaPods টুল না থাকে, তাহলে টার্মিনাল থেকে নিম্নলিখিত কমান্ডটি চালিয়ে ম্যাকোসে এটি ইনস্টল করুন:

sudo gem install cocoapods

বিস্তারিত জানার জন্য, CocoaPods শুরু করার নির্দেশিকা দেখুন।

ডেমো অ্যাপটি ইনস্টল করুন এবং চালান

ইউটিলিটি লাইব্রেরিতে একটি ডেমো অ্যাপ রয়েছে যা আপনি ইনস্টল করতে পারেন এবং তারপর প্রতিটি ইউটিলিটি চেষ্টা করে দেখতে পারেন।

CocoaPods সংস্করণ 1.8.1 এবং উচ্চতর সংস্করণে ' pod try ' এর সাথে একটি পরিচিত সমস্যা রয়েছে। আপনি যদি Cocoapods ব্যবহার করে ফাইল আনতে চান, আমরা CocoaPods এর সংস্করণ 1.6.1 ব্যবহার করার পরামর্শ দিই। বিকল্পভাবে, আপনি GitHub থেকে নমুনা ফাইল ডাউনলোড করতে পারেন।

এই দুটি পদ্ধতির একটি ব্যবহার করে ডেমো অ্যাপটি ইনস্টল করুন:

GitHub থেকে ফাইল ব্যবহার করুন

1. GitHub থেকে কোড নমুনা সংরক্ষণাগার ডাউনলোড করুন এবং সংরক্ষণাগারটি আনপ্যাক করুন।
2. একটি টার্মিনাল উইন্ডো খুলুন, সেই ডিরেক্টরিতে নেভিগেট করুন যেখানে আপনি নমুনা ফাইলগুলি প্রসারিত করেছেন এবং আপনি যে ভাষাটি ব্যবহার করতে চান তার জন্য উপযুক্ত নমুনা ডিরেক্টরিতে ড্রিল ডাউন করুন:
   • Swift-এর জন্য, cd google-maps-ios-utils-master/samples/SwiftDemoApp চালান
   • উদ্দেশ্য-সি-এর জন্য, cd google-maps-ios-utils-master/samples/ObjCDemoApp চালান
3. নিম্নলিখিত কমান্ড চালান:
   

   pod install

4. Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রকল্পের .xcworkspace ফাইল খুলুন (ডাবল-ক্লিক করুন)। এই সময় থেকে, আপনাকে প্রকল্পটি খুলতে .xcworkspace ফাইলটি ব্যবহার করতে হবে।

CocoaPods v1.6.1 ব্যবহার করুন

1. একটি টার্মিনাল উইন্ডো খুলুন এবং সংস্করণ 1.6.1 ইনস্টল করুন:

   sudo gem install cocoapods -v1.6.1

2. Cocoapods ব্যবহার করে Google Maps ফাইল আনুন:

   pod try Google-Maps-iOS-Utils

   অনুরোধ করা হলে সুইফট বা অবজেক্টিভ-সি বেছে নিন। CocoaPods আপনার স্পেক রিপোজিটরি আপডেট করে, তারপর SwiftDemoApp.xcodeproj বা ObjCDemoApp.xcodeproj নামে একটি অস্থায়ী Xcode প্রকল্পে ডেমো খোলে।

ডেমো অ্যাপে API কী যোগ করুন

একটি API কী পান , আপনি আপনার অ্যাপের জন্য একটি API কী তৈরি করেন৷ এখন ডেমো অ্যাপের জন্য Xcode প্রকল্পে সেই কী যোগ করুন।

দ্রষ্টব্য: যদি আপনার API কী একটি অ্যাপ্লিকেশন সীমাবদ্ধতা ব্যবহার করে, তাহলে নিশ্চিত করুন যে আপনি কীটিতে আপনার অ্যাপের বান্ডেল শনাক্তকারী যোগ করেছেন। উদাহরণস্বরূপ, আপনি যদি ডেমো অ্যাপ চালাচ্ছেন, তাহলে বান্ডেল শনাক্তকারী হল com.google.gmsutils.DemoApp । একটি কী সীমাবদ্ধ করার বিষয়ে আরও তথ্যের জন্য একটি API কী পান দেখুন৷

সুইফট

নিম্নরূপ আপনার AppDelegate.swift এ আপনার API কী যোগ করুন:

1. নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

   import GoogleMaps

2. ডবল উদ্ধৃতিগুলির মধ্যে আপনার API কী যোগ করতে নিম্নলিখিত লাইনটি সম্পাদনা করুন:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

উদ্দেশ্য গ

নিম্নরূপ আপনার AppDelegate.m এ আপনার API কী যোগ করুন:

1. নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

   @import GoogleMaps;

2. ডবল কোটগুলির মধ্যে আপনার API কী যোগ করতে নিম্নলিখিত লাইনটি সম্পাদনা করুন:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";

ডেমো অ্যাপ তৈরি করুন এবং চালান

আপনি API কী যোগ করার পরে, প্রকল্প তৈরি করুন এবং চালান:

• আপনি যদি ডেমোর সুইফ্ট সংস্করণ চালাচ্ছেন, আপনি অ্যাপটিতে কোন ইউটিলিটি দেখতে পাবেন তা নির্বাচন করতে পারেন।
• আপনি যদি ডেমোর অবজেক্টিভ-সি সংস্করণ চালাচ্ছেন, আপনি মার্কার ক্লাস্টারিং ইউটিলিটির ডেমো দেখতে পাবেন। তারপরে আপনি প্রতিটি ইউটিলিটি চেষ্টা করার জন্য ডেমোর অবজেক্টিভ-সি সংস্করণ সম্পাদনা করতে পারেন। আরও তথ্যের জন্য নীচে আপনার অ্যাপ বিভাগে একটি ইউটিলিটি যুক্ত করুন দেখুন।

একটি এক্সকোড প্রকল্প হিসাবে ইউটিলিটি লাইব্রেরি ইনস্টল করুন

আপনার Xcode কর্মক্ষেত্রে ইউটিলিটি লাইব্রেরি যোগ করতে এই পদক্ষেপগুলি অনুসরণ করুন:

কোকোপড ব্যবহার করুন

1. আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। (যদি আপনি iOS ডেভেলপমেন্টে নতুন হয়ে থাকেন, তাহলে একটি সিঙ্গেল ভিউ অ্যাপ্লিকেশন তৈরি করুন।)
2. আপনার প্রকল্পের জন্য যদি আপনার কাছে ইতিমধ্যে একটি পড ফাইল না থাকে তবে আপনার প্রকল্প ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে।
3. আপনার প্রকল্পের পড ফাইল সম্পাদনা করুন এবং Google-Maps-iOS-Utils পডের উপর নির্ভরতা যোগ করুন। এখানে একটি উদাহরণ রয়েছে যা iOS এর জন্য Maps SDK এবং ইউটিলিটি লাইব্রেরির জন্য আপনার প্রয়োজনীয় নির্ভরতা অন্তর্ভুক্ত করে:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '13.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '7.4.0'
     pod 'Google-Maps-iOS-Utils', '4.2.2'
   end

4. pod install চালান।
5. Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রকল্পের .xcworkspace ফাইল খুলুন (ডাবল-ক্লিক করুন)। এই সময় থেকে, আপনাকে প্রকল্পটি খুলতে .xcworkspace ফাইলটি ব্যবহার করতে হবে।

দ্রষ্টব্য: মার্কার ক্লাস্টারিং ইউটিলিটি কোয়াডট্রির উপর নির্ভরশীল, তবে আপনি মার্কার ক্লাস্টারিং ছাড়াই কোয়াডট্রি ব্যবহার করতে পারেন। আপনি যদি শুধুমাত্র কোয়াডট্রি ইউটিলিটি চান, আপনি আপনার পড ফাইলে pod 'Google-Maps-iOS-Utils' কে 'Google-Maps-iOS-Utils/QuadTree' এ পরিবর্তন করতে পারেন।

কার্থেজ ব্যবহার করুন

1. কার্থেজ ইনস্টল করুন। বিভিন্ন পদ্ধতি আছে, তাই সঠিক পদক্ষেপের জন্য Carthage README ফাইলটি দেখুন ।
2. আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। (যদি আপনি iOS ডেভেলপমেন্টে নতুন হয়ে থাকেন, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন। Xcode 11.7 বা তার আগে, একটি একক দৃশ্য অ্যাপ্লিকেশন তৈরি করুন।)
3. আপনার প্রকল্প ডিরেক্টরিতে Cartfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে।
4. Cartfile সম্পাদনা করুন এবং iOS ইউটিলিটি লাইব্রেরি নির্ভরতার জন্য মানচিত্র SDK যোগ করুন:
   

   github "googlemaps/google-maps-ios-utils"

5. Cartfile সংরক্ষণ করুন।
6. একটি টার্মিনাল উইন্ডোতে, Cartfile ধারণকারী ডিরেক্টরিতে যান:
   

   cd <path-to-project>

7. আপডেট কমান্ড চালান:
   

   carthage update --platform iOS

   
   এটি Cartfile নির্দিষ্ট করা APIগুলিকে ইনস্টল করবে, সাথে তাদের যে কোনো নির্ভরতা থাকতে পারে।
8. ফাইন্ডারে, আপনার প্রজেক্ট ডিরেক্টরিতে, ডাউনলোড করা ফ্রেমওয়ার্ক ফাইলগুলিতে যান Carthage/Build/iOS এর অধীনে।
9. নিম্নলিখিত বান্ডেলগুলিকে আপনার প্রকল্পে টেনে এনে আপনার প্রকল্পে iOS ফ্রেমওয়ার্কের জন্য মানচিত্র SDK যোগ করুন৷ (যখন অনুরোধ করা হয়, প্রয়োজনে অনুলিপি আইটেম নির্বাচন করুন, অনুগ্রহ করে উপরের মত একই সংস্করণ ব্যবহার করুন। )
   • GoogleMaps-xxx/Base/Frameworks/GoogleMapsBase.framework
   • GoogleMaps-xxx/Maps/Frameworks/GoogleMaps.framework
   • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsCore.framework
   • GoogleMaps-xxx/Maps/Frameworks/GoogleMapsUtils.framework
10. আপনার প্রোজেক্টে GoogleMaps.framework রাইট-ক্লিক করুন, এবং Show In Finder নির্বাচন করুন।
11. আপনার প্রকল্পে Resources ফোল্ডার থেকে Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle টেনে আনুন। যখন অনুরোধ করা হয়, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গোষ্ঠীর ফোল্ডারে অনুলিপি করুন নির্বাচন করা হয়নি ৷
12. প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
13. আপনার অ্যাপ্লিকেশনের টার্গেটের জন্য বিল্ড ফেজ ট্যাবটি খুলুন এবং লাইব্রেরিগুলির সাথে লিঙ্ক বাইনারি এর মধ্যে, নিম্নলিখিত কাঠামো যুক্ত করুন:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

14. একটি নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন। অন্যান্য লিঙ্কার পতাকা বিভাগে, -ObjC যোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তবে বিল্ড সেটিংস বারে ফিল্টারটি বেসিক থেকে সকলে পরিবর্তন করুন৷

সুইফট প্যাকেজ ম্যানেজার ব্যবহার করুন

1. আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। (আপনি যদি iOS ডেভেলপমেন্টে নতুন হন, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন। Xcode 11.7 বা তার বেশি বয়সে, একটি একক দৃশ্য অ্যাপ্লিকেশন তৈরি করুন।)
2. নির্ভরতা হিসেবে iOS-এর জন্য Maps SDK যোগ করুন। বিকল্পগুলির জন্য SDK ইনস্টল করা দেখুন।
3. আপনার Xcode প্রকল্পে, ফাইল -> সুইফ্ট প্যাকেজ -> প্যাকেজ নির্ভরতা যোগ করুন এ নেভিগেট করুন।
4. উপস্থাপিত উইন্ডোতে, iOS ইউটিলিটি লাইব্রেরির সংগ্রহস্থলের URL https://github.com/googlemaps/google-maps-ios-utils এর জন্য মানচিত্র SDK লিখুন এবং পরবর্তী নির্বাচন করুন।
• এই মুহুর্তে, আপনাকে আপনার GitHub অ্যাকাউন্টের সাথে প্রমাণীকরণ করতে বলা হতে পারে। প্রক্রিয়া চালিয়ে যেতে একটি GitHub ব্যক্তিগত অ্যাক্সেস টোকেন তৈরি করতে নির্দেশাবলী অনুসরণ করুন।
5. পরবর্তী উইন্ডোতে, সংস্করণ রেডিও বিকল্পটি নির্বাচন করুন, ড্রপডাউন তালিকা থেকে সঠিক নির্বাচন করুন, iOS ইউটিলিটি লাইব্রেরির জন্য মানচিত্র SDK এর সর্বশেষ সংস্করণটি প্রবেশ করুন (যেমন "3.4.0") এবং পরবর্তী নির্বাচন করুন।

আপনার অ্যাপে API কী যোগ করুন

একটি API কী তৈরি করা এবং এটিকে আপনার Xcode প্রকল্পে যুক্ত করার নির্দেশাবলীর জন্য একটি Xcode প্রকল্প সেট আপ করুন দেখুন৷

নির্মাণ এবং প্রকল্প চালানো

আপনি API কী যোগ করার পরে, প্রকল্প তৈরি করুন এবং চালান।

আপনার অ্যাপে একটি ইউটিলিটি যোগ করুন

আপনার অ্যাপে এটি ব্যবহার করার বিষয়ে আরও তথ্যের জন্য প্রতিটি ইউটিলিটির ডকুমেন্টেশন দেখুন:

• মার্কার ক্লাস্টারিং
• কোয়াডট্রি
• KML রেন্ডারিং
• GeoJSON রেন্ডারিং
• তাপ মানচিত্র