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

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

‫Driver SDK זמין במאגר Maven של Google. המאגר כולל את קובצי ה-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 זמין במאמר של Google Maps Platform בנושא שיטות מומלצות לאבטחת ממשקי API.

כדי לייעל את המשימה הזו, אתם יכולים להשתמש במאמרי העזרה של 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 שחולץ מהארכיון.

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

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

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