این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

پروژه توسعه خود را تنظیم کنید .
Consumer SDK را به برنامه خود اضافه کنید .
کلید API را به برنامه خود اضافه کنید .
اسناد مورد نیاز را در برنامه خود قرار دهید .

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

پروژه توسعه خود را تنظیم کنید

اگر پروژه توسعه Google Cloud Console و کلید API برای پروژه تحرک خود ندارید، باید یکی را تنظیم کنید. برای جزئیات، به ایجاد پروژه خود در راهنمای Fleet Engine مراجعه کنید.

وقتی پروژه توسعه خود را برای Consumer SDK انتخاب می‌کنید، همان پروژه Google Cloud Console و کلید API را انتخاب کنید که برای Fleet Engine استفاده می‌کنید.

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

Consumer SDK از مخزن Google Maven در دسترس است. این مخزن شامل فایل‌های Project Object Model (.pom) SDK و Javadocs است. برای افزودن Consumer SDK به برنامه خود، وابستگی های Consumer SDK و Maps SDK را به پیکربندی Gradle یا Maven خود اضافه کنید.

در مثال‌های زیر، VERSION_NUMBER با نسخه مورد نیاز Consumer SDK جایگزین کنید:

گریدل

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

dependencies {
  ...
  implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER'
  implementation "com.google.android.gms:play-services-maps:18.1.0"
}

ماون

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

<dependencies>
  ...
  <dependency>
    <groupId>com.google.android.libraries.mapsplatform.transportation</groupId>
    <artifactId>transportation-consumer</artifactId>
    <version>VERSION_NUMBER</version>
  </dependency>
  <dependency>
    <groupId>com.google.android.gms</groupId>
    <artifactId>play-services-maps</artifactId>
    <version>18.1.0</version>
  </dependency>
</dependencies>

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

هنگامی که Consumer SDK را به برنامه خود اضافه کردید، کلید API را اضافه کنید. شما باید از کلید API پروژه ای که هنگام راه اندازی پروژه توسعه خود به دست آورده اید استفاده کنید. برای جزئیات بیشتر، به تنظیم پروژه توسعه خود در مرحله 3 این راهنما مراجعه کنید.

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

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

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

فایل 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")
    }
}

فایل build.gradle سطح برنامه خود را باز کنید و کد زیر را به عنصر plugins اضافه کنید.
شیار
```
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
```
کاتلین
```
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
```
اگر از Android Studio استفاده می کنید، پروژه خود را با Gradle همگام کنید. برای جزئیات، به همگام سازی پروژه خود با Gradle در اسناد Android مراجعه کنید.
local.properties را در دایرکتوری سطح پروژه خود باز کنید و سپس کد زیر را اضافه کنید. کلید API خود را جایگزین YOUR_API_KEY کنید.
MAPS_API_KEY= YOUR_API_KEY
در فایل 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.consumerapidemo">
        <uses-permission android:name="android.permission.ACCESS_FINE_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>

اسناد مورد نیاز را در برنامه خود قرار دهید

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

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

در مورد نحوه گنجاندن اعلامیه های منبع باز به https://developers.google.com/android/guides/opensource مراجعه کنید.

بعدش چی

توکن های احراز هویت را دریافت کنید