این صفحه توضیح می‌دهد که برای راه‌اندازی و شروع ساخت با کیت توسعه نرم‌افزار ۳ بعدی Maps برای iOS چه کاری باید انجام دهید. فرایند راه‌اندازی شامل پیکربندی کردن پروژه Google Cloud و API برای استفاده با کیت توسعه نرم‌افزار و سپس راه‌اندازی کردن پروژه Xcode است. این مراحل را قبل‌از افزودن اولین نقشه سه‌بعدی به برنامه‌تان تکمیل کنید.
پیش‌نیازها
برای استفاده از «کیت توسعه نرم‌افزار ۳ بعدی نقشه» برای iOS، پروژه و دستگاه‌های هدف شما باید شرایط زیر را داشته باشند:
- حداقل نسخه iOS: iOS هدف ۱۶.۰ یا بالاتر.
- Xcode: Xcode نسخه ۱۶.۰ یا بالاتر.
راه‌اندازی پروژه Google Cloud و کلید API
قبل‌از اینکه بتوانید با «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS» شروع به ساختن کنید، باید پروژه Google Cloud و کلید میانای برنامه‌سازی کاربردی را برای استفاده با «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS» با تکمیل مراحل زیر راه‌اندازی کنید:
مرحله ۱
کنسول
-
در کنسول Google Cloud، در صفحه انتخابگر پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد پروژه Cloud جدیدی را شروع کنید.
-
مطمئن شوید که صورت‌حساب برای پروژه Cloud شما فعال باشد. مطمئن شوید که صدور صورت‌حساب برای پروژه‌تان فعال باشد.
Google Cloud دوره آزمایشی با هزینه ۰٫۰۰ دلار ارائه می‌دهد. دوره آزمایشی پس‌از ۹۰ روز یا پس‌از اینکه حساب ۳۰۰ دلار هزینه جمع کرد، هرکدام زودتر باشد، منقضی می‌شود. هرزمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.
کیت توسعه نرم‌افزار Cloud
gcloud projects create "PROJECT"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:
مرحله ۲
برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.
توجه داشته باشید که برخی‌از ادغام‌ها مستلزم این است که چندین میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار را فعال کنید. اگر مطمئن نیستید کدام میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار را فعال کنید، از کاوشگر قابلیت‌ها استفاده کنید یا با اسناد مربوط به میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزاری که می‌خواهید استفاده کنید مشورت کنید.
برای فعال کردن یک یا چند میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار:
کنسول
-
با رفتن به صفحه «کتابخانه Maps API» در کنسول Cloud، میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار Google Maps Platform را که می‌توانید فعال کنید ببینید:
به صفحه کتابخانه Maps API بروید
- روی API یا کیت توسعه نرم‌افزاری که می‌خواهید فعال شود کلیک کنید.
- اگر روی دکمه فعال کردن نوشته شده است، روی دکمه کلیک کنید تا API یا SDK فعال شود.
- اگر روی دکمه نوشته شده است مدیریت، میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار ازقبل فعال شده است و لازم نیست کار دیگری انجام دهید.
- با کلیک کردن روی هریک از دکمه‌ها، داشبورد میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار نمایش داده می‌شود. (برای برداشتن API یا SDK از این پروژه، روی دکمه غیرفعال کردن کلیک کنید.)
کیت توسعه نرم‌افزار Cloud
فرمان زیر همه میاناهای برنامه‌سازی کاربردی Maps، Routes، و Places را فعال می‌کند:
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 ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:
از این فرمان برای فعال کردن Environment API استفاده کنید:
gcloud services enable \ --project "PROJECT" \ "airquality.googleapis.com" \ "solar.googleapis.com" \ "pollen.googleapis.com" \ "weather.googleapis.com"
مرحله ۳
این مرحله فقط فرایند ایجاد کلید میانای API را طی می‌کند. اگر از کلید میانای API خود در تولید استفاده می‌کنید، اکیداً توصیه می‌کنیم کلید میانای API خود را محدود کنید. می‌توانید اطلاعات بیشتری در صفحه استفاده از کلیدهای میانای API مختص محصول پیدا کنید.
کلید میانای برنامه‌سازی کاربردی شناسه یکتایی است که درخواست‌های مرتبط با پروژه شما را برای اهداف استفاده و صدور صورت‌حساب اصالت‌سنجی می‌کند. باید حداقل یک کلید میانای برنامه‌سازی کاربردی مرتبط با پروژه‌تان داشته باشید.
برای ایجاد کلید میانای API:
کنسول
-
به صفحه پلاتفرم Google Maps > اطلاعات کاربری بروید.
-
در صفحه اعتبارنامه‌ها، روی ایجاد اعتبارنامه > کلید میانای برنامه‌سازی کاربردی کلیک کنید.
کادر گفتگوی کلید میانای API ایجاد شد کلید میانای API جدیداً ایجادشده را نمایش می‌دهد. -
روی بستن کلیک کنید.
کلید میانای API جدید در صفحه اطلاعات کاربری در بخش کلیدهای میانای API فهرست شده است.
(به‌خاطر داشته باشید که قبل‌از استفاده از کلید میانای API در تولید، آن را محدود کنید.)
کیت توسعه نرم‌افزار Cloud
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
درباره کیت توسعه نرم‌افزار Google Cloud ، نصب کیت توسعه نرم‌افزار Cloud ، و فرمان‌های زیر بیشتر بخوانید:
برای فعال کردن کیت توسعه نرم‌افزار، به صفحه کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS در کنسول Google Cloud مراجعه کنید. برای اطلاعات بیشتر درباره تکمیل این مراحل، به شروع به کار با Google Maps Platform مراجعه کنید.
راه‌اندازی پروژه Xcode
این بخش توضیح می‌دهد که چگونه یک پروژه Xcode را برای استفاده با کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS ایجاد و پیکربندی کنید.
پس‌از فعال کردن صورت‌حساب و ایجاد کلید میانای برنامه‌سازی کاربردی، آماده‌اید تا پروژه Xcode را که برای توسعه برنامه‌تان استفاده می‌کنید راه‌اندازی کنید.
مرحله ۱: نصب نرم‌افزار موردنیاز
برای ساختن پروژه بااستفاده از «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS»، باید موارد زیر را بارگیری و نصب کنید:
- Xcode نسخه ۱۶.۰ یا بالاتر
مرحله ۲: ایجاد پروژه Xcode و نصب «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS»
Swift Package Manager
کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS را می‌توان بااستفاده از Swift Package Manager نصب کرد.
برای افزودن SDK به پروژه جدید یا موجود، این مراحل را دنبال کنید:
- Xcode
projectیاworkspaceرا باز کنید، سپس به فایل > افزودن وابستگی‌های بسته بروید. - https://github.com/googlemaps/ios-maps-3d-sdk را به‌عنوان نشانی وب وارد کنید، کلید Enter را فشار دهید تا بسته را وارد کنید، و روی «افزودن بسته» کلیک کنید.
- در پنجره انتخاب محصولات بسته، درستی‌سنجی کنید که
GoogleMaps3Dبه هدف اصلی تعیین‌شده شما اضافه خواهد شد. پس‌از تکمیل، روی افزودن بسته کلیک کنید. - برای درستی‌سنجی نصب، به صفحه General (عمومی) هدف بروید. در Frameworks, Libraries, and Embedded Content، باید بسته‌های نصب‌شده را ببینید. همچنین می‌توانید بخش وابستگی‌های بسته در Project Navigator را مشاهده کنید تا بسته و نسخه آن را درستی‌سنجی کنید.
مرحله ۳: کلید میانای API را به برنامه‌تان اضافه کنید
Swift Package Manager
کلید میانای برنامه‌سازی کاربردی‌تان را به‌صورت زیر به نقطه ورودی اصلی برنامه‌تان (یا هر زمانی قبل‌از بار شدن نقشه) اضافه کنید.
- عبارت وارد کردن زیر را اضافه کنید:
import GoogleMaps3D
- روش زیر را اضافه کنید.
YOUR_API_KEYرا با کلید میانای API خودتان جایگزین کنید.struct ContentView: View { init () { Map.apiKey = "YOUR_API_KEY" } var body: some View { Map(mode: .hybrid) } }
مرحله ۴ (اختیاری): بررسی فایل «مانیفست حریم خصوصی Apple»
Apple جزئیات حریم خصوصی برنامه را برای برنامه‌های موجود در App Store الزامی کرده است.
فایل «مانیفست حریم خصوصی Apple» در دسته منابع کیت توسعه نرم‌افزار گنجانده شده است. برای تأیید اینکه «فایل مانیفست حریم خصوصی» اضافه شده است و برای بررسی محتوای آن، بایگانی‌ای از برنامه‌تان ایجاد کنید و از بایگانی گزارش حریم خصوصی تولید کنید.
مراحل بعدی
اکنون که پروژه Google Cloud، کلید API، و پروژه Xcode را برای استفاده با «کیت توسعه نرم‌افزار سه‌بعدی Maps برای iOS» راه‌اندازی کرده‌اید، می‌توانید نقشه سه‌بعدی به برنامه‌تان اضافه کنید.