קוד לדוגמה של מפות Google ל-Android

בחירת פלטפורמה: Android iOS JavaScript

המאגר של ה-SDK של מפות ל-Android ב-GitHub כולל דוגמאות שממחישות איך להשתמש ב-SDK של מפות ל-Android באפליקציה ל-Android.

המאגר מכיל את האפליקציה ApiDemos, אפליקציה לדוגמה שמאפשרת לכם ליצור ולהריץ את הדוגמאות מאפליקציית Android אחת. אתם יכולים לייבא וליצור את האפליקציה, להוסיף את מפתח ה-API, לצפות בהדגמה ולהשתמש בקוד לדוגמה שסופק כנקודת התחלה לאפליקציה שלכם.

כשמפעילים את האפליקציה לדוגמה, מוצגת רשימה של דוגמאות זמינות שאפשר להפעיל במכשיר. בוחרים אחת מהאפשרויות. לדוגמה, לוחצים על Basic Map.

פתרון בעיות: אם האפליקציה לדוגמה פועלת אבל לא מוצגת מפה, צריך לוודא שהוספתם את מפתח ה-API לקובץ המניפסט של האפליקציה, כמו שמתואר במאמר שימוש במפתחות API.

רשימת האפליקציות לדוגמה של Maps SDK ל-Android

בהמשך מפורטות פעילויות לדוגמה שכלולות באפליקציה ApiDemos של Maps SDK ל-Android, והן משוכפלות בדפים המקושרים לעיון מהיר. רשימה מלאה של הדוגמאות הזמינות מופיעה בתיקייה Kotlin או Java.

שכפול והרצה של הדוגמאות

כדי להריץ את הדוגמה הזו באופן מקומי, צריך להתקין את Git. הפקודה הבאה משכפלת את מאגר האפליקציות לדוגמה.

git clone git@github.com:googlemaps-samples/android-samples.git

מייבאים את הפרויקט לדוגמה ל-Android Studio:

  1. ב-Android Studio, לוחצים על File > ‏New > ‏Import Project (קובץ > חדש > ייבוא פרויקט).

  2. עוברים למיקום שבו שמרתם את המאגר ובוחרים את ספריית הפרויקט של Kotlin או Java:

    • Kotlin:‏ PATH-REPO/android-samples/ApiDemos/kotlin
    • Java: PATH-REPO/android-samples/ApiDemos/java
  3. לוחצים על פתיחה. ‫Android Studio יוצר את הפרויקט באמצעות כלי ה-build של Gradle.
  4. יוצרים קובץ secrets.properties ריק באותה ספרייה שבה נמצא קובץ local.properties של הפרויקט. מידע נוסף על הקובץ הזה זמין במאמר הוספת מפתח ה-API לפרויקט.
  5. מקבלים מפתח API מהפרויקט שבו מופעל SDK של מפות ל-Android.

  6. מוסיפים את המחרוזת הבאה ל-secrets.properties, ומחליפים את YOUR_API_KEY בערך של מפתח ה-API:

    MAPS_API_KEY=YOUR_API_KEY
  7. מפעילים את האפליקציה.

אפליקציה לדוגמה למפות ב-Wear OS

ב-GitHub יש אפליקציה לדוגמה של ה-SDK של מפות ל-Android ב-Wear OS, שבה אתם יכולים להשתמש כנקודת התחלה כשאתם יוצרים אפליקציה לבישה. בדוגמה מוסבר איך להגדיר מפת Google בסיסית ב-Wear OS.