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

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

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

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

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

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

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

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

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

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

כדי להוסיף את Driver SDK לאפליקציה, צריך להוסיף את ה-SDK של Drive ואת ה-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, פועלים לפי השלבים הבאים:

  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 Studio, צריך לסנכרן את הפרויקט עם Gradle. פרטים נוספים זמינים במאמר מסנכרנים את הפרויקט עם Gradle.

  4. פותחים את local.properties בספרייה ברמת הפרויקט ומוסיפים את הקוד הבא. מחליפים את הערך YOUR_API_KEY במפתח ה-API שלכם.

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

אפשר למצוא את פרטי הרישיון בקובץ 'third_party_Licenses.txt' קובץ ב- את קובץ ה-AAR שאוחזר מהארכיון.

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

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

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