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

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

  1. پروژه برنامه تلفن همراهتان را راه‌اندازی کنید.
  2. Driver SDK را به برنامه‌تان اضافه کنید.
  3. کلید میانای برنامه‌سازی کاربردی را به برنامه‌تان اضافه کنید.
  4. ارجاع‌های لازم را در برنامه‌تان بگنجانید.

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

راه‌اندازی پروژه برنامه تلفن همراه

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

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

  1. اگر پروژه توسعه کنسول Google Cloud و کلید میانای برنامه‌سازی کاربردی برای پروژه جابه‌جایی‌تان ندارید، باید آن را راه‌اندازی کنید. برای اطلاعات بیشتر، به ایجاد پروژه Fleet Engine مراجعه کنید.
  2. در کنسول Google Cloud، همان پروژه کنسول Google Cloud و کلید میانای برنامه‌سازی کاربردی را که برای Fleet Engine استفاده می‌کنید انتخاب کنید.
  3. میاناهای برنامه‌سازی کاربردی و سرویس‌ها را انتخاب کنید و «کیت توسعه نرم‌افزار Google Maps برای Android» را جستجو و فعال کنید.

افزودن Driver SDK به برنامه

«کیت توسعه نرم‌افزار راننده» در مخزن Google Maven دردسترس است. مخزن شامل فایل‌های «مدل شیء پروژه» (‎.pom) کیت توسعه نرم‌افزار و Javadocs است.

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

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

Gradle

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

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

Maven

مورد زیر را به 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>

کلید میانای برنامه‌سازی کاربردی را به برنامه‌تان اضافه کنید

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

این بخش نحوه ذخیره کردن کلید میانای برنامه‌سازی کاربردی (API) را شرح می‌دهد تا برنامه‌تان بتواند به‌طور ایمن‌تری به آن ارجاع دهد. برای اطلاعات بیشتر درباره روال‌های مطلوب امنیتی کلید API، مقاله Google Maps Platform درباره روال‌های مطلوب امنیتی API را ببینید.

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

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

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

    Groovy

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

    Kotlin

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

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

    Groovy

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

    Kotlin

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

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

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

    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 غیربایگانی‌شده پیدا کنید.

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

قدم بعدی چیست

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