সেটআপ

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

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

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

ধাপ ১

কনসোল

  1. গুগল ক্লাউড কনসোলে, প্রজেক্ট সিলেক্টর পৃষ্ঠায়, একটি নতুন ক্লাউড প্রজেক্ট তৈরি শুরু করতে প্রজেক্ট তৈরি করুন এ ক্লিক করুন।

    প্রকল্প নির্বাচক পৃষ্ঠায় যান।

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

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

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

gcloud projects create "PROJECT"

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

ধাপ ২

গুগল ম্যাপস প্ল্যাটফর্ম ব্যবহার করার জন্য, আপনার প্রকল্পের সাথে ব্যবহার করার পরিকল্পনা করা API বা SDK গুলি সক্ষম করতে হবে।

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

এক বা একাধিক API বা SDK সক্ষম করতে:

কনসোল

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

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

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

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

নিম্নলিখিত কমান্ডটি সমস্ত মানচিত্র, রুট এবং স্থান 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"

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

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

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

ধাপ ৩

এই ধাপটি শুধুমাত্র API কী তৈরির প্রক্রিয়ার মধ্য দিয়ে যায়। আপনি যদি আপনার API কী উৎপাদনে ব্যবহার করেন, তাহলে আমরা দৃঢ়ভাবে সুপারিশ করছি যে আপনি আপনার API কী সীমাবদ্ধ রাখুন। আপনি পণ্য-নির্দিষ্ট API কী ব্যবহার পৃষ্ঠায় আরও তথ্য পেতে পারেন।

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

একটি API কী তৈরি করতে:

কনসোল

  1. গুগল ম্যাপস প্ল্যাটফর্ম > শংসাপত্র পৃষ্ঠায় যান।

    শংসাপত্র পৃষ্ঠায় যান

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

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

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

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

SDK সক্ষম করতে, Google ক্লাউড কনসোলে iOS পৃষ্ঠার জন্য Maps 3D SDK দেখুন। এই পদক্ষেপগুলি সম্পূর্ণ করার বিষয়ে আরও তথ্যের জন্য, Google Maps প্ল্যাটফর্ম দিয়ে শুরু করা দেখুন।

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

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

বিলিং সক্ষম করার পরে এবং একটি API কী তৈরি করার পরে, আপনি আপনার অ্যাপটি তৈরি করতে যে 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 লিখুন, প্যাকেজটি টেনে আনতে এন্টার টিপুন এবং "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
  • "প্যাকেজ পণ্য নির্বাচন করুন" উইন্ডো থেকে, যাচাই করুন যে GoogleMaps3D আপনার নির্ধারিত প্রধান লক্ষ্যবস্তুতে যোগ করা হয়েছে। সম্পন্ন হলে, "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
  • আপনার ইনস্টলেশন যাচাই করতে, আপনার টার্গেটের জেনারেল প্যানে নেভিগেট করুন। ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্টে , আপনি ইনস্টল করা প্যাকেজগুলি দেখতে পাবেন। প্যাকেজ এবং এর সংস্করণ যাচাই করতে আপনি প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগটিও দেখতে পারেন।

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

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

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

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

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

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

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

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

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

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