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

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

  1. إعداد مشروع التطوير
  2. أضِف حزمة تطوير البرامج (SDK) لإصدار Consumer إلى تطبيقك.
  3. أضِف مفتاح واجهة برمجة التطبيقات إلى تطبيقك.
  4. تضمين الإحالات المطلوبة في تطبيقك

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

إعداد مشروع التطوير

إذا لم يكن لديك مشروع تطوير على Google Cloud Console ومفتاح واجهة برمجة تطبيقات لمشروعك المتعلّق بالتنقّل، عليك إعداد مشروع. لمعرفة التفاصيل، يُرجى الاطّلاع على إنشاء مشروعك في دليل Fleet Engine.

عند اختيار مشروع التطوير لمجموعة تطوير البرامج Consumer SDK، اختَر مشروع Google Cloud Console ومفتاح واجهة برمجة التطبيقات نفسهما اللذَين تستخدمهما في Fleet Engine.

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

تتوفّر حزمة Consumer SDK من مستودع Google Maven. يتضمّن المستودع ملفات Project Object Model (pom.) لحزمة SDK وملفات Javadoc. لإضافة حزمة Consumer SDK إلى تطبيقك، أضِف حِزم Consumer SDK وMaps SDK التي تعتمد عليها إلى إعدادات Gradle أو Maven.

في الأمثلة التالية، استبدِل VERSION_NUMBER بالإصدار المطلوب من حزمة تطوير البرامج (SDK) للمستهلك:

Gradle

أضِف ما يلي إلى 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"
}

Maven

أضِف ما يلي إلى 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>

إضافة مفتاح واجهة برمجة التطبيقات إلى تطبيقك

بعد إضافة حزمة Consumer SDK إلى تطبيقك، أضِف مفتاح واجهة برمجة التطبيقات. يجب استخدام مفتاح واجهة برمجة التطبيقات للمشروع الذي حصلت عليه عند إعداد مشروع التطوير. للحصول على مزيد من التفاصيل، يُرجى الاطّلاع على إعداد مشروع التطوير في الخطوة 3 من هذا الدليل.

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

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

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

  1. افتح ملف 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")
    }
}

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

    رائع

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

    Kotlin

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

  3. إذا كنت تستخدم "استوديو Android"، يمكنك مزامنة مشروعك مع Gradle. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة مزامنة مشروعك مع Gradle في مستندات Android.

  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.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 للتعرّف على كيفية تضمين إشعارات البرامج المفتوحة المصدر.

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

الحصول على الرموز المميزة للمصادقة