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

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

  1. پروژه برنامه تلفن همراه خود را تنظیم کنید .
  2. Driver SDK را به برنامه خود اضافه کنید .
  3. کلید API را به برنامه خود اضافه کنید .
  4. اسناد مورد نیاز را در برنامه خود قرار دهید .

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

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

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

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

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

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

Driver SDK از مخزن Google Maven در دسترس است. این مخزن شامل فایل‌های Project Object Model (.pom) SDK و Javadocs است.

برای افزودن 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، مقاله پلتفرم نقشه های Google را در مورد بهترین شیوه های امنیتی API ببینید.

برای ساده‌سازی این کار، می‌توانید از افزونه Secrets Gradle اسناد GitHub برای اندروید استفاده کنید.

برای نصب افزونه و ذخیره کلید 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. اگر از Android Studio استفاده می کنید، پروژه خود را با Gradle همگام کنید. برای جزئیات، به همگام سازی پروژه خود با Gradle مراجعه کنید.

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

    MAPS_API_KEY= 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 بایگانی نشده بیابید.

در مورد نحوه گنجاندن اعلامیه های منبع باز به درج اعلان های منبع باز مراجعه کنید.

بعدش چی

وابستگی ها را اعلام کنید