راه اندازی

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

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

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

مرحله 1

کنسول

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

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

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

    Google Cloud یک شارژ آزمایشی 0.00 دلاری ارائه می دهد. دوره آزمایشی در پایان 90 روز یا پس از جمع‌آوری هزینه‌های 300 دلاری حساب، هر کدام که زودتر اتفاق بیفتد، منقضی می‌شود. هر زمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.

Cloud SDK 

gcloud projects create "PROJECT"

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

مرحله 2

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

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

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

کنسول

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

    به صفحه Maps API Library بروید

  2. روی API یا SDK مورد نظر برای فعال کردن کلیک کنید.
    • اگر روی دکمه ENABLE نوشته شده است، روی دکمه برای فعال کردن API یا SDK کلیک کنید.
    • اگر روی دکمه MANAGE نوشته شده باشد، API یا SDK قبلاً فعال شده است و نیازی به انجام کار دیگری ندارید.
    • با کلیک بر روی هر یک از دکمه ها، داشبورد API یا SDK نمایش داده می شود. (برای حذف API یا SDK از این پروژه، دکمه DISABLE را کلیک کنید.)

Cloud SDK

دستور زیر همه API های 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 SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

از این دستور برای فعال کردن Environment API ها استفاده کنید:

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

مرحله 3

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

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

برای ایجاد یک کلید API:

کنسول

  1. به صفحه پلتفرم نقشه های گوگل > اعتبارنامه بروید.

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

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

Cloud 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 هستید که برای توسعه برنامه خود استفاده می کنید.

مرحله 1: نرم افزار مورد نیاز را نصب کنید

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

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

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

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

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

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

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

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

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

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

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

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

مرحله 4 (اختیاری): فایل Apple Privacy Manifest را بررسی کنید

اپل به جزئیات حریم خصوصی برنامه برای برنامه های موجود در فروشگاه App نیاز دارد.

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

مراحل بعدی

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

،

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

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

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

مرحله 1

کنسول

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

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

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

    Google Cloud یک شارژ آزمایشی 0.00 دلاری ارائه می دهد. دوره آزمایشی در پایان 90 روز یا پس از جمع‌آوری هزینه‌های 300 دلاری حساب، هر کدام که زودتر اتفاق بیفتد، منقضی می‌شود. هر زمان خواستید لغو کنید. برای اطلاعات بیشتر، اعتبارات حساب صورت‌حساب و صورت‌حساب را ببینید.

Cloud SDK 

gcloud projects create "PROJECT"

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

مرحله 2

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

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

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

کنسول

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

    به صفحه Maps API Library بروید

  2. روی API یا SDK مورد نظر برای فعال کردن کلیک کنید.
    • اگر روی دکمه ENABLE نوشته شده است، روی دکمه برای فعال کردن API یا SDK کلیک کنید.
    • اگر روی دکمه MANAGE نوشته شده باشد، API یا SDK قبلاً فعال شده است و نیازی به انجام کار دیگری ندارید.
    • با کلیک بر روی هر یک از دکمه ها، داشبورد API یا SDK نمایش داده می شود. (برای حذف API یا SDK از این پروژه، دکمه DISABLE را کلیک کنید.)

Cloud SDK

دستور زیر همه API های 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 SDK ، نصب Cloud SDK و دستورات زیر بیشتر بخوانید:

از این دستور برای فعال کردن Environment API ها استفاده کنید:

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

مرحله 3

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

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

برای ایجاد یک کلید API:

کنسول

  1. به صفحه پلتفرم نقشه های گوگل > اعتبارنامه بروید.

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

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

Cloud 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 هستید که برای توسعه برنامه خود استفاده می کنید.

مرحله 1: نرم افزار مورد نیاز را نصب کنید

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

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

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

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

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

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

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

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

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

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

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

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

مرحله 4 (اختیاری): فایل Apple Privacy Manifest را بررسی کنید

اپل به جزئیات حریم خصوصی برنامه برای برنامه های موجود در فروشگاه App نیاز دارد.

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

مراحل بعدی

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