এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

আপনার অ্যাপে একটি 3D মানচিত্র যোগ করুন

এই পণ্য বা ফিচারটি পরীক্ষামূলক (প্রি-জিএ)। প্রি-জিএ পণ্য এবং ফিচারগুলিতে সীমিত সাপোর্ট থাকতে পারে, এবং এতে করা পরিবর্তনগুলি অন্যান্য প্রি-জিএ ভার্সনের সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রি-জিএ অফারিংগুলি গুগল ম্যাপস প্ল্যাটফর্ম সার্ভিস স্পেসিফিক টার্মস (Google Maps Platform Service Specific Terms) দ্বারা নিয়ন্ত্রিত। আরও তথ্যের জন্য, লঞ্চ স্টেজের বিবরণ দেখুন।

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড আইওএস জাভাস্ক্রিপ্ট

Basic maps of Seattle, San Francisco, and
Paris

এই পৃষ্ঠায় Maps 3D SDK for iOS ব্যবহার করে একটি iOS অ্যাপে কীভাবে একটি সাধারণ 3D ম্যাপ যোগ করতে হয়, তার একটি উদাহরণ দেখানো হয়েছে। এই পৃষ্ঠার নির্দেশাবলীতে ধরে নেওয়া হয়েছে যে আপনি ইতিমধ্যেই সেটআপ পৃষ্ঠার ধাপগুলি সম্পন্ন করেছেন এবং আপনার কাছে নিম্নলিখিত জিনিসগুলি রয়েছে:

একটি গুগল ক্লাউড প্রজেক্ট যেখানে iOS-এর জন্য Maps 3D SDK সক্রিয় করা আছে
iOS-এর জন্য Maps 3D SDK-এর একটি API কী
Xcode ভার্সন 16.0 বা তার পরবর্তী সংস্করণ, সাথে iOS-এর জন্য Maps 3D SDK প্যাকেজটি যুক্ত থাকতে হবে।

এই পূর্বশর্তগুলো সম্পর্কে আরও তথ্যের জন্য, সেটআপ দেখুন।

আরও উন্নত কোডল্যাব অনুসরণ করুন ।

গিটহাবে আরও কোড নমুনা দেখুন ।

পর্ব ১: একটি সাধারণ SwiftUI অ্যাপ তৈরি করুন

Xcode-এ একটি নতুন অ্যাপ তৈরি করুন।
আপনার প্রোডাক্টের নাম Hello3DWorld রাখুন এবং অর্গানাইজেশন আইডেন্টিফায়ার হিসেবে com.example সেট করুন। প্যাকেজের নাম হবে com.example.Hello3DWorld ।
SwiftUI ইন্টারফেসটি বেছে নিন।
আপনার অ্যাপে Maps 3D লাইব্রেরিটি যোগ করুন। সেটআপ বিভাগে নির্দেশাবলী দেখুন ।

পর্ব ২: একটি মানচিত্র যোগ করুন

Minimal 3D map of a
globe

ContentView.swift নামের ফাইলটি খুলুন। এটি আপনার অ্যাপের এন্ট্রি পয়েন্ট এবং প্রধান নেভিগেশন।
SwiftUI এবং GoogleMaps3D প্যাকেজটি ইম্পোর্ট করুন।
বডি ডিক্লারেশনের ভেতরের সমস্ত কোড Map(mode: .hybrid) দিয়ে প্রতিস্থাপন করুন।
একটি Map ইনিশিয়ালাইজ করার জন্য আপনাকে যে ন্যূনতম প্রাথমিক কনফিগারেশনটি সরবরাহ করতে হবে তা হলো MapMode :
- .হাইব্রিড, অথবা
- .স্যাটেলাইট
আপনার ContentView.swift ফাইলটি দেখতে এইরকম হওয়া উচিত:
```
import SwiftUI
import GoogleMaps3D

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

#Preview {
  ContentView()
}
```

পর্ব ৩: আপনার এপিআই কী সেট করুন।

ম্যাপ ইনিশিয়ালাইজ করার আগে এপিআই কী অবশ্যই সেট করতে হবে। এটি করার জন্য, যে View ম্যাপটি রয়েছে তার init() ইভেন্ট হ্যান্ডলারে Map.apiKey সেট করুন।
সতর্কীকরণ: এপিআই কী (API key) বাহ্যিক বা পাবলিক সোর্স কন্ট্রোলে চেক ইন করবেন না।
```
import SwiftUI
import GoogleMaps3D

struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

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

পর্ব ৪: মানচিত্রের দৃশ্য নিয়ন্ত্রণ করতে ক্যামেরা ব্যবহার করুন

3D ম্যাপ ভিউ Camera ক্লাস দ্বারা নিয়ন্ত্রিত হয়। এই ধাপে আপনি শিখবেন কীভাবে ম্যাপ ভিউ কাস্টমাইজ করার জন্য অবস্থান, উচ্চতা, হেডিং, টিল্ট, রোল এবং রেঞ্জ নির্দিষ্ট করতে হয়।

Map() ফাংশন কলটি পরিবর্তন করে একটি initialCamera প্রপার্টি অন্তর্ভুক্ত করুন। ডাউনটাউন ম্যানহাটনের দৃশ্য দেখানোর জন্য initialCamera ইনিশিয়ালাইজ করুন।
দ্রষ্টব্য: প্যারামিটারের ক্রম গুরুত্বপূর্ণ। ক্যামেরা চালু করার জন্য প্রথমে অক্ষাংশ এবং তারপর দ্রাঘিমাংশ প্রদান করতে হয়। প্রতিটির জন্য সঠিক মান উল্লেখ করেছেন কিনা তা নিশ্চিত করুন, বিশেষ করে যখন অন্য কোনো উৎস থেকে পেস্ট করছেন, অন্যথায় ক্যামেরা একটি অপ্রত্যাশিত অবস্থান দেখাতে পারে।
```
import SwiftUI
import GoogleMaps3D

struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }
  var body: some View {
    Map(initialCamera: .init(
      latitude: 40.748339,
      longitude: -73.985912,
      altitude: 211.1,
      heading: 52,
      tilt: 68,
      range: 1039
    ), mode: .hybrid)
  }
}
```

উপরের কোডটি এই প্যারামিটারগুলোর জন্য মান নির্ধারণ করে:

heading : উত্তর দিক থেকে ক্যামেরাটি যেদিকে তাক করতে হবে, সেই দিক (ডিগ্রিতে)।
tilt : ডিগ্রিতে হেলানোর কোণ, যেখানে ০ হলো সরাসরি মাথার উপরে এবং ৯০ হলো আনুভূমিকভাবে তাকানো।
roll : ক্যামেরার উল্লম্ব তল বরাবর ঘূর্ণনের কোণ, ডিগ্রিতে।
range : অক্ষাংশ, দ্রাঘিমাংশ অবস্থান থেকে ক্যামেরার দূরত্ব (মিটারে)।
altitude : সমুদ্রপৃষ্ঠ থেকে ক্যামেরার উচ্চতা।

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

ক্যামেরা ভিউতে আরও বেশি 3D ডেটা দেখানোর জন্য, প্রাথমিক প্যারামিটারগুলো এমনভাবে সেট করুন যাতে একটি নিকটবর্তী ও হেলানো ভিউ দেখা যায়।

পর্ব ৬: আপনার অ্যাপটি প্রিভিউ করুন এবং চালান

Basic 3D map of New York City

একটি Xcode প্রিভিউ যোগ করুন
প্রিভিউ হলো XCode-এর একটি শক্তিশালী ফিচার, যা আপনাকে সিমুলেটর বা কোনো বাহ্যিক ডিভাইস ব্যবহার না করেই আপনার অ্যাপটি দেখতে ও সেটির সাথে ইন্টারঅ্যাক্ট করতে দেয়।
প্রিভিউ যোগ করতে, আপনার struct-এর বাইরে একটি #Preview {} কোড ব্লক যোগ করুন।
```
#Preview {
  CameraDemo()
}
```
অ্যাপটি চালান

অ্যাপটি তৈরি করুন এবং চালান।

অভিনন্দন!

আপনি সফলভাবে অ্যাপে একটি 3D মানচিত্র যুক্ত করেছেন!

এরপরে, আপনি iOS-এর জন্য Maps 3D SDK-এর আরও উন্নত বৈশিষ্ট্যগুলি অন্বেষণ করতে পারেন, যেমন ক্যামেরা পাথ অ্যানিমেশন , 3D মার্কার বা পলিগন ।