সেটআপ

iOS-এর জন্য Maps 3D SDK-এর সাহায্যে তৈরি করা শুরু করার জন্য আপনাকে কী কী সেট-আপ করতে হবে তা এই পৃষ্ঠায় বর্ণনা করা হয়েছে। সেট-আপ প্রসেসে SDK-এর সাথে ব্যবহার করার জন্য Google Cloud প্রোজেক্ট ও API কনফিগার করা এবং তারপর Xcode প্রোজেক্ট সেট-আপ করা অন্তর্ভুক্ত। আপনার অ্যাপে প্রথম 3D ম্যাপ যোগ করার আগে এইসব ধাপ সম্পূর্ণ করুন।

পূর্বশর্ত

iOS-এর জন্য Maps 3D SDK ব্যবহার করতে, আপনার প্রোজেক্ট এবং টার্গেট ডিভাইসে নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করতে হবে:

  • iOS-এর ন্যূনতম ভার্সন: iOS 16.0 বা তার পরবর্তী ভার্সন টার্গেট করুন।
  • Xcode: Xcode ভার্সন 16.0 বা তার পরবর্তী যেকোনও ভার্সন।

Google Cloud প্রোজেক্ট ও API কী সেট-আপ করা

iOS-এর জন্য Maps 3D SDK ব্যবহার করে তৈরি করা শুরু করার আগে, আপনাকে iOS-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য Google Cloud প্রোজেক্ট এবং API কী সেট-আপ করতে হবে। এর জন্য নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

ধাপ ১

কনসোল

  1. Google Cloud কনসোলে, প্রোজেক্ট সিলেক্টর পৃষ্ঠায়, নতুন Cloud প্রোজেক্ট তৈরি করা শুরু করতে প্রোজেক্ট তৈরি করুন বিকল্পে ক্লিক করুন।

    প্রোজেক্ট সিলেক্টর পৃষ্ঠায় যান

  2. আপনার Cloud প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা ভাল করে দেখে নিন। আপনার প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা কনফার্ম করুন।

    Google Cloud-এ $০.০০ চার্জের ট্রায়াল অফার করা হয়। ৯০ দিনের শেষে অথবা অ্যাকাউন্টে $৩০০ মূল্যের চার্জ জমা হওয়ার পরে, যেটি আগে হবে, ট্রায়ালের মেয়াদ শেষ হয়ে যাবে। যখন খুশি বাতিল করুন। আরও তথ্যের জন্য, বিলিং অ্যাকাউন্ট ক্রেডিট এবং বিলিং দেখুন।

Cloud SDK

gcloud projects create "PROJECT"

Google Cloud SDK , Cloud SDK ইনস্টলেশন , এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

ধাপ ২

Google Maps Platform ব্যবহার করতে, আপনার প্রোজেক্টের সাথে যে API বা SDK ব্যবহার করার পরিকল্পনা করছেন তা চালু করতে হবে।

মনে রাখবেন, কিছু ইন্টিগ্রেশনের জন্য আপনাকে একাধিক API/SDK চালু করতে হবে। কোন API বা SDK চালু করতে হবে তা নিশ্চিত না হলে, ক্যাপাবিলিটি এক্সপ্লোরার ব্যবহার করে দেখুন অথবা আপনি যে API/SDK ব্যবহার করতে চান তার ডকুমেন্টেশন দেখুন।

এক বা একাধিক API বা SDK চালু করতে:

কনসোল

  1. Google Maps Platform API এবং SDK দেখুন যা আপনি Cloud কনসোলে Maps API লাইব্রেরি পৃষ্ঠায় গিয়ে চালু করতে পারবেন:

    Maps API লাইব্রেরি পৃষ্ঠাতে যান

  2. আপনি যে API বা SDK চালু করতে চান সেটিতে ক্লিক করুন।
    • বোতামে চালু করুন লেখা থাকলে, API বা SDK চালু করতে বোতামে ক্লিক করুন।
    • বোতামে ম্যানেজ করুন লেখা থাকলে, API বা SDK আগে থেকেই চালু করা আছে এবং আপনাকে আর কিছু করতে হবে না।
    • যেকোনও একটি বোতামে ক্লিক করলে API বা SDK-এর জন্য ড্যাশবোর্ড দেখা যাবে। (এই প্রোজেক্ট থেকে API বা SDK সরাতে বন্ধ করুন বোতামে ক্লিক করুন।)

Cloud SDK

নিম্নলিখিত কমান্ডটি Maps, Routes এবং Places API-এর সবকটি চালু করে:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Google Cloud SDK , Cloud SDK ইনস্টলেশন , এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

Environment API চালু করতে এই কমান্ড ব্যবহার করুন:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

ধাপ ৩

এই ধাপে শুধু API Key তৈরি করার প্রসেস দেখানো হয়। আপনি প্রোডাকশনে API Key ব্যবহার করলে, আমরা আপনাকে API Key-এর ব্যবহার সীমিত করার জন্য জোরালো সাজেশন দিই। আপনি প্রোডাক্ট-নির্দিষ্ট API কী ব্যবহার করা পৃষ্ঠায় আরও তথ্য পেতে পারেন।

API কী হল একটি অনন্য শনাক্তকারী যা ব্যবহার এবং বিলিংয়ের উদ্দেশ্যে আপনার প্রোজেক্টের সাথে সম্পর্কিত অনুরোধগুলি যাচাই করে। আপনার প্রোজেক্টের সাথে অন্তত একটি API কী যুক্ত থাকতে হবে।

API key তৈরি করতে:

কনসোল

  1. Google Maps Platform > ক্রেডেনশিয়াল পৃষ্ঠায় যান।

    ক্রেডেনশিয়াল পৃষ্ঠায় যান

  2. ক্রেডেনশিয়াল পৃষ্ঠায়, ক্রেডেনশিয়াল তৈরি করুন > API কী বিকল্পে ক্লিক করুন।
    API key তৈরি করা হয়েছে ডায়ালগে আপনার নতুন তৈরি করা API key দেখানো হয়।
  3. বন্ধ করুন বিকল্পে ক্লিক করুন।
    নতুন API key ক্রেডেনশিয়াল পৃষ্ঠায় API key-এর অধীনে তালিকাভুক্ত করা হয়েছে।
    (প্রোডাকশনে ব্যবহার করার আগে API key সীমাবদ্ধ করতে ভুলবেন না।)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK , Cloud SDK ইনস্টলেশন , এবং নিম্নলিখিত কমান্ড সম্পর্কে আরও পড়ুন:

SDK চালু করতে, Google Cloud কনসোলে iOS-এর জন্য Maps 3D SDK পৃষ্ঠা দেখুন। এইসব ধাপ সম্পূর্ণ করার ব্যাপারে আরও তথ্য পেতে, Google Maps Platform ব্যবহার শুরু করা দেখুন।

Xcode প্রোজেক্ট সেট-আপ করা

এই বিভাগে, iOS-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য কীভাবে একটি Xcode প্রোজেক্ট তৈরি এবং কনফিগার করতে হয় তা ব্যাখ্যা করা হয়েছে।

বিলিং চালু করা এবং API কী তৈরি করার পরে, আপনি Xcode প্রোজেক্ট সেট-আপ করার জন্য প্রস্তুত যা আপনি নিজের অ্যাপ ডেভেলপ করার জন্য ব্যবহার করেন।

ধাপ ১: প্রয়োজনীয় সফ্টওয়্যার ইনস্টল করা

iOS-এর জন্য Maps 3D SDK ব্যবহার করে কোনও প্রোজেক্ট তৈরি করতে, আপনাকে অবশ্যই ডাউনলোড ও ইনস্টল করতে হবে:

  • Xcode ভার্সন 16.0 বা তার পরবর্তী যেকোনও ভার্সন

ধাপ ২: Xcode প্রোজেক্ট তৈরি করুন এবং iOS-এর জন্য Maps 3D SDK ইনস্টল করুন

Swift প্যাকেজ ম্যানেজার

iOS-এর জন্য Maps 3D SDK, Swift প্যাকেজ ম্যানেজার ব্যবহার করে ইনস্টল করা যেতে পারে।

নতুন বা আগে থেকে থাকা প্রোজেক্টে SDK যোগ করতে, এইসব ধাপ অনুসরণ করুন:

  • আপনার Xcode project বা workspace খুলুন, তারপর ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন বিকল্পে যান।
  • URL হিসেবে https://github.com/googlemaps/ios-maps-3d-sdk লিখুন, প্যাকেজটি পুল করতে Enter প্রেস করুন এবং "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
  • প্যাকেজ প্রোডাক্ট বেছে নিন উইন্ডো থেকে, আপনার নির্দিষ্ট করা প্রধান টার্গেটে GoogleMaps3D যোগ করা হবে কিনা তা যাচাই করুন। সম্পূর্ণ হলে, প্যাকেজ যোগ করুন বিকল্পে ক্লিক করুন।
  • আপনার ইনস্টলেশন যাচাই করতে, আপনার টার্গেটের সাধারণ প্যানে নেভিগেট করুন। ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট বিকল্পে, আপনাকে ইনস্টল করা প্যাকেজ দেখতে হবে। এছাড়াও, প্যাকেজ ও তার ভার্সন যাচাই করতে, আপনি প্রোজেক্ট নেভিগেটর-এর প্যাকেজ ডিপেন্ডেন্সি বিভাগ দেখতে পারেন।

ধাপ ৩: আপনার অ্যাপে API key যোগ করুন

Swift প্যাকেজ ম্যানেজার

আপনার অ্যাপের মূল এন্ট্রি পয়েন্টে (অথবা ম্যাপ লোড হওয়ার আগে যেকোনও সময়) নিচে দেখানো পদ্ধতিতে API key যোগ করুন।

  1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্ট যোগ করুন: 
    import GoogleMaps3D
  2. নিম্নলিখিত পদ্ধতি যোগ করুন। আপনার API key দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন। 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

ধাপ ৪ (ঐচ্ছিক): Apple গোপনীয়তা ম্যানিফেস্ট ফাইল পরীক্ষা করা

Apple-এর ক্ষেত্রে App Store-এ থাকা অ্যাপের জন্য অ্যাপের গোপনীয়তা সংক্রান্ত বিবরণ প্রয়োজন।

SDK-এর জন্য রিসোর্স বান্ডেলে Apple-এর গোপনীয়তা ম্যানিফেস্ট ফাইল অন্তর্ভুক্ত করা হয়েছে। প্রাইভেসি ম্যানিফেস্ট ফাইল অন্তর্ভুক্ত করা হয়েছে কিনা তা যাচাই করতে এবং এর কন্টেন্ট পরীক্ষা করতে, আপনার অ্যাপের একটি আর্কাইভ তৈরি করুন এবং আর্কাইভ থেকে একটি গোপনীয়তা রিপোর্ট তৈরি করুন।

পরবর্তী ধাপ

এখন আপনার কাছে iOS-এর জন্য Maps 3D SDK-এর সাথে ব্যবহার করার জন্য সেট-আপ করা Google Cloud প্রোজেক্ট, API কী এবং Xcode প্রোজেক্ট আছে, আপনি আপনার অ্যাপে একটি 3D ম্যাপ যোগ করতে পারবেন।