تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ضبط مشروع على Google Cloud Console

لإعداد مشروع على Google Cloud Console وضبطه لاستخدام حزمة تطوير البرامج (SDK) لبرنامج Driver لنظام التشغيل Android، اتّبِع الخطوات التالية.

إعداد مشروع تطبيق للأجهزة الجوّالة
أضِف حزمة تطوير البرامج (SDK) لبرنامج Driver إلى تطبيقك.
أضِف مفتاح واجهة برمجة التطبيقات إلى تطبيقك.
أدرِج الإحالات المطلوبة في تطبيقك.

لمعرفة مزيد من التفاصيل حول كل خطوة، يُرجى الاطّلاع على الأقسام التالية.

إعداد مشروع تطبيقك للأجهزة الجوّالة

يصف هذا القسم كيفية إعداد مشروع تطبيقك للأجهزة الجوّالة لحزمة تطوير البرامج (SDK) لبرنامج التشغيل.

لإعداد مشروع تطبيق الأجهزة الجوّالة، اتبع الخطوات التالية:

إذا لم يكن لديك مشروع تطوير على Google Cloud Console ومفتاح واجهة برمجة التطبيقات لمشروعك المتعلق بالتنقّل، عليك إعداد مشروع. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء مشروعك على Fleet Engine.
في Google Cloud Console، اختَر مشروع Google Cloud Console و مفتاح واجهة برمجة التطبيقات نفسهما اللذَين تستخدمهما في Fleet Engine.
اختَر واجهات برمجة التطبيقات والخدمات وابحث عن "حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android" وفعِّلها.

إضافة حزمة تطوير البرامج (SDK) لبرنامج Driver إلى تطبيقك

تتوفّر حزمة Driver SDK من مستودع Google Maven. يتضمّن المستودع ملفات Project Object Model (pom.) لحزمة SDK وملفات Javadoc.

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

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

لتبسيط هذه المهمة، يمكنك استخدام مستندات GitHub المكوّن الإضافي Secrets Gradle لأجهزة Android.

لتثبيت المكوّن الإضافي وتخزين مفتاح واجهة برمجة التطبيقات، يمكنك اتباع الخطوات التالية:

افتح ملف build.gradle على مستوى الجذر وأضِف الرمز التالي إلى العنصر dependencies ضمن buildscript.

رائع

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")
    }
}

افتح ملف build.gradle على مستوى التطبيق وأضِف الرمز التالي إلى العنصر plugins.

رائع

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

Kotlin

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

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

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

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

الإفصاح عن التبعيات