সেটআপ

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

একটি গুগল ক্লাউড প্রজেক্ট এবং এপিআই কী সেট আপ করুন

Maps 3D SDK for iOS দিয়ে বিল্ড করা শুরু করার আগে, আপনাকে নিম্নলিখিত ধাপগুলো সম্পন্ন করে একটি Google Cloud প্রজেক্ট এবং API কী সেট আপ করতে হবে:

ধাপ ১

কনসোল

  1. গুগল ক্লাউড কনসোলের প্রজেক্ট সিলেক্টর পেজে, একটি নতুন ক্লাউড প্রজেক্ট তৈরি করা শুরু করতে 'Create Project'-এ ক্লিক করুন।

    প্রজেক্ট সিলেক্টর পেজে যান

  2. আপনার ক্লাউড প্রজেক্টের জন্য বিলিং চালু আছে কিনা তা নিশ্চিত করুন। আপনার প্রজেক্টের জন্য বিলিং চালু আছে কিনা তা যাচাই করুন ।

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

ক্লাউড এসডিকে 

gcloud projects create "PROJECT"

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

ধাপ ২

গুগল ম্যাপস প্ল্যাটফর্ম ব্যবহার করতে হলে, আপনার প্রোজেক্টে যে এপিআই বা এসডিকেগুলো ব্যবহার করার পরিকল্পনা করছেন, সেগুলো অবশ্যই সক্রিয় করতে হবে।

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

এক বা একাধিক এপিআই বা এসডিকে সক্রিয় করতে:

কনসোল

  1. ক্লাউড কনসোলের ম্যাপস এপিআই লাইব্রেরি পৃষ্ঠায় গিয়ে আপনি গুগল ম্যাপস প্ল্যাটফর্ম এপিআই এবং এসডিকেগুলো দেখতে পারেন যা আপনি সক্রিয় করতে পারবেন:

    ম্যাপস এপিআই লাইব্রেরি পৃষ্ঠায় যান

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

ক্লাউড এসডিকে

নিম্নলিখিত কমান্ডটি 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"

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

এনভায়রনমেন্ট এপিআইগুলো সক্রিয় করতে এই কমান্ডটি ব্যবহার করুন:

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

ধাপ ৩

এই ধাপে শুধুমাত্র এপিআই কী (API Key) তৈরির প্রক্রিয়াটি বর্ণনা করা হয়েছে। আপনি যদি প্রোডাকশনে আপনার এপিআই কী ব্যবহার করেন, তবে আমরা আপনাকে এটি সীমাবদ্ধ করার জন্য দৃঢ়ভাবে সুপারিশ করছি। আপনি পণ্য-নির্দিষ্ট 'এপিআই কী ব্যবহার' (Using API Keys) পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

একটি এপিআই কী তৈরি করতে:

কনসোল

  1. গুগল ম্যাপস প্ল্যাটফর্ম > ক্রেডেনশিয়ালস পৃষ্ঠায় যান।

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

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

ক্লাউড এসডিকে 

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

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

SDK সক্রিয় করতে, Google Cloud কনসোলে থাকা Maps 3D SDK for iOS পৃষ্ঠাটি দেখুন। এই ধাপগুলি সম্পন্ন করার বিষয়ে আরও তথ্যের জন্য, "Getting started with the Google Maps Platform " দেখুন।

একটি Xcode প্রজেক্ট সেট আপ করুন

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

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

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

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

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

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

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

নতুন বা বিদ্যমান প্রকল্পে SDK যোগ করতে, এই ধাপগুলো অনুসরণ করুন:

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

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

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

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

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

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

ধাপ ৪ (ঐচ্ছিক): অ্যাপল প্রাইভেসি ম্যানিফেস্ট ফাইলটি পরিদর্শন করুন

অ্যাপ স্টোরে থাকা অ্যাপগুলোর জন্য অ্যাপল অ্যাপের গোপনীয়তার বিবরণ চেয়ে থাকে।

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

পরবর্তী পদক্ষেপ

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