כדי להגדיר פרויקט במסוף Google Cloud ולהשתמש בו ב-Driver SDK ב-Android, פועלים לפי השלבים הבאים.
- מגדירים פרויקט באפליקציה לנייד.
- מוסיפים את Driver SDK לאפליקציה.
- מוסיפים את מפתח ה-API לאפליקציה.
- ציינו את הייחוסים הנדרשים באפליקציה.
בקטעים הבאים יש מידע נוסף על כל שלב.
הגדרת פרויקט באפליקציה לנייד
בקטע הזה מוסבר איך להגדיר את הפרויקט של האפליקציה לנייד בשביל הנהג SDK.
כדי להגדיר את פרויקט האפליקציה לנייד, פועלים לפי השלבים הבאים:
- אם אין לכם פרויקט פיתוח במסוף Google Cloud ומפתח API לפרויקט התחבורה הציבורית שלכם, עליכם להגדיר אותו. מידע נוסף זמין במאמר הבא: יוצרים פרויקט ב-Fleet Engine.
- במסוף Google Cloud, בוחרים את אותו פרויקט במסוף Google Cloud ואז מפתח ה-API שמשמש אותך ל-Fleet Engine.
- בוחרים באפשרות 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, פועלים לפי השלבים הבאים:
פותחים את קובץ
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") } }
עליך לפתוח את הקובץ
build.gradle
ברמת האפליקציה ולהוסיף את הקוד הבא אל רכיבplugins
.מגניב
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
אם אתם משתמשים ב-Android Studio, צריך לסנכרן את הפרויקט עם Gradle. פרטים נוספים זמינים במאמר מסנכרנים את הפרויקט עם Gradle.
פותחים את
local.properties
בספרייה ברמת הפרויקט ומוסיפים את הקוד הבא. מחליפים אתYOUR_API_KEY
במפתח ה-API שלכם.MAPS_API_KEY=YOUR_API_KEY
בקובץ
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 שאוחזר מהארכיון.
עיינו בהכללת הודעות בקוד פתוח כדי להבין איך לכלול הודעות על קוד פתוח.