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

لإعداد خدمة Google Cloud Console وضبطها من أجل استخدام حزمة تطوير البرامج (SDK) الخاصة بالمستهلكين على Android، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

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

تتوفّر "حزمة تطوير البرامج (SDK) للمستهلكين" من مستودع Maven خاص. المستودع يتضمّن ملفات نموذج كائن المشروع (pom.) لحزمة تطوير البرامج (SDK) وJavadocs. لإضافة حزمة تطوير البرامج (SDK) الخاصة بالمستهلك إلى تطبيقك، يُرجى اتّباع الخطوات التالية:

  1. اضبط بيئتك للوصول إلى مستودع Maven المضيف كما هو موضّح في. الخطوة 2 من هذا الدليل.

  2. أضِف تبعيات حزمة تطوير البرامج (SDK) للمستهلك وحزمة تطوير البرامج (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:VERSION_NUMBER"
}

    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>

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

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

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

لتبسيط هذه المهمة، يمكنك استخدام وثائق GitHub السرية 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 في مستندات 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>

إدراج عمليات تحديد المصدر المطلوبة في تطبيقك

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

يمكنك العثور على معلومات الترخيص في "third_party_Licenses.txt" تسجيل ملف AAR غير المؤرشف.

راجِع https://developers.google.com/android/guides/opensource لمعرفة كيفية تتضمن إشعارات مفتوحة المصدر

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

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