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

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

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

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

একটি Xcode প্রকল্পে iOS ইউটিলিটি লাইব্রেরির জন্য মানচিত্র SDK যোগ করুন

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

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

  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 এর সর্বশেষ সংস্করণটি প্রবেশ করুন (উদাহরণস্বরূপ, "6.0.0")৷
  6. প্রকল্পে যোগ করুন এর পাশের ড্রপ-ডাউনে ক্লিক করুন, আপনার প্রকল্প নির্বাচন করুন এবং প্যাকেজ যুক্ত করুন নির্বাচন করুন।

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

  1. আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। (যদি আপনি iOS ডেভেলপমেন্টে নতুন হয়ে থাকেন, তাহলে একটি সিঙ্গেল ভিউ অ্যাপ্লিকেশন তৈরি করুন।)
  2. আপনার প্রকল্পের জন্য যদি আপনার কাছে ইতিমধ্যে একটি পড ফাইল না থাকে তবে আপনার প্রকল্প ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে।
  3. আপনার প্রকল্পের পড ফাইল সম্পাদনা করুন এবং Google-Maps-iOS-Utils পডের উপর নির্ভরতা যোগ করুন। iOS এর জন্য Maps SDK এবং ইউটিলিটি লাইব্রেরির জন্য আপনার প্রয়োজনীয় নির্ভরতাগুলি এখানে একটি উদাহরণ রয়েছে:
    source 'https://github.com/CocoaPods/Specs.git'
    platform :ios, '15.0'
    
    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      use_frameworks!
      pod 'GoogleMaps', '9.0.0'
      pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
    end
  4. pod install চালান।
  5. Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রকল্পের .xcworkspace ফাইল খুলুন (ডাবল-ক্লিক করুন)। এই সময় থেকে, আপনাকে প্রকল্পটি খুলতে .xcworkspace ফাইলটি ব্যবহার করতে হবে।

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

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

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

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

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

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

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

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

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

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

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 প্রকল্পে সেই কী যোগ করুন।

সুইফট

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

  1. নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
    import GoogleMaps
  2. ডবল উদ্ধৃতিগুলির মধ্যে আপনার API কী যোগ করতে নিম্নলিখিত লাইনটি সম্পাদনা করুন:
    // Change this key to a valid key registered with the demo app bundle id.
    let mapsAPIKey = ""

উদ্দেশ্য-C

নিম্নরূপ আপনার 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 কী যোগ করার পরে, প্রকল্প তৈরি করুন এবং চালান:

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