ضبط مشروع في وحدة تحكّم 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 للتطبيقات المتوافقة مع Android وفعِّلها.

إضافة Driver SDK إلى تطبيقك

يتوفّر Driver SDK من مستودع Google Maven. ويتضمّن المستودع ملفات نموذج كائن المشروع (.pom) وJavadocs لحزمة SDK.

لإضافة Driver SDK إلى تطبيقك، أضِف تبعيات Driver SDK وNavigation SDK إلى إعداد Gradle أو Maven.

في المثال التالي، استبدِل VERSION_NUMBER بالإصدار الذي اخترته من Driver SDK.

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

<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 إلى تطبيقك، أضِف مفتاح واجهة برمجة التطبيقات. يجب استخدام مفتاح واجهة برمجة التطبيقات الخاص بالمشروع الذي حصلت عليه عند إعداد مشروع التطوير. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد مشروع تطبيق الأجهزة الجوّالة.

يوضّح هذا القسم كيفية تخزين مفتاح واجهة برمجة التطبيقات ليتمكّن تطبيقك من الرجوع إليه بشكل أكثر أمانًا. لمزيد من المعلومات حول أفضل الممارسات المتعلّقة بأمان مفتاح واجهة برمجة التطبيقات ، يُرجى الاطّلاع على مقالة أفضل الممارسات المتعلّقة بأمان واجهة برمجة التطبيقات في "منصة خرائط Google" .

لتبسيط هذه المهمة، يمكنك استخدام المكوّن الإضافي Secrets Gradle لأجهزة Android في مستندات GitHub Secrets Gradle Plugin for 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 بمفتاح واجهة برمجة التطبيقات.

   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 غير المؤرشف.

يُرجى الرجوع إلى مقالة تضمين إشعارات البرامج المفتوحة المصدر لمعرفة كيفية تضمينها.

الخطوات التالية

تحديد الاعتماديات