راه اندازی

این صفحه آنچه را که برای شروع ساخت با Maps 3D SDK برای iOS باید انجام دهید، شرح می‌دهد. فرآیند راه‌اندازی شامل پیکربندی یک پروژه Google Cloud و API برای استفاده با SDK و سپس راه‌اندازی یک پروژه Xcode است. قبل از افزودن اولین نقشه سه‌بعدی به برنامه خود ، این مراحل را انجام دهید.

یک پروژه Google Cloud و کلید API راه‌اندازی کنید

قبل از اینکه بتوانید با Maps 3D SDK برای iOS شروع به ساخت برنامه کنید، باید با انجام مراحل زیر، یک پروژه Google Cloud و کلید API برای استفاده با Maps 3D SDK برای iOS تنظیم کنید:

مرحله ۱

کنسول

  1. در کنسول گوگل کلود، در صفحه انتخاب پروژه، روی ایجاد پروژه کلیک کنید تا ایجاد یک پروژه ابری جدید آغاز شود.

    به صفحه انتخاب پروژه بروید

  2. مطمئن شوید که صورتحساب برای پروژه ابری شما فعال است. تأیید کنید که صورتحساب برای پروژه شما فعال است .

    گوگل کلود یک دوره آزمایشی با هزینه ۰.۰۰ دلار ارائه می‌دهد. این دوره آزمایشی در هر ۹۰ روز یا پس از اینکه حساب کاربری ۳۰۰ دلار هزینه دریافت کرده باشد، هر کدام که زودتر اتفاق بیفتد، منقضی می‌شود. هر زمان که خواستید می‌توانید آن را لغو کنید. برای اطلاعات بیشتر، به بخش «اعتبار حساب صورتحساب» و «صورتحساب» مراجعه کنید.

SDK ابری 

gcloud projects create "PROJECT"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

مرحله ۲

برای استفاده از پلتفرم نقشه‌های گوگل، باید APIها یا SDKهایی را که قصد دارید در پروژه خود استفاده کنید، فعال کنید.

توجه داشته باشید که برخی از یکپارچه‌سازی‌ها مستلزم فعال کردن چندین API/SDK هستند. اگر مطمئن نیستید کدام APIها یا SDKها را فعال کنید، از Capabilities Explorer استفاده کنید یا به مستندات مربوط به API/SDK مورد نظر خود مراجعه کنید.

برای فعال کردن یک یا چند API یا SDK:

کنسول

  1. با رفتن به صفحه کتابخانه API نقشه‌ها در کنسول ابری، APIها و SDKهای پلتفرم نقشه‌های گوگل را که می‌توانید فعال کنید، مشاهده کنید:

    به صفحه کتابخانه API نقشه‌ها بروید

  2. روی API یا SDK که می‌خواهید فعال کنید کلیک کنید.
    • اگر روی دکمه عبارت ENABLE نوشته شده بود، برای فعال کردن API یا SDK روی آن کلیک کنید.
    • اگر روی دکمه نوشته شده باشد «مدیریت» ، یعنی API یا SDK از قبل فعال شده است و نیازی به انجام کار بیشتری نیست.
    • با کلیک بر روی هر یک از دکمه‌ها، داشبورد مربوط به API یا SDK نمایش داده می‌شود. (برای حذف API یا SDK از این پروژه، روی دکمه غیرفعال کردن (DISABLE) کلیک کنید.)

SDK ابری

دستور زیر تمام 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"

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

برای فعال کردن 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. به صفحه Google Maps Platform > Credentials بروید.

    به صفحه اعتبارنامه‌ها بروید

  2. در صفحه اعتبارنامه‌ها ، روی ایجاد اعتبارنامه > کلید API کلیک کنید.
    کادر محاوره‌ای ایجاد کلید API، کلید API تازه ایجاد شده شما را نمایش می‌دهد.
  3. روی بستن کلیک کنید.
    کلید API جدید در صفحه اعتبارنامه‌ها ، زیر عنوان کلیدهای API، فهرست شده است.
    (به یاد داشته باشید که قبل از استفاده از کلید API در محیط عملیاتی، آن را محدود کنید .)

SDK ابری 

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

درباره Google Cloud SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

برای فعال کردن SDK، به صفحه Maps 3D SDK برای iOS در کنسول Google Cloud مراجعه کنید. برای اطلاعات بیشتر در مورد انجام این مراحل، به شروع به کار با پلتفرم Google Maps مراجعه کنید.

راه‌اندازی یک پروژه Xcode

این بخش نحوه ایجاد و پیکربندی یک پروژه Xcode برای استفاده با Maps 3D SDK برای iOS را توضیح می‌دهد.

پس از فعال کردن پرداخت و ایجاد کلید API، آماده‌اید تا پروژه Xcode مورد استفاده برای توسعه برنامه خود را راه‌اندازی کنید.

مرحله ۱: نصب نرم‌افزارهای مورد نیاز

برای ساخت یک پروژه با استفاده از Maps 3D SDK برای iOS، باید موارد زیر را دانلود و نصب کنید:

  • نسخه Xcode 16.0 یا بالاتر

مرحله ۲: پروژه Xcode را ایجاد کنید و Maps 3D SDK را برای iOS نصب کنید

مدیر بسته سوئیفت

کیت توسعه نرم‌افزار Maps 3D برای iOS را می‌توان با استفاده از Swift Package Manager نصب کرد.

برای اضافه کردن SDK به یک پروژه جدید یا موجود، مراحل زیر را دنبال کنید:

  • project یا workspace Xcode خود را باز کنید، سپس به File > Add Package Dependencies بروید.
  • آدرس https://github.com/googlemaps/ios-maps-3d-sdk را به عنوان URL وارد کنید، برای دریافت بسته، Enter را فشار دهید و روی «افزودن بسته» کلیک کنید.
  • از پنجره Choose Package Products ، تأیید کنید که GoogleMaps3D به هدف اصلی تعیین‌شده شما اضافه خواهد شد. پس از تکمیل، روی Add Package کلیک کنید.
  • برای تأیید نصب، به بخش عمومی (General ) سیستم هدف خود بروید. در قسمت‌های چارچوب‌ها (Frameworks)، کتابخانه‌ها (Libraries) و محتوای جاسازی‌شده (Embedded Content )، باید بسته‌های نصب‌شده را مشاهده کنید. همچنین می‌توانید بخش وابستگی‌های بسته (Package Dependencies) در Project Navigator را مشاهده کنید تا بسته و نسخه آن را تأیید کنید.

مرحله ۳: کلید API را به برنامه خود اضافه کنید

مدیر بسته سوئیفت

کلید API خود را به نقطه ورود اصلی برنامه خود (یا هر زمان قبل از بارگذاری نقشه) به شرح زیر اضافه کنید.

  1. عبارت import زیر را اضافه کنید: 
    import GoogleMaps3D
  2. متد زیر را اضافه کنید. به جای YOUR_API_KEY ، کلید API خود را قرار دهید. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

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

مرحله ۴ (اختیاری): بررسی فایل مانیفست حریم خصوصی اپل

اپل برای برنامه‌های موجود در اپ استور، جزئیات حریم خصوصی برنامه را الزامی می‌داند.

فایل «بیانیه حریم خصوصی اپل» در بسته منابع SDK گنجانده شده است. برای تأیید اینکه فایل «بیانیه حریم خصوصی» گنجانده شده است و برای بررسی محتوای آن، یک بایگانی از برنامه خود ایجاد کنید و یک گزارش حریم خصوصی از بایگانی تهیه کنید .

مراحل بعدی

اکنون که یک پروژه Google Cloud، کلید API و پروژه Xcode برای استفاده با Maps 3D SDK برای iOS تنظیم کرده‌اید، می‌توانید یک نقشه سه‌بعدی به برنامه خود اضافه کنید .