הגדרת פרויקט במסוף 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 & (ממשקי API &) שירותים ומחפשים ומפעילים SDK של מפות ל-Android.

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

ה-Driver SDK זמין ממאגר Google Maven. המאגר כולל את קובצי Project Object Model (.pom) ואת Javadocs של ה-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 ברמה הבסיסית (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")
    }
}

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

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

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

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

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