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

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

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

এই পণ্য বা বৈশিষ্ট্যটি পরীক্ষামূলক (প্রি-GA)। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

Basic maps of Seattle, San Francisco, and
Paris

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

iOS এর জন্য Maps 3D SDK সহ একটি Google ক্লাউড প্রকল্প সক্ষম
iOS এর জন্য একটি API কী মানচিত্র 3D SDK৷
iOS প্যাকেজের জন্য Maps 3D SDK সহ Xcode সংস্করণ 16.0 বা তার পরে যোগ করা হয়েছে।

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

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

GitHub-এ আরও কোড নমুনা দেখুন ।

পার্ট 1: একটি মৌলিক SwiftUI অ্যাপ তৈরি করুন

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

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

Minimal 3D map of a
globe

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

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

#Preview {
  ContentView()
}
```

পার্ট 3: আপনার API কী সেট করুন।

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

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

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

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

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

একটি initialCamera বৈশিষ্ট্য অন্তর্ভুক্ত করতে Map() ফাংশন কল পরিবর্তন করুন। ডাউনটাউন ম্যানহাটনের একটি দৃশ্য দেখানোর জন্য 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 : ডিগ্রীতে কাত হওয়ার কোণ, যেখানে 0 সরাসরি ওভারহেড এবং 90 অনুভূমিকভাবে দেখা যাচ্ছে।
roll : ক্যামেরার উল্লম্ব সমতলের চারপাশে রোলের কোণ, ডিগ্রিতে।
range : অক্ষাংশ, দ্রাঘিমাংশের অবস্থান থেকে ক্যামেরার মিটারে দূরত্ব
altitude : সমুদ্রপৃষ্ঠ থেকে ক্যামেরার উচ্চতা।

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

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

পার্ট 6: আপনার অ্যাপের পূর্বরূপ দেখুন এবং চালান

Basic 3D map of New York City

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

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

অভিনন্দন!

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

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