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

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

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

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

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

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

רשימת אפליקציות לדוגמה של SDK של מפות ל-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.
  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.