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

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

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

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

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

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

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

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

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

ערכת Driver SDK זמינה ממאגר Google Maven. המאגר כולל את קובצי מודל האובייקט של הפרויקט (‎.pom) של ה-SDK ואת מסמכי ה-Javadoc.

כדי להוסיף את 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 זמין במאמר בנושא שיטות מומלצות לאבטחת API בפלטפורמה של מפות Google.

כדי לייעל את המשימה הזו, אפשר להשתמש במסמכי התיעוד של GitHub בנושא Secrets Gradle Plugin for 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 באפליקציה, אתם צריכים לכלול טקסט שיוך ורישיונות קוד פתוח כחלק מהסעיף של ההודעות המשפטיות באפליקציה. מומלץ להוסיף את הקרדיטים כפריט עצמאי בתפריט או כחלק מהפריט מידע בתפריט.

אפשר למצוא את פרטי הרישיון בקובץ third_party_licenses.txt בתוך קובץ ה-AAR שלא נפרס.

במאמר הוספת הודעות לגבי קוד פתוח מוסבר איך להוסיף הודעות לגבי קוד פתוח.

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

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