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