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