تنظیم

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

پیش‌نیازها

برای استفاده از کیت توسعه نرم‌افزار ۳ بعدی Maps برای iOS، پروژه و دستگاه‌های هدف شما باید شرایط زیر را داشته باشند:

  • حداقل نسخه iOS: iOS هدف ۱۶.۰ یا بالاتر.
  • Xcode: Xcode نسخه ۱۶.۰ یا بالاتر.

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

قبل‌از اینکه بتوانید با «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS» شروع به ساختن کنید، باید پروژه Google Cloud و کلید میانای برنامه‌سازی کاربردی را برای استفاده با «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای iOS» با تکمیل مراحل زیر راه‌اندازی کنید:

مرحله ۱: راه‌اندازی پروژه

کنسول

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

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

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

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

کیت توسعه نرم‌افزار Cloud

gcloud projects create "PROJECT"

درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

مرحله ۲: فعال کردن میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزار

برای استفاده از Google Maps Platform، باید میاناهای برنامه‌سازی کاربردی یا کیت‌های توسعه نرم‌افزاری را که قصد دارید با پروژه‌تان استفاده کنید فعال کنید.

توجه داشته باشید که برخی‌از ادغام‌ها مستلزم آن است که چندین میانای برنامه‌سازی کاربردی/ کیت توسعه نرم‌افزار را فعال کنید. اگر مطمئن نیستید کدام میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار را فعال کنید، از کاوشگر قابلیت‌ها استفاده کنید یا اسناد مربوط به میانای برنامه‌سازی کاربردی/کیت توسعه نرم‌افزار موردنظرتان را بررسی کنید.

برای فعال کردن یک یا چند میانای برنامه‌سازی کاربردی یا کیت توسعه نرم‌افزار:

کنسول

  1. با رفتن به صفحه «کتابخانه Maps API» در کنسول Cloud، میاناهای برنامه‌سازی کاربردی و کیت‌های توسعه نرم‌افزار Google Maps Platform را که می‌توانید فعال کنید ببینید:

    به صفحه کتابخانه Maps API بروید

  2. روی API یا SDK که می‌خواهید فعال شود کلیک کنید.
    • اگر روی دکمه فعال کردن نوشته شده است، روی دکمه کلیک کنید تا 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 APIs استفاده کنید:

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

مرحله ۳: دریافت کلید میانای برنامه‌سازی کاربردی

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

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

کنسول

  1. به صفحه پلاتفرم Google Maps > کلیدها و اطلاعات کاربری بروید.

    به صفحه «کلیدها و اعتبارنامه‌ها» بروید

  2. اگر درخواست شد، پروژه‌تان را انتخاب کنید.

  3. یکی از موارد زیر را انجام دهید:

    • ایجاد کلید جدید:

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

    • استفاده از کلید موجود:

      1. روی نام کلید کلیک کنید.
      2. در فهرست انتخاب محدودیت‌های API، APIهایی را که قصد دارید استفاده کنید انتخاب کنید.
      3. روی ذخیره کلیک کنید.

    انتخاب کردن میانای برنامه‌سازی کاربردی در اینجا آن را فعال نمی‌کند. مطمئن شوید هر میانای برنامه‌سازی کاربردی که انتخاب می‌کنید در کتابخانه میانای برنامه‌سازی کاربردی فعال باشد.

  4. برای دیدن رشته کلید در آینده، به صفحه کلیدها و اطلاعات کاربری بروید و روی نمایش کلید برای کلید کلیک کنید.

اگر کنسول با این مراحل متفاوت است، ایجاد کلید میانای برنامه‌سازی کاربردی و افزودن محدودیت‌های کلید میانای برنامه‌سازی کاربردی را در اسناد Google Cloud ببینید.

کیت توسعه نرم‌افزار Cloud

در فرمان‌های زیر، PROJECT_ID را با شناسه پروژه‌تان جایگزین کنید.

  • ایجاد کلید جدید: فرمان زیر را اجرا کنید و DISPLAY_NAME را با نامی برای کلید جایگزین کنید. SERVICE_NAME را با نام سرویس میانای برنامه‌سازی کاربردی که قصد دارید استفاده کنید، مثلاً places.googleapis.com، جایگزین کنید. برای مجاز کردن میاناهای برنامه‌سازی کاربردی بیشتر، پرچم --api-target را تکرار کنید.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

  • استفاده از کلید موجود: فرمان زیر را اجرا کنید و KEY_ID را با شناسه کلید جایگزین کنید. SERVICE_NAME را با نام سرویس API که می‌خواهید اضافه کنید جایگزین کنید. پرچم --append میاناهای برنامه‌سازی کاربردی را که کلید ازقبل مجاز کرده است حفظ می‌کند. بدون آن، فرمان جایگزین آن‌ها می‌شود.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    درباره کیت توسعه نرم‌افزار Google Cloud، نصب کیت توسعه نرم‌افزار Cloud، و فرمان‌های زیر بیشتر بخوانید:

    شناسه کلید، رشته کلید یا نام نمایشی نیست. برای پیدا کردن آن، gcloud services api-keys list --project="PROJECT_ID" را اجرا کنید. شناسه بخش آخر فیلد name است: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

برای دیدن رشته کلید، gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID" را اجرا کنید.

برای فعال کردن کیت توسعه نرم‌افزار، به صفحه کیت توسعه نرم‌افزار ۳ بعدی نقشه برای 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

کلید میانای برنامه‌سازی کاربردی‌تان را به‌صورت زیر به نقطه ورودی اصلی برنامه‌تان (یا هر زمانی قبل‌از بار شدن نقشه) اضافه کنید.

  1. عبارت وارد کردن زیر را اضافه کنید: 
    import GoogleMaps3D
  2. روش زیر را اضافه کنید. 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» راه‌اندازی کرده‌اید، می‌توانید نقشه سه‌بعدی به برنامه‌تان اضافه کنید.