דף זה תורגם על ידי Cloud Translation API.

הגדרת פרויקט במסוף Google Cloud

כדי להגדיר פרויקט במסוף Google Cloud ולהגדיר אותו לשימוש ב-Driver SDK ל-Android, פועלים לפי השלבים הבאים.

מגדירים פרויקט באפליקציה לנייד.
מוסיפים את Driver SDK לאפליקציה.
מוסיפים את מפתח ה-API לאפליקציה.
כוללים את השיוך הנדרש באפליקציה.

פרטים נוספים על כל שלב מופיעים בסעיפים הבאים.

הגדרת הפרויקט של האפליקציה לנייד

בקטע הזה מוסבר איך להגדיר את הפרויקט של האפליקציה לנייד ל-Driver SDK.

כדי להגדיר את הפרויקט של האפליקציה לנייד:

אם אין לכם פרויקט פיתוח במסוף Google Cloud ומפתח API לפרויקט הניידות שלכם, צריך להגדיר אותו. מידע נוסף זמין במאמר הבא: יוצרים פרויקט ב-Fleet Engine.
במסוף Google Cloud, בוחרים את אותו פרויקט במסוף Google Cloud ואת אותו מפתח API שבהם אתם משתמשים ב-Fleet Engine.
בוחרים באפשרות APIs & (ממשקי API &) שירותים ומחפשים ומפעילים SDK של מפות ל-Android.

הוספת ה-Driver SDK לאפליקציה

ה-Driver SDK זמין ממאגר Google Maven. המאגר כולל את קובצי ה-Project Object Model (‎.pom) ואת קובצי ה-Javadoc של ה-SDK.

כדי להוסיף את 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>

הוספה של מפתח ה-API לאפליקציה

אחרי שמוסיפים את Driver SDK לאפליקציה, מוסיפים את מפתח ה-API. חובה להשתמש מפתח ה-API של הפרויקט שקיבלתם כשהגדרתם את פרויקט הפיתוח. עבור פרטים נוספים זמינים במאמר הגדרת פרויקט של אפליקציה לנייד.

בקטע הזה מוסבר איך לאחסן את מפתח ה-API כדי שיהיה מאובטח יותר שהאפליקציה שלך מפנה אליו. למידע נוסף על שיטות מומלצות לשמירה על מפתחות API, כדאי לקרוא את המאמר בפלטפורמה של מפות Google בנושא שיטות מומלצות לאבטחת API.

כדי לייעל את המשימה הזו, אפשר להיעזר במסמכי העזרה של GitHub בנושא פלאגין של Secrets Gradle ל-Android.

כדי להתקין את הפלאגין ולאחסן את מפתח ה-API, פועלים לפי השלבים הבאים:

פותחים את קובץ 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")
    }
}

עליך לפתוח את הקובץ build.gradle ברמת האפליקציה ולהוסיף את הקוד הבא אל רכיב plugins.
Groovy
```
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
```
Kotlin
```
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
```
אם אתם משתמשים ב-Android Studio, צריך לסנכרן את הפרויקט עם Gradle. פרטים נוספים זמינים במאמר מסנכרנים את הפרויקט עם Gradle.
פותחים את הקובץ local.properties בספרייה ברמת הפרויקט ומוסיפים את הקוד הבא. מחליפים את הערך YOUR_API_KEY במפתח ה-API שלכם.

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 שאוחזר מהארכיון.

עיינו בהכללת הודעות בקוד פתוח כדי להבין איך לכלול הודעות על קוד פתוח.

המאמרים הבאים

להצהיר על יחסי תלות