המאגר של Maps SDK ל-Android ב-GitHub כולל דוגמאות שממחישות את השימוש ב-SDK של מפות Google ל-Android באפליקציה ל-Android.
המאגר מכיל את האפליקציה ApiDemos – אפליקציה לדוגמה שמאפשרת ליצור ולהפעיל את הדוגמאות מאפליקציה אחת ל-Android. תוכלו לייבא ולבנות את האפליקציה, להוסיף את מפתח ה-API, להציג את ההדגמה ולהשתמש בקוד לדוגמה שמופיע כנקודת התחלה לאפליקציה.
כשמריצים את האפליקציה לדוגמה, מוצגת רשימה של דוגמאות זמינות שתוכלו להריץ במכשיר שלכם. בוחרים אחת מהאפשרויות. לדוגמה, לוחצים על Basic Map.
פתרון בעיות: אם האפליקציה לדוגמה פועלת בהצלחה אבל המפה לא מוצגת, עליכם לבדוק שהוספתם את מפתח ה-API לקובץ המניפסט של האפליקציה, כפי שמתואר במאמר שימוש במפתחות API.
רשימת אפליקציות לדוגמה של מפות Google ל-Android
הפעילויות העיקריות לדוגמה שנכללות ב-SDK של מפות Google לאפליקציה ApiDemos ל-Android מפורטות למטה ומוצגות שוב בדפים המקושרים, כדי לעיין בהן במהירות. בתיקייה Kotlin או Java תוכלו לראות את הרשימה המלאה של הדוגמאות הזמינות.
שכפול והרצת הדוגמאות
יש צורך ב-Git כדי להריץ את הדוגמה הזו באופן מקומי. הפקודה הבאה משכפלת את מאגר האפליקציות לדוגמה.
git clone git@github.com:googlemaps-samples/android-samples.git
ייבוא של הפרויקט לדוגמה אל Android Studio:
- ב-Android Studio, בוחרים באפשרות קובץ > חדש > ייבוא פרויקט.
נכנסים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט עבור Kotlin או Java:
- Kotlin:
PATH-REPO/android-samples/ApiDemos/kotlin
- Java:
PATH-REPO/android-samples/ApiDemos/java
- Kotlin:
- לוחצים על פתיחה. המערכת של Android Studio יוצרת את הפרויקט שלך באמצעות הכלי לבניית אתרים של Gradle.
- יוצרים קובץ
secrets.properties
ריק באותה ספרייה שבה נמצא קובץlocal.properties
של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח ה-API לפרויקט. מוסיפים את המחרוזת הבאה אל
secrets.properties
ומחליפים את YOUR_API_KEY בערך של מפתח ה-API:MAPS_API_KEY=YOUR_API_KEY
- מפעילים את האפליקציה.
אפליקציה לדוגמה למפות ב-Wear OS
דוגמה לאפליקציה של מפות Google ל-Android ב-Wear OS זמינה ב-GitHub, שבה אפשר להשתמש כנקודת התחלה כשמפתחים אפליקציה לבישה. הדוגמה מראה איך מגדירים מפה בסיסית של Google ב-Wear OS.