راه اندازی

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

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

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

مرحله 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"

مرحله 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 for Android در کنسول Google Cloud مراجعه کنید. برای کسب اطلاعات بیشتر در مورد تکمیل این مراحل، شروع به کار با پلتفرم Google Maps را ببینید.

یک پروژه اندروید استودیو راه اندازی کنید

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

قسمت 1: پروژه و پیکربندی Gradle خود را تنظیم کنید

  1. با استفاده از الگوی Empty Views Activity یک پروژه Android Studio جدید ایجاد کنید.

  2. اگر از Git برای کنترل منبع استفاده می کنید، فایل .gitignore پروژه را تغییر دهید تا از متعهد شدن فایل مخفی به کنترل نسخه جلوگیری کنید:

    • در فهرست اصلی پروژه خود، فایل .gitignore را باز کنید.
    • خط زیر را اضافه کنید: 
    secrets.properties

  3. فایل build.gradle.kts در سطح پروژه را به روز کنید:

    • در فهرست اصلی پروژه خود، فایل build.gradle.kts باز کنید.
    • در بلوک plugins ، افزونه Secrets Gradle را اضافه کنید: 
    plugins {
  alias(libs.plugins.android.application) apply false
  alias(libs.plugins.kotlin.android) apply false
  alias(libs.plugins.secrets.gradle.plugin) apply false // Add this line
}

  4. فایل gradle/libs.versions.toml را به روز کنید: - فایل gradle/libs.versions.toml را که معمولاً در دایرکتوری gradle در دایرکتوری ریشه پروژه قرار دارد، باز کنید. - در قسمت نسخه ها، نسخه های SDK و افزونه Secrets Gradle را اضافه کنید:

    maps3dSdk = "0.0.1" # Update this value to match the SDK version to include
secretsGradlePlugin = "2.0.1"

    -   In the library section, add the SDK library:

    play-services-maps3d = { module = "com.google.android.gms:play-services-maps3d", version.ref = "maps3dSdk" }

    -   In the plugin section, add the Secrets Gradle plugin:

    secrets-gradle-plugin = { id = "com.google.android.libraries.mapsplatform.secrets-gradle-plugin", version.ref = "secretsGradlePlugin" }

  5. فایل app/build.gradle.kts سطح ماژول را به روز کنید: - فایل build.gradle.kts سطح ماژول را که معمولاً در فهرست app قرار دارد، باز کنید. - در بالای فایل، افزونه Secrets Gradle را به بلوک plugins اضافه کنید: 

    plugins {
  alias(libs.plugins.android.application)
  alias(libs.plugins.kotlin.android)
  alias(libs.plugins.secrets.gradle.plugin) // Add this line
}

    -   In the `dependencies` block, add the SDK:

    dependencies {
  // ... other dependencies
  implementation(libs.play.services.maps3d) // Add this line
}

    -   At the end of the file, outside of the `android` and `dependencies`
    blocks, add the secrets configuration:

    secrets {
  // Optionally specify a different filename containing your secrets.
  // The plugin defaults to "local.properties"
  propertiesFileName = "secrets.properties"

  // A properties file containing default secret values. This file can be
  // checked in version control.
  defaultPropertiesFileName = "local.defaults.properties"
}

بخش 2: کلید API خود را به پروژه خود اضافه کنید

  1. یک فایل secrets.properties ایجاد کنید:

    • در دایرکتوری ریشه ماژول برنامه (معمولاً دایرکتوری app )، یک فایل جدید به نام secrets.properties ایجاد کنید.
    • کلید API خود را به فایل اضافه کنید: 
    MAPS3D_API_KEY=YOUR_API_KEY_HERE
``` Note: Make sure you
    replace `YOUR_API_KEY_HERE` with the API key that you configured for use
with the Maps 3D SDK for Android.

  2. یک فایل local.defaults.properties ایجاد کنید: - در فهرست اصلی ماژول برنامه، یک فایل جدید به نام secrets.properties ایجاد کنید. - یک کلید API پیش فرض یا مکان نگهدار به فایل اضافه کنید. این فایل را می توان در کنترل نسخه بررسی کرد: 

    MAPS3D_API_KEY=DEFAULT_API_KEY_OR_PLACEHOLDER

قسمت 3: فایل AndroidManifest.xml خود را به روز کنید

  1. فایل app/src/main/AndroidManifest.xml را باز کنید.

  2. در داخل تگ <application> ، قبل از تگ <activity> ، عنصر <meta-data> زیر را اضافه کنید تا کلید API خود را اعلام کنید: 

    <application
  ...>

  <meta-data
      android:name="com.google.android.geo.maps3d.API_KEY"
      android:value="${MAPS3D_API_KEY}" />

  <activity
      ...>
  </activity>
</application>

    در طی فرآیند ساخت، افزونه Secrets Gradle جای جای‌بان ${MAPS3D_API_KEY} با کلید فایل secrets.properties شما جایگزین می‌کند.

مراحل بعدی

اکنون که یک پروژه Google Cloud، کلید API و یک پروژه Android Studio برای استفاده با Maps 3D SDK for Android راه اندازی شده است، می توانید یک نقشه سه بعدی به برنامه خود اضافه کنید .