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

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

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

כדי להוסיף את 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 ל-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 שלא עבר ארכיון.

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

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

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