সেটআপ

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. আপনার ক্লাউড প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা নিশ্চিত করুন। আপনার প্রোজেক্টের জন্য বিলিং চালু করা আছে কিনা তা কনফার্ম করুন।

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

Cloud SDK

gcloud projects create "PROJECT"

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

ধাপ ২: API বা 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 key-এর ব্যবহার সীমিত করার জন্য জোরালো সাজেশন দিই। আপনি প্রোডাক্ট-নির্দিষ্ট API কী ব্যবহার করা পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

কনসোল

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

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

  2. প্রম্পট করা হলে, আপনার প্রোজেক্ট বেছে নিন।

  3. নিম্নলিখিতগুলির মধ্যে থেকে যেকোনও একটি করুন:

    • নতুন 'কী' তৈরি করুন:

      1. ক্রেডেনশিয়াল তৈরি করুন > API key বিকল্পে ক্লিক করুন।
      2. API key তৈরি করুন প্যানেলে, API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা খুলুন।
      3. এই 'কী'-এর প্রয়োজন নেই এমন যেকোনও API মুছে দিন এবং নিশ্চিত করুন যে আপনি যেসব API ব্যবহার করার পরিকল্পনা করছেন সেগুলি বেছে নেওয়া আছে।
      4. তৈরি করুন বিকল্পে ক্লিক করুন। প্যানেলে আপনার নতুন API কী দেখা যাবে।

    • আগে থেকে থাকা 'কী' ব্যবহার করুন:

      1. 'কী'-এর নামে ক্লিক করুন।
      2. API সংক্রান্ত বিধিনিষেধ বেছে নিন তালিকা থেকে, আপনি যে API ব্যবহার করার পরিকল্পনা করছেন সেটি বেছে নিন।
      3. সেভ করুন বিকল্পে ক্লিক করুন।

    এখানে API বেছে নিলে তা চালু হয় না। আপনার বেছে নেওয়া প্রতিটি API API লাইব্রেরিতে চালু করা আছে কিনা তা নিশ্চিত করুন।

  4. পরে কী স্ট্রিং দেখতে, কী ও ক্রেডেনশিয়াল পৃষ্ঠায় যান এবং কী-এর জন্য কী দেখুন বিকল্পে ক্লিক করুন।

কনসোলটি যদি এই ধাপগুলির থেকে আলাদা দেখায়, তাহলে Google Cloud ডকুমেন্টেশনে একটি API কী তৈরি করুন এবং API বিধিনিষেধ যোগ করুন দেখুন।

Cloud SDK

নিচের কমান্ডে PROJECT_ID-এর জায়গায় আপনার প্রোজেক্ট আইডি লিখুন।

  • নতুন 'কী' তৈরি করুন: নিম্নলিখিত কমান্ড রান করুন এবং DISPLAY_NAME-এর জায়গায় 'কী'-এর নাম লিখুন। SERVICE_NAME-এর জায়গায় আপনি যে API ব্যবহার করার পরিকল্পনা করছেন, তার পরিষেবার নাম লিখুন, যেমন places.googleapis.com। আরও API-এর অনুমতি দিতে, --api-target ফ্ল্যাগ রিপিট করুন।

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

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

  • আগে থেকে থাকা 'কী' ব্যবহার করুন: নিম্নলিখিত কমান্ড রান করুন এবং KEY_ID-এর জায়গায় 'কী'-এর আইডি লিখুন। যোগ করার জন্য API-এর পরিষেবার নাম দিয়ে SERVICE_NAME প্রতিস্থাপন করুন। --append ফ্ল্যাগ সেইসব API রাখে যেগুলি 'কী' আগে থেকেই অনুমোদন করে। এটি না থাকলে, কমান্ডটি সেগুলি পরিবর্তন করে।

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

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

    'কী' আইডি হল 'কী' স্ট্রিং বা ডিসপ্লে নাম নয়। এটি খুঁজতে, gcloud services api-keys list --project="PROJECT_ID" রান করুন। আইডি হল name ফিল্ডের শেষ অংশ: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID।

কী স্ট্রিং দেখতে, gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" রান করুন।

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 গোপনীয়তা ম্যানিফেস্ট ফাইল পরীক্ষা করা

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

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

পরবর্তী ধাপ

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