یک پروژه کنسول Google Cloud را پیکربندی کنید

برای تنظیم و پیکربندی یک پروژه کنسول Google Cloud برای استفاده از Driver SDK برای اندروید، این مراحل را دنبال کنید.

  1. پروژه اپلیکیشن موبایل خود را تنظیم کنید .
  2. درایور SDK را به برنامه خود اضافه کنید .
  3. کلید API را به برنامه خود اضافه کنید .
  4. ویژگی‌های مورد نیاز را در برنامه خود لحاظ کنید .

برای جزئیات بیشتر در مورد هر مرحله، به بخش‌های بعدی مراجعه کنید.

پروژه اپلیکیشن موبایل خود را تنظیم کنید

این بخش نحوه پیکربندی پروژه برنامه تلفن همراه شما برای Driver SDK را شرح می‌دهد.

برای پیکربندی پروژه اپلیکیشن موبایل خود، مراحل زیر را دنبال کنید:

  1. اگر پروژه توسعه کنسول گوگل کلود و کلید API برای پروژه تحرک‌پذیری خود ندارید، باید یکی تنظیم کنید. برای اطلاعات بیشتر، به «ایجاد پروژه موتور ناوگان» مراجعه کنید.
  2. در کنسول Google Cloud، همان پروژه کنسول Google Cloud و کلید API که برای Fleet Engine استفاده می‌کنید را انتخاب کنید.
  3. APIها و خدمات (APIs & Services) را انتخاب کنید و SDK نقشه‌ها برای اندروید (Maps SDK for Android) را جستجو و فعال کنید.

درایور SDK را به برنامه خود اضافه کنید

درایور SDK از مخزن Google Maven در دسترس است. این مخزن شامل فایل‌های مدل شیء پروژه (.pom) و Javadocs مربوط به SDK است.

برای افزودن Driver SDK به برنامه خود، وابستگی‌های Driver SDK و Navigation SDK را به پیکربندی Gradle یا Maven خود اضافه کنید.

در مثال زیر، VERSION_NUMBER با نسخه انتخاب شده از Driver SDK جایگزین کنید.

گرادل

موارد زیر را به build.gradle خود اضافه کنید:

dependencies {
...
implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-driver:VERSION_NUMBER'
implementation 'com.google.android.libraries.navigation:navigation:5.0.0'
}

ماون

موارد زیر را به pom.xml خود اضافه کنید:

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation.driver</groupId>
    <artifactId>transportation-driver</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.libraries.navigation</groupId>
    <artifactId>navigation</artifactId>
    <version>5.0.0</version>
  </dependency>
</dependencies>

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

پس از افزودن Driver SDK به برنامه خود، کلید API را اضافه کنید. شما باید از کلید API پروژه که هنگام راه‌اندازی پروژه توسعه خود دریافت کرده‌اید، استفاده کنید. برای جزئیات بیشتر، به «راه‌اندازی پروژه برنامه تلفن همراه خود» مراجعه کنید.

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

برای ساده‌سازی این کار، می‌توانید از مستندات گیت‌هاب با عنوان Secrets Gradle Plugin for Android استفاده کنید.

برای نصب افزونه و ذخیره کلید API خود، این مراحل را دنبال کنید:

  1. فایل build.gradle سطح ریشه خود را باز کنید و کد زیر را به عنصر dependencies در زیر buildscript اضافه کنید.

    گرووی 

    buildscript {
      dependencies {
          // ...
          classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0"
      }
}

    کاتلین 

    buildscript {
    dependencies {
        // ...
        classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0")
    }
}

  2. فایل build.gradle سطح برنامه خود را باز کنید و کد زیر را به عنصر plugins اضافه کنید.

    گرووی 

    id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'

    کاتلین 

    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")

  3. اگر از اندروید استودیو استفاده می‌کنید، پروژه خود را با Gradle همگام‌سازی کنید. برای جزئیات بیشتر، به بخش همگام‌سازی پروژه با Gradle مراجعه کنید.

  4. local.properties را در دایرکتوری سطح پروژه خود باز کنید و سپس کد زیر را اضافه کنید. به جای YOUR_API_KEY ، کلید API خود را قرار دهید.

    کلید API نقشه = YOUR_API_KEY

  5. در فایل AndroidManifest.xml خود، به مسیر com.google.android.geo.API_KEY بروید و ویژگی android:value به صورت زیر به‌روزرسانی کنید: 

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

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

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.example.driverapidemo" >
        <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
        <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
        <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:supportsRtl="true"
            android:theme="@style/_AppTheme" >

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

            <activity android:name=".MainActivity" >
                <intent-filter>
                    <action android:name="android.intent.action.MAIN" />
                    <category android:name="android.intent.category.LAUNCHER" />
                </intent-filter>
            </activity>
        </application>
    </manifest>

ویژگی‌های مورد نیاز را در برنامه خود بگنجانید

اگر از Driver SDK در برنامه خود استفاده می‌کنید، باید متن مربوط به انتساب و مجوزهای متن‌باز را به عنوان بخشی از بخش اطلاعیه‌های قانونی برنامه خود درج کنید. بهتر است انتساب‌ها را به عنوان یک آیتم مستقل از منو یا به عنوان بخشی از یک آیتم منوی «درباره» درج کنید.

می‌توانید اطلاعات مجوز را در فایل "third_party_licenses.txt" در فایل AAR بایگانی نشده پیدا کنید.

برای نحوه‌ی درج اعلان‌های متن‌باز، به بخش «افزودن اعلان‌های متن‌باز» مراجعه کنید.

قدم بعدی چیست؟

اعلان وابستگی‌ها