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

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

כדי להגדיר ולהגדיר את Google Cloud Console לשימוש ב-SDK לצרכנים ב-Android, פועלים לפי השלבים הבאים.

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

בקטעים הבאים יש מידע נוסף על כל שלב.

הגדרת פרויקט פיתוח

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

כשבוחרים את פרויקט הפיתוח עבור ה-SDK לצרכן, צריך לבחור הפרויקט במסוף Google Cloud ומפתח ה-API שמשמשים אתכם ל-Fleet Engine.

הוספת ה-SDK לצרכנים לאפליקציה

ה-SDK לצרכנים זמין ממאגר פרטי של Maven. המאגר כולל את קובצי Project Object Model (.pom) ואת Javadocs של ה-SDK. כדי להוסיף את הפונקציה צריך לבצע את השלבים הבאים ב-SDK של הצרכן לאפליקציה שלכם:

מגדירים את הסביבה כדי לגשת למאגר Maven המארח, כפי שמתואר ב שלב 2 במדריך הזה.
הוספת יחסי תלות של Consumer SDK ו-Maps SDK ל-Gradle או ל-Maven הגדרה אישית.

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

בדוגמאות הבאות, מחליפים את 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>
```

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

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

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

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

כדי להתקין את הפלאגין ולאחסן את מפתח ה-API:

פותחים את קובץ build.gradle ברמה הבסיסית (root) ומוסיפים את הקוד הבא אל רכיב 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 Studio, צריך לסנכרן את הפרויקט עם Gradle. פרטים נוספים זמינים במאמר מסנכרנים את הפרויקט עם Gradle במסמכי התיעוד של Android.
פותחים את 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.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 לצרכנים באפליקציה שלכם, עליכם לכלול את טקסט השיוך (Attribution) ו רישיונות קוד פתוח כחלק מקטע ההודעות המשפטיות של האפליקציה. מומלץ לכלול את הקרדיטים האלה כאפשרות עצמאית בתפריט או כחלק ממידע כללי. אפשרות בתפריט.

פרטי הרישיון מופיעים בקובץ 'third_party_ שונותs.txt'. קובץ ב- את קובץ ה-AAR שאוחזר מהארכיון.

בכתובת https://developers.google.com/android/guides/opensource מוסבר איך לכלול הודעות על קוד פתוח.

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

קבלת אסימוני אימות