הגדרת פרויקט במסוף 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, בוחרים את אותו פרויקט ואת אותו מפתח API שבהם אתם משתמשים ב-Fleet Engine.
  3. בוחרים באפשרות APIs & Services, מחפשים את Maps SDK for Android ומפעילים אותו.

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

ערכת Driver SDK זמינה במאגר Google Maven. המאגר כולל את קובצי Project Object Model ‏ (.pom) של ה-SDK ואת Javadocs.

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

    גרוב

    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.

    גרוב

    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 שלא נפרס.

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

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

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