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

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

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

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

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

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

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

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

יצירת עותקים מקודמים והרצה של הדוגמאות

נדרש Git כדי להריץ את הדוגמה הזו באופן מקומי. הפקודה הבאה יוצרת עותק (clone) של מאגר האפליקציה לדוגמה.

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 של Google.
  4. יוצרים קובץ secrets.properties ריק באותה ספרייה שבה נמצא קובץ local.properties של הפרויקט. מידע נוסף זמין במאמר הוספת מפתח ה-API לפרויקט.

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

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

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

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