כדי להגדיר ולהגדיר את Google Cloud Console לשימוש ב-SDK לצרכנים ב-Android, פועלים לפי השלבים הבאים.
- מגדירים פרויקט פיתוח.
- מוסיפים את ה-SDK לצרכנים לאפליקציה.
- מוסיפים את מפתח ה-API לאפליקציה.
- ציינו את הייחוסים הנדרשים באפליקציה.
בקטעים הבאים יש מידע נוסף על כל שלב.
הגדרת פרויקט פיתוח
אם אין לכם פרויקט פיתוח במסוף Google Cloud ומפתח API עבור את פרויקט התנועה שלכם, עליכם להגדיר אותו. פרטים נוספים זמינים במאמר יוצרים את הפרויקט במדריך של Fleet Engine.
כשבוחרים את פרויקט הפיתוח עבור ה-SDK לצרכן, צריך לבחור הפרויקט במסוף Google Cloud ומפתח ה-API שמשמשים אתכם ל-Fleet Engine.
הוספת ה-SDK לצרכנים לאפליקציה
ה-SDK לצרכנים זמין ממאגר פרטי של Maven. המאגר כולל את קובצי Project Object Model (.pom) ואת Javadocs של ה-SDK. כדי להוסיף את הפונקציה צריך לבצע את השלבים הבאים ב-SDK של הצרכן לאפליקציה שלכם:
מגדירים את הסביבה כדי לגשת למאגר Maven המארח, כפי שמתואר ב שלב 2 במדריך הזה.
הוספת יחסי תלות של Consumer SDK ו-Maps SDK ל-Gradle או ל-Maven הגדרה אישית.
בדוגמאות הבאות, מחליפים את
VERSION_NUMBER
בערך הנדרש הגרסה של ה-SDK לצרכן:Gradle
צריך להוסיף את הפרטים הבאים ל
build.gradle
:dependencies { ... implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER' implementation "com.google.android.gms:play-services-maps:VERSION_NUMBER" }
Maven
צריך להוסיף את הפרטים הבאים ל
pom.xml
:<dependencies> ... <dependency> <groupId>com.google.android.libraries.mapsplatform.transportation</groupId> <artifactId>transportation-consumer</artifactId> <version>VERSION_NUMBER</version> </dependency> <dependency> <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> <version>18.1.0</version> </dependency> </dependencies>
הוספה של מפתח ה-API לאפליקציה
אחרי שמוסיפים לאפליקציה את ה-SDK לצרכנים, מוסיפים את מפתח ה-API. חובה להשתמש מפתח ה-API של הפרויקט שקיבלתם כשהגדרתם את פרויקט הפיתוח. עבור תוכלו לקרוא פרטים נוספים בקטע הגדרת פרויקט הפיתוח בשלב 3 במדריך הזה.
בקטע הזה מוסבר איך לאחסן את מפתח ה-API כדי שיהיה מאובטח יותר שהאפליקציה שלך מפנה אליו. למידע נוסף על שיטות מומלצות לשמירה על מפתחות API, קראו את המאמר בפלטפורמה של מפות Google בנושא שיטות מומלצות לאבטחת API.
כדי לייעל את המשימה הזו, אפשר להיעזר במאמרי העזרה Secrets Gradle של GitHub פלאגין ל-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 במסמכי התיעוד של Android.
פותחים את
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.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_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>
לכלול את הייחוסים הנדרשים באפליקציה
אם אתם משתמשים ב-SDK לצרכנים באפליקציה שלכם, עליכם לכלול את טקסט השיוך (Attribution) ו רישיונות קוד פתוח כחלק מקטע ההודעות המשפטיות של האפליקציה. מומלץ לכלול את הקרדיטים האלה כאפשרות עצמאית בתפריט או כחלק ממידע כללי. אפשרות בתפריט.
פרטי הרישיון מופיעים בקובץ 'third_party_ שונותs.txt'. קובץ ב- את קובץ ה-AAR שאוחזר מהארכיון.
בכתובת https://developers.google.com/android/guides/opensource מוסבר איך לכלול הודעות על קוד פתוח.